Ir para o conteúdo principal

Metadados

Metadados é um serviço oferecido em cada instância do servidor Equinix Metal™ que permite acesso e compartilhar vários dados sobre si mesmo.

Os metadados só podem ser acessados ​​após o servidor atingir o estado "Ativo" no processo de provisionamento . Se você estiver usando uma imagem do Equinix Metal OS, isso normalmente ocorre após a instalação completa do sistema operacional e o servidor estar pronto para uso. Se você estiver usando o iPXE personalizado, o servidor estará "Ativo" após a conclusão do processo de inicialização do Equinix Metal e antes da gravação do sistema operacional no disco. Isso permite que você acesso o endpoint de metadados durante o provisionamento do iPXE personalizado.

Limitações:

  • O ponto de extremidade de metadados só está disponível quando um servidor está nos modos de rede Camada 3 ou Híbrido Vinculado. Os modos de rede Camada 2 pura não suporte ao ponto de extremidade de metadados.
  • Os metadados só são acessíveis a partir do próprio servidor. Scripts ou utilitários em execução no servidor podem acesso o endpoint de metadados, e o acesso do usuário ao endpoint está disponível se você estiver conectado ao servidor via SSH.

Recuperando Metadados​

Você pode visualizar os metadados de uma instância de servidor consultando o seguinte endpoint com uma ferramenta como cURL. você quiser obter informações específicas dos metadados, você pode usar jq para filtrar por campos específicos.

curl https://metadata.platformequinix.com/metadata | jq

Existem recursos específicos fornecidos pelo serviço de metadados em seus próprios endpoints, que são abordados na seção Recursos de Metadados.

Conteúdo completo de metadados​

Sobre​

Os metadados incluem algumas informações de nível superior, como nome do host, plano e o UUID do seu servidor. Eles também contêm alguns campos úteis para configurar a automação ou outros características, como a área metropolitana e a instalação do seu servidor. Se você estiver configurando volumes iSCSI, o IQN do servidor também estará incluído.

"id": "d4b783e9-89f3-4d35-bdcd-ff6753b11911",
"hostname": "bgp-testing-3",
"iqn": "iqn.2021-09.net.packet:device.d4b783e9",
"plan": "c3.small.x86",
"reserved": false,
"class": "c3.small.x86",
"facility": "sv15",
"metro": "sv",
"private_subnets": [
  "10.0.0.0/8"
],
"switch_short_id": "3bbc11a0",

Sistema operacional​

O operating_system você qual sistema operacional e versão estão instalados. Se você provisionou com uma das imagens de SO do Equinix Metal, ele também conterá a tag da imagem.

"operating_system": {
    "slug": "ubuntu_20_10",
    "distro": "ubuntu",
    "version": "20.10",
    "license_activation": {
      "state": "unlicensed"
    },
    "image_tag": "151bba731256fdfefb25bccbcf16575b999c1e6c"
},

Chaves SSH​

ssh_keys é uma matriz de todas as chaves SSH que foram adicionadas ao servidor no momento do provisionamento.

"ssh_keys": [
    "ssh-rsa AAAAB3..."
],

Estado​

state você o estado atual de um dispositivo.

"state": "active",

Armazenamento​

As informações de armazenamento contêm informações sobre disco, partição e sistema de arquivos.

"storage": {
    "disks": [
      {
        "device": "/dev/sda",
        "wipeTable": true,
        "partitions": [
          {
            "label": "BIOS",
            "number": 1,
            "size": 4096
          },
          {
            "label": "SWAP",
            "number": 2,
            "size": "3993600"
          },
          {
            "label": "ROOT",
            "number": 3,
            "size": 0
          }
        ]
      }
    ],
    "filesystems": [
      {
        "mount": {
          "device": "/dev/sda3",
          "format": "ext4",
          "point": "/",
          "create": {
            "options": [
              "-L",
              "ROOT"
            ]
          }
        }
      },
      {
        "mount": {
          "device": "/dev/sda2",
          "format": "swap",
          "point": "none",
          "create": {
            "options": [
              "-L",
              "SWAP"
            ]
          }
        }
      }
    ]
},

Especificações​

O objeto specs contém os componentes de hardware específicos do seu servidor.

"specs": {
    "cpus": [
      {
        "count": 1,
        "type": "Intel(R) Xeon(R) E-2278G CPU @ 3.40GHz"
      }
    ],
    "memory": {
      "total": "32GB"
    },
    "drives": [
      {
        "count": 2,
        "size": "480GB",
        "type": "SSD",
        "category": "boot"
      }
    ],
    "nics": [
      {
        "count": 2,
        "type": "10Gbps"
      }
    ],
    "gpu": [
      {
        "count": 1,
        "type": "Intel HD Graphics P630"
      }
    ],
    "features": {
      "raid": false,
      "txt": true,
      "uefi": false
    }
},

Rede​

O objeto network contém informações sobre o(s) vínculo(s), as interfaces de rede separadas nos vínculos e todos os detalhes sobre os endereços IP de gerenciamento do seu servidor. Se o servidor estiver conectado a um Metal Gateway, metal_gateways será preenchido com as informações dele.

"network": {
  "bonding": {
    "mode": 4,
    "link_aggregation": "mlag_ha",
    "mac": "0c:42:a1:65:fd:ce"
  },
  "interfaces": [
    {
      "name": "eth0",
      "mac": "0c:42:a1:65:fd:ce",
      "bond": "bond0"
    },
    {
      "name": "eth1",
      "mac": "0c:42:a1:65:fd:cf",
      "bond": "bond0"
    }
  ],
  "addresses": [
    {
      "id": "aee6e0ca-70d1-4af2-b9b6-744e115ca1c4",
      "address_family": 4,
      "netmask": "255.255.255.254",
      "created_at": "2021-09-15T15:25:08Z",
      "public": true,
      "cidr": 31,
      "management": true,
      "enabled": true,
      "network": "203.0.113.0",
      "address": "203.0.113.1",
      "gateway": "203.0.113.0",
      "parent_block": {
        "network": "203.0.113.0",
        "netmask": "255.255.255.254",
        "cidr": 31,
        "href": "/ips/afc6f4cc-04f7-4c63-ac4d-a8e0aea541db"
      }
    },
    {
      "id": "97411ab0-922f-43b6-9b4f-e22b2b9a6c11",
      "address_family": 6,
      "netmask": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:fffe",
      "created_at": "2021-09-15T15:25:08Z",
      "public": true,
      "cidr": 127,
      "management": true,
      "enabled": true,
      "network": "2001:DB8:45e1:5000::",
      "address": "2001:DB8:45e1:5000::1",
      "gateway": "2001:DB8:45e1:5000::",
      "parent_block": {
        "network": "2001:DB8:45e1:5000:0000:0000:0000:0000",
        "netmask": "ffff:ffff:ffff:ff00:0000:0000:0000:0000",
        "cidr": 56,
        "href": "/ips/7281c066-f4c2-4700-88da-b90dc3b5da32"
      }
    },
    {
      "id": "b04b5c36-82aa-4f5e-a026-8bddee388134",
      "address_family": 4,
      "netmask": "255.255.255.254",
      "created_at": "2021-09-15T15:25:08Z",
      "public": false,
      "cidr": 31,
      "management": true,
      "enabled": true,
      "network": "10.67.50.0",
      "address": "10.67.50.1",
      "gateway": "10.67.50.0",
      "parent_block": {
        "network": "10.67.50.0",
        "netmask": "255.255.255.128",
        "cidr": 25,
        "href": "/ips/b4b06d38-8730-47e3-8bbe-415b86aafea4"
      }
    }
  ],
  "metal_gateways": []
},

Etiquetas​

  "tags": [
    "test",
    "SV_01",
    "Dev"
  ],

URLs​

"api_url": "https://metadata.packet.net",
"phone_home_url": "http://tinkerbell.sv15.packet.net/phone-home",
"user_state_url": "http://tinkerbell.sv15.packet.net/events"

Os valores phone_home_url e user_state_url são úteis se você estiver usando iPXE personalizado ou dados de usuário personalizados para provisionar e configurar seus servidores.

Vizinhos BGP​

Se você tiver o BGP habilitado em seu projeto e servidor, os metadados conterão o objeto bgp_neighbors. Ele não estará presente se o BGP não estiver habilitado.

"bgp_neighbors": [
  {
    "address_family": 4,
    "customer_as": 65000,
    "customer_ip": "10.67.50.1",
    "md5_enabled": false,
    "md5_password": null,
    "multihop": true,
    "peer_as": 65530,
    "peer_ips": [
      "169.254.255.1",
      "169.254.255.2"
    ],
    "routes_in": [
      ...
    ],
    "routes_out": []
  },
  {
    "address_family": 6,
    "customer_as": 65000,
    "customer_ip": "2604:1380:45e1:5000::1",
    "md5_enabled": false,
    "md5_password": null,
    "multihop": true,
    "peer_as": 65530,
    "peer_ips": [
      "fc00:0000:0000:0000:0000:0000:0000:000e",
      "fc00:0000:0000:0000:0000:0000:0000:000f"
    ],
    "routes_in": [
      ...
    ],
    "routes_out": []
  }
],

Dados do usuário​

Se você estiver usando Userdata ao provisionamento seu servidor, ele será armazenado em disco e estará disponível no endpoint de metadados após o provisionamento. Você pode acessá-lo via cURL a partir do endpoint de metadados.

curl https://metadata.platformequinix.com/userdata

Recursos de metadados​

Para obter uma lista de todos os recursos de metadados disponíveis, você pode consultar https://metadata.platformequinix.com/2009-04-04/meta-data. Observação: o caminho contém uma versão específica de metadados. 2009-04-04 é a versão atual.

curl https://metadata.platformequinix.com/2009-04-04/meta-data
instance-id
hostname
iqn
plan
facility
tags
operating-system
public-keys
public-ipv4
public-ipv6
local-ipv4

Para obter os recursos de metadados específicos, você também pode consultar cada uma das opções. Por exemplo, para recuperar o ID da instância:

curl https://metadata.platformequinix.com/2009-04-04/meta-data/instance-id
Esta página foi útil?