9.1. Verificar o recebimento do arquivo devices.csv

Tempo estimado para a conclusão: 1 dia

Proprietário do componente operacional: OELCM/HWaaS

Perfil de habilidade: engenheiro de implantação

O arquivo devices.csv descreve todos os dispositivos de hardware em uma instância isolada do Google Distributed Cloud (GDC). Confirme o recebimento do arquivo e verifique se ele segue o formato esperado. Antes, esse arquivo era chamado de "Identificação do dispositivo" (DEID). Além disso, verifique se o hardware e as conexões de rede correspondem aos arquivos.

Observação: o arquivo de texto devices.csv é um arquivo de valores separados por vírgula (CSV) que usa vírgulas para separar os valores. Ele não aceita nenhum outro caractere como separador, exceto vírgula.

Geração

1. Confirme o recebimento das planilhas de identificação do dispositivo ("DEID") do fornecedor de hardware:
   1. Uma planilha para cada rack na instância do Distributed Cloud.
   2. Cada planilha tem uma guia com informações do dispositivo.
2. Colete os registros de dispositivo de todas as planilhas de DEID:
   1. Agregue manualmente os registros de dispositivos de cada planilha em uma planilha combinada.
   2. Remova as linhas vazias.
   3. Verifique se há apenas uma linha de cabeçalho como a primeira linha.
   4. Cada linha subsequente contém a lista agregada de registros de dispositivos das planilhas de DEID.
3. Converta ou exporte a planilha agregada de DEID para o formato CSV (valores separados por vírgula).

4. Faça uma conversão do melhor esforço da lista de cabos DEID para o formato devices.csv do Distributed Cloud descrito na especificação de formato:

   gdcloud system assets format-deid --input-deid PATH_TO_AGGREGATED_DEID_FILE --output-devices OUTPUT_PATH
   

Observação: o comando format-deid faz uma conversão da melhor forma possível dos dados do DEID do fornecedor de hardware para o formato devices.csv do Distributed Cloud. O comando modifica os nomes dos cabeçalhos para corresponder ao formato esperado. No entanto, os dados em cada um dos registros não são modificados, e talvez seja necessário fazer isso manualmente para atender ao formato esperado.

Especificação de formato

Nome da coluna	Descrição	Formato
serial_number	Os números de série atribuídos ao dispositivo de hardware e aos subdispositivos no mesmo chassi (se aplicável).	Obrigatório para todos os dispositivos. Para dispositivos NetApp que contêm vários controladores no mesmo chassi, especifique primeiro o número de série do chassi, depois o número de série do primeiro controlador e, por fim, o número de série do segundo controlador (todos separados por vírgulas). Alfanumérico. Expressão regular: objsshelf stge stgeshelf ^[a-zA-Z0-9]+,[a-zA-Z0-9]+,[a-zA-Z0-9]+$ outro ^U[0-9]{1,2}$ Exemplo: objsshelf stge stgeshelf 2M221301D9,2M221301DA,2M221301DB outro 2M221301D9
instance_id	O ID da instância do Distributed Cloud associada ao dispositivo de hardware.	Obrigatório para todos os dispositivos. Precisa ser o mesmo para todos os dispositivos na mesma instância. Expressão regular: ^([a-z0-9]{2,})$ Exemplo: aa
rack_id	O ID do rack associado ao dispositivo de hardware.	Obrigatório para todos os dispositivos. Precisa ser o mesmo para todos os dispositivos no mesmo rack. Expressão regular: ^([a-z0-9]{2,})$ Exemplo: aa
rack_location^1	A localização do dispositivo de hardware no rack.	Obrigatório para todos os dispositivos, exceto racks. Para dispositivos PDU, especifique o local da PDU. Para outros dispositivos, especifique a localização da unidade de rack da parte de cima do dispositivo. Expressão regular: pdu ^PDU-[LR]$ rack ^n\/a$ outro ^U[0-9]{1,2}$ Exemplo: pdu PDU-L indica um cabo que se conecta a um dispositivo PDU no lado esquerdo do rack, visto de trás. rack n/a outro U42
rack_units	A altura (em unidades de rack) do dispositivo de hardware.	Obrigatório para todos os dispositivos, exceto racks e PDUs. Especifique a altura do dispositivo em unidades de rack. Expressão regular: pdu rack ^n\/a$ outro ^[0-9]+$ Exemplo: pdu rack n/a outro 1
tipo	O tipo de dispositivo de hardware.	Obrigatório para todos os dispositivos. Expressão regular: ^(rack)|(pdu)|(server)|(mgmtsw)|(mgmtaggsw)|(torsw)|(aggsw)|(stgesw)|(fw)|(hsm)|(objsadm)|(objs)|(objsshelf)|(stge)|( stgeshelf)$ Exemplo: servidor
nome	O nome físico do dispositivo de hardware.	Obrigatório para todos os dispositivos. O formato necessário depende do tipo de dispositivo de hardware. Em geral, todos os tipos de dispositivos exigem o mesmo formato de "-<rack_id>-<device_type>", exceto alguns tipos de dispositivos de armazenamento, que exigem um sufixo adicional. Esse campo precisa corresponder à especificação de nomenclatura do dispositivo.
modelo	O nome do produto legível do dispositivo de hardware.	Obrigatório para todos os dispositivos. Esse campo precisa corresponder à especificação do modelo para o dispositivo.
fornecedor	O fabricante do dispositivo de hardware.	Esse campo é preenchido automaticamente com base no modelo.
asset_tag^1	O rótulo impresso do dispositivo de hardware.	Obrigatório para todos os dispositivos. Expressão regular: pdu ^n\/a$ outro ^[A-Z]{2}-(RCK|SVR|SWT|STG|PPL|HSM|FWL|OBJ|NTP|CON|CHS|PDU)-[0-9]{6}$ Exemplo: pdu n/a outro US-SRV-123456
server_cpu_model	O modelo das CPUs no dispositivo do servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Modelos de CPU de servidor aceitos: Intel Xeon Silver 4210R Intel Xeon Silver 4216 Intel Xeon Gold 5220R Intel Xeon Gold 6230R Intel Xeon Silver 4214R Intel Xeon Gold 6226R Intel Xeon Gold 5317 Intel Xeon Platinum 8280 Intel Xeon Gold 6212U Intel Xeon Gold 6312U Intel Xeon Gold 5418Y Intel Xeon Silver 4410Y Intel Xeon Gold 6538Y+ Intel Xeon Platinum 8558
server_num_cpus	O número de CPUs presentes no dispositivo do servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Numérico. Expressão regular: servidor ^[0-9]+$ outro ^n\/a$ Exemplo: servidor 2 outro n/a
server_memory_gb	A quantidade de memória (em GB) no dispositivo do servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^[0-9]+$ outro ^n\/a$ Exemplo: servidor 288 outro n/a
server_gpu_model^1	O modelo das GPUs no dispositivo do servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Modelos de GPU de servidor aceitos: nVidia T4 16GB nVidia A100 40GB nVidia A100 80GB nVidia H100 NVL PCIe 94GB nVidia H100 PCIe 80GB nVidia H100 XSM 80GB
server_num_gpus	O número de GPUs no dispositivo do servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^[0-9]+$ outro ^n\/a$ Exemplo: servidor 1 outro n/a
server_bios_version^1	A versão da BIOS no dispositivo servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^U[0-9]+$ outro ^n\/a$ Exemplo: servidor U32 outro n/a
server_bmc_version^1	A versão do firmware do controlador bare metal no dispositivo servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^[0-9]+\.[0-9]+$ outro ^n\/a$ Exemplo: servidor 2,55 outro n/a
server_bmc_username^2	O nome de usuário do administrador do BMC para dispositivos de servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^[a-zA-Z0-9]+$ outro ^n\/a$ Exemplo: servidor Administrador outro n/a
server_bmc_password^2	A senha do administrador do BMC para dispositivos de servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$ outro ^n\/a$ Exemplo: servidor ASDF1234 outro n/a
server_bmc_port_mac	O endereço MAC da porta BMC para dispositivos de servidor.	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: servidor ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: servidor f0:0d:ca:fe:00:01 outro n/a
server_bmc_port_name	O nome da porta BMC para dispositivos de servidor.	Esse campo será definido automaticamente como ilo para dispositivos de servidor.
server_mgmt_port_mac	O endereço MAC da interface de gerenciamento para dispositivos de servidor.	Igual a "server_bmc_mac".
server_mgmt_port_name	O nome da interface de gerenciamento para dispositivos de servidor.	Esse campo será definido automaticamente como LOM1 para dispositivos de servidor.
server_data1_port_mac	O endereço MAC da primeira interface de dados para dispositivos de servidor.	Igual a "server_bmc_mac".
server_data1_port_name	O nome da primeira interface de dados para dispositivos de servidor	Obrigatório para servidores. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^s[1-9]p[1-9]$ outro ^n\/a$ Exemplo: servidor s1p1 outro n/a
server_data2_port_mac	O endereço MAC da segunda interface de dados para dispositivos de servidor.	Igual a "server_bmc_mac".
server_data2_port_name	O nome da segunda interface de dados para dispositivos de servidor.	Igual a server_data1_port_name.
switch_username^2	O nome de usuário do administrador para alternar dispositivos.	Obrigatório para chaves. Não especificado para todos os outros dispositivos. Expressão regular: mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9]+$ outro ^n\/a$ Exemplo: mgmtsw mgmtaggsw torsw aggsw stgesw Administrador Outro n/a
switch_password^2	A senha de administrador para dispositivos de switch.	Obrigatório para chaves. Não especificado para todos os outros dispositivos. Expressão regular: mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$ outro ^n\/a$ Exemplo: mgmtsw mgmtaggsw torsw aggsw stgesw ASDF1234 outro n/a
switch_mgmt_port_mac	O endereço MAC da porta supeth1 para dispositivos de switch. Para isso, pule o PoAP, carregue a configuração padrão do switch e execute "show mac address-table | include sup-eth1".	Obrigatório para chaves. Não especificado para todos os outros dispositivos. Expressão regular: mgmtsw mgmtaggsw torsw aggsw stgesw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: mgmtsw mgmtaggsw torsw aggsw stgesw f0:0d:ca:fe:00:01 outro n/a
fw_mgmt_port_mac	O endereço MAC da interface de gerenciamento para dispositivos de firewall.	Obrigatório para firewalls. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: fw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: fw f0:0d:ca:fe:00:01 outro n/a
fw_mgmt_port_name	O nome da interface de gerenciamento para dispositivos de firewall.	Esse campo será definido automaticamente como mgt para dispositivos de firewall.
hsm_mgmt_port_mac	O endereço MAC da interface de gerenciamento para dispositivos HSM.	Obrigatório para HSMs. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: hsm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: hsm f0:0d:ca:fe:00:01 outro n/a
hsm_mgmt_port_name	O nome da interface de gerenciamento para dispositivos HSM.	Esse campo será definido automaticamente como mgmt0 para dispositivos HSM.
hsm_data1_port_mac	O endereço MAC da primeira interface de dados para dispositivos HSM.	Igual a hsm_mgmt_port_mac.
hsm_data1_port_name	O nome da primeira interface de dados para dispositivos HSM.	Esse campo será definido automaticamente como data0 para dispositivos HSM.
hsm_data2_port_mac	O endereço MAC da segunda interface de dados para dispositivos HSM.	Igual a hsm_mgmt_port_mac.
hsm_data2_port_name	O nome da segunda interface de dados para dispositivos HSM.	Esse campo será definido automaticamente como data0 para dispositivos HSM.
objsadm_bmc_port_mac	O endereço MAC da porta BMC para dispositivos de administrador do Object Storage.	Obrigatório para dispositivos de administrador do Object Storage. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: objsadm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: objsadm f0:0d:ca:fe:00:01 outro n/a
objsadm_bmc_port_name	O nome da porta BMC para dispositivos administradores do Object Storage.	Esse campo será definido automaticamente como OOBM para dispositivos de administrador de armazenamento de objetos.
objsadm_mgmt1_port_mac	O endereço MAC da primeira interface de gerenciamento para dispositivos administradores do Object Storage.	Igual a objsadm_bmc_port_mac.
objsadm_mgmt1_port_name	O nome da primeira interface de gerenciamento para dispositivos de administrador do Object Storage.	Esse campo será definido automaticamente como e01 para dispositivos de administrador de armazenamento de objetos.
objs_bmc_port_mac	O endereço MAC da porta BMC para dispositivos do controlador de computação do Object Storage.	Obrigatório para controladores de computação de armazenamento de objetos. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: objs ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: objs f0:0d:ca:fe:00:01 outro n/a
objs_bmc_port_name	O nome da porta BMC para dispositivos do controlador de computação de armazenamento de objetos.	Esse campo será definido automaticamente como OOBM para dispositivos de computação de armazenamento de objetos.
objs_mgmt1_port_mac	O endereço MAC da primeira interface de gerenciamento para dispositivos do controlador de computação do Object Storage.	Igual a objs_bmc_port_mac.
objs_mgmt1_port_name	O nome da primeira interface de gerenciamento para dispositivos controladores de computação de armazenamento de objetos.	Esse campo será definido automaticamente como e01 para dispositivos de computação de armazenamento de objetos.
objsshelf_num_data_disks	O número de discos de dados presentes no dispositivo Object Storage Shelf.	Obrigatório para as prateleiras do controlador de armazenamento de objetos. Não especificado para todos os outros dispositivos. Numérico. Expressão regular: objsshelf ^[0-9]+$ outro ^n\/a$ Exemplo: objsshelf 60 outro n/a
objsshelf_controller1_name	O nome físico do primeiro controlador para dispositivos Object Storage Shelf.	Esse campo será definido automaticamente como <device-name>-01 para dispositivos de prateleira de armazenamento de objetos.
objsshelf_controller1_serial_number	O número de série do primeiro controlador para dispositivos Object Storage Shelf.	Alfanumérico.
objsshelf_controller1_mgmt_port_mac	O endereço MAC da interface de gerenciamento do primeiro controlador para dispositivos Object Storage Shelf.	Obrigatório para controladores de prateleira de armazenamento de objetos. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: objsshelf ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: objsshelf f0:0d:ca:fe:00:01 outro n/a
objsshelf_controller1_mgmt_port_name	O nome da interface de gerenciamento do primeiro controlador para dispositivos de Object Storage Shelf.	Esse campo será definido automaticamente como <A-P1 para dispositivos de prateleira de armazenamento de objetos.
objsshelf_controller2_name	O nome físico do segundo controlador para dispositivos Object Storage Shelf.	Esse campo será definido automaticamente como <device-name>-02 para dispositivos de prateleira de armazenamento de objetos.
objsshelf_controller2_serial_number	O número de série do segundo controlador para dispositivos Object Storage Shelf.	Alfanumérico.
objsshelf_controller2_mgmt_port_mac	O endereço MAC da interface de gerenciamento do segundo controlador para dispositivos Object Storage Shelf.	Igual a objsshelf_controller1_mgmt_port_mac.
objsshelf_controller2_mgmt_port_name	O nome da interface de gerenciamento do segundo controlador para dispositivos de Object Storage Shelf.	Esse campo será definido automaticamente como B-P1 para dispositivos de prateleira de armazenamento de objetos.
stge_num_data_disks	O número de discos de dados presentes no dispositivo de armazenamento de arquivos e blocos.	Obrigatório para dispositivos de armazenamento de arquivos e blocos. Não especificado para todos os outros dispositivos. Numérico. Expressão regular: stge ^[0-9]+$ outro ^n\/a$ Exemplo: stge 60 outro n/a
stge_controller1_name	O nome físico do primeiro controlador para dispositivos de armazenamento de arquivos/blocos.	Esse campo será definido automaticamente como <device-name>-01 para dispositivos de armazenamento de blocos de arquivos.
stge_controller1_mgmt_port_mac	O endereço MAC da interface de gerenciamento do primeiro controlador para dispositivos de armazenamento de arquivos e blocos.	Obrigatório para dispositivos de armazenamento de arquivos e blocos. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: stge ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: stge f0:0d:ca:fe:00:01 outro n/a
stge_controller1_mgmt_port_name	O nome da interface de gerenciamento do primeiro controlador para dispositivos de armazenamento de arquivos/blocos.	Esse campo será definido automaticamente como e0M para dispositivos de armazenamento de blocos de arquivos.
stge_controller2_name	O nome físico do segundo controlador para dispositivos de armazenamento de arquivos e blocos.	Esse campo será definido automaticamente como <device-name>-02 para dispositivos de armazenamento de blocos de arquivos.
stge_controller2_mgmt_port_mac	O endereço MAC da interface de gerenciamento do segundo controlador para dispositivos de armazenamento de arquivos/blocos.	Igual a stge_controller1_mgmt_port_mac.
stge_controller2_mgmt_port_name	O nome da interface de gerenciamento do segundo controlador para dispositivos de armazenamento de arquivos e blocos.	Igual a stge_controller1_mgmt_port_name.
stgeshelf_num_data_disks	O número de discos de dados presentes no dispositivo de rack de armazenamento de arquivos/blocos.	Obrigatório para prateleiras de armazenamento de arquivos e blocos. Não especificado para todos os outros dispositivos. Numérico. Expressão regular: stgeshelf ^[0-9]+$ outro ^n\/a$ Exemplo: stgeshelf 60 outro n/a
stgeshelf_controller1_name	O nome físico do primeiro controlador para dispositivos de rack de armazenamento de arquivos e blocos.	Esse campo será definido automaticamente como <device-name>-01 para dispositivos de armazenamento em rack de blocos de arquivos.
stgeshelf_controller2_name	O nome físico do segundo controlador para dispositivos de rack de armazenamento de arquivos/blocos.	Esse campo será definido automaticamente como <device-name>-02 para dispositivos de armazenamento em rack de blocos de arquivos.
chassis_bmc_version	A versão do firmware do dispositivo do chassi.	Opcional para chassi. Não especificado para todos os outros dispositivos. Expressão regular: servidor ^([0-9]+\.)+[0-9]+(-b[0-9]+)?$ outro ^n\/a$ Exemplo: chassis 2.2-b11 outro n/a
chassis_bmc_username^2	O nome de usuário do administrador do BMC para dispositivos de chassi.	Obrigatório para chassi. Não especificado para todos os outros dispositivos. Expressão regular: chassis ^[a-zA-Z0-9]+$ outro ^n\/a$ Exemplo: chassis Administrador outro n/a
chassis_bmc_password^2	A senha de administrador do BMC para dispositivos de chassi.	Obrigatório para chassi. Não especificado para todos os outros dispositivos. Expressão regular: chassis ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$ outro ^n\/a$ Exemplo: chassis ASDF1234 outro n/a
chassis_bmc_port_mac	O endereço MAC da porta BMC para dispositivos de chassi.	Obrigatório para chassi. Não especificado para todos os outros dispositivos. Precisa ser um endereço MAC válido. Expressão regular: servidor ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ outro ^n\/a$ Exemplo: servidor f0:0d:ca:fe:00:01 outro n/a
chassis_bmc_port_name	O nome da porta do BMC para dispositivos de chassi.	Esse campo será definido automaticamente como ilo para dispositivos de chassi.

¹ O campo será verificado quanto ao formato, mas não vai impedir a geração de recursos.

² Os campos de nome de usuário e senha são obrigatórios em secrets.yaml. Todos os nomes de usuário e senhas fornecidos em devices.csv serão usados para gerar secrets.yaml, mas não são obrigatórios em devices.csv.