9.1. Valide a receção do ficheiro devices.csv

Tempo estimado até à conclusão: 1 dia

Proprietário do componente operacional: OELCM/HWaaS

Perfil de competências: engenheiro de implementação

O ficheiro devices.csv descreve todos os dispositivos de hardware numa instância isolada do Google Distributed Cloud (GDC). Certifique-se de que recebe este ficheiro e verifique se segue o formato esperado. Tenha em atenção que este ficheiro era anteriormente denominado ficheiro de "Identificação do dispositivo" (DEID). Além disso, certifique-se de que o hardware e as respetivas ligações de rede correspondem aos ficheiros.

Nota: o ficheiro de texto devices.csv é um ficheiro de valores separados por vírgulas (CSV) que usa vírgulas para separar os valores. Não aceita nenhum caráter como separador que não seja a vírgula.

Geração

1. Certifique-se de que recebe os ficheiros de folha de cálculo de identificação do dispositivo ("DEID") do fornecedor de hardware:
   1. Um ficheiro de folha de cálculo para cada rack na instância do Distributed Cloud.
   2. Cada folha de cálculo contém um separador com informações do dispositivo.
2. Recolha os registos de dispositivos de cada folha de cálculo DEID:
   1. Agregue manualmente os registos de dispositivos de cada folha de cálculo numa folha combinada.
   2. Remova linhas vazias.
   3. Certifique-se de que existe apenas uma linha de cabeçalho como a primeira linha.
   4. Cada linha subsequente contém a lista agregada de registos de dispositivos das folhas de cálculo DEID.
3. Converta ou exporte a folha de cálculo DEID agregada para o formato CSV (valores separados por vírgulas).

4. Faça uma conversão da ficha de cabo DEID para o formato devices.csv da Distributed Cloud, conforme descrito na especificação de formato:

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

Nota: o comando format-deid executa uma conversão com base no melhor esforço dos dados do DEID do fornecedor de hardware para o formato devices.csv da nuvem distribuída. O comando modifica os nomes dos cabeçalhos para corresponderem ao formato de cabeçalho esperado. No entanto, os dados em cada um dos registos não são modificados e pode ter de modificar manualmente os dados para cumprir o formato esperado.

Especificação do 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 chassis (se aplicável).	Obrigatório para todos os dispositivos. Para dispositivos NetApp que contêm vários controladores no mesmo chassis, especifique primeiro o número de série do chassis, depois o número de série do primeiro controlador e, por último, 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. Deve 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. Deve 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 suporte do dispositivo de hardware.	Obrigatório para todos os dispositivos, exceto racks. Para dispositivos PDU, especifique a localização da PDU. Para outros dispositivos, especifique a localização da unidade de rack da parte superior do dispositivo. Expressão regular: pdu ^PDU-[LR]$ prateleira ^n\/a$ outro ^U[0-9]{1,2}$ Exemplo: pdu PDU-L indica um cabo que se liga a um dispositivo PDU no lado esquerdo do rack na perspetiva da parte posterior. prateleira 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
escrever	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. Geralmente, todos os tipos de dispositivos requerem o mesmo formato de "-<rack_id>-<device_type>", com a exceção de que alguns tipos de dispositivos de armazenamento requerem um sufixo adicional. Este campo tem de corresponder à especificação de atribuição de nomes de dispositivos para o dispositivo.
modelo	O nome do produto legível do dispositivo de hardware.	Obrigatório para todos os dispositivos. Este campo tem de corresponder à especificação do modelo do dispositivo.
fornecedor	O fabricante do dispositivo de hardware.	Este campo é preenchido automaticamente com base no modelo.
asset_tag^1	A etiqueta impressa para o 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 aceites: 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 aceites: 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 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 do BIOS no dispositivo de 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 de hardware simples no dispositivo do 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 utilizador do administrador da 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 palavra-passe de 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. Tem de 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.	Este campo é automaticamente definido como ilo para dispositivos de servidor.
server_mgmt_port_mac	O endereço MAC da interface de gestão para dispositivos de servidor.	O mesmo que server_bmc_mac.
server_mgmt_port_name	O nome da interface de gestão para dispositivos de servidor.	Este campo é automaticamente definido como LOM1 para dispositivos de servidor.
server_data1_port_mac	O endereço MAC da primeira interface de dados para dispositivos de servidor.	O mesmo que 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.	O mesmo que server_bmc_mac.
server_data2_port_name	O nome da segunda interface de dados para dispositivos de servidor	O mesmo que server_data1_port_name.
switch_username^2	O nome de utilizador do administrador para mudar de dispositivo.	Obrigatório para comutadores. 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 palavra-passe de administrador para dispositivos de comutação.	Obrigatório para comutadores. 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 comutação. Pode obter estas informações ignorando o PoAP e carregando a configuração predefinida do comutador, e executando "show mac address-table | include sup-eth1".	Obrigatório para comutadores. 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 gestão para dispositivos de firewall.	Obrigatório para firewalls. Não especificado para todos os outros dispositivos. Tem de 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 gestão para dispositivos de firewall.	Este campo é automaticamente definido como mgt para dispositivos de firewall.
hsm_mgmt_port_mac	O endereço MAC da interface de gestão para dispositivos HSM.	Obrigatório para HSMs. Não especificado para todos os outros dispositivos. Tem de 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 gestão para dispositivos HSM.	Este campo é automaticamente definido como mgmt0 para dispositivos HSM.
hsm_data1_port_mac	O endereço MAC da primeira interface de dados para dispositivos HSM.	O mesmo que hsm_mgmt_port_mac.
hsm_data1_port_name	O nome da primeira interface de dados para dispositivos HSM	Este campo é automaticamente definido como data0 para dispositivos HSM.
hsm_data2_port_mac	O endereço MAC da segunda interface de dados para dispositivos HSM.	O mesmo que hsm_mgmt_port_mac.
hsm_data2_port_name	O nome da segunda interface de dados para dispositivos HSM	Este campo é automaticamente definido como data0 para dispositivos HSM.
objsadm_bmc_port_mac	O endereço MAC da porta BMC para dispositivos de administrador do Object Storage.	Necessário para dispositivos de administrador do armazenamento de objetos. Não especificado para todos os outros dispositivos. Tem de 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 de administração de armazenamento de objetos.	Este campo é automaticamente definido como OOBM para dispositivos de administrador de armazenamento de objetos.
objsadm_mgmt1_port_mac	O endereço MAC da primeira interface de gestão para dispositivos de administração do armazenamento de objetos.	Igual a objsadm_bmc_port_mac.
objsadm_mgmt1_port_name	O nome da primeira interface de gestão para dispositivos de administrador do armazenamento de objetos	Este campo é automaticamente definido 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 de armazenamento de objetos.	Obrigatório para controladores de computação de armazenamento de objetos. Não especificado para todos os outros dispositivos. Tem de 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.	Este campo é automaticamente definido como OOBM para dispositivos de computação de armazenamento de objetos.
objs_mgmt1_port_mac	O endereço MAC da primeira interface de gestão para dispositivos de controlador de computação de armazenamento de objetos.	Igual a objs_bmc_port_mac.
objs_mgmt1_port_name	O nome da primeira interface de gestão para dispositivos do controlador de computação de armazenamento de objetos.	Este campo é automaticamente definido 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 de prateleira de armazenamento de objetos.	Obrigatório para prateleiras de controladores 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 de prateleira de armazenamento de objetos.	Este campo é automaticamente definido 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 gestão do primeiro controlador para dispositivos de prateleira de armazenamento de objetos.	Obrigatório para controladores de prateleiras de armazenamento de objetos. Não especificado para todos os outros dispositivos. Tem de 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 gestão do primeiro controlador para dispositivos de prateleira de armazenamento de objetos.	Este campo é automaticamente definido como <A-P1 para dispositivos de prateleira de armazenamento de objetos.
objsshelf_controller2_name	O nome físico do segundo controlador para dispositivos de prateleira de armazenamento de objetos.	Este campo é automaticamente definido 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 de prateleira de armazenamento de objetos.	Alfanumérico.
objsshelf_controller2_mgmt_port_mac	O endereço MAC da interface de gestão do segundo controlador para dispositivos de prateleira de armazenamento de objetos.	Igual a objsshelf_controller1_mgmt_port_mac.
objsshelf_controller2_mgmt_port_name	O nome da interface de gestão do segundo controlador para dispositivos de prateleira de armazenamento de objetos.	Este campo é automaticamente definido como B-P1 para dispositivos de prateleira de armazenamento de objetos.
stge_num_data_disks	O número de discos de dados presentes no ficheiro e no dispositivo de armazenamento de blocos.	Obrigatório para dispositivos de armazenamento de ficheiros 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 ficheiros/blocos.	Este campo é automaticamente definido como <device-name>-01 para dispositivos de armazenamento de blocos de ficheiros.
stge_controller1_mgmt_port_mac	O endereço MAC da interface de gestão do primeiro controlador para dispositivos de armazenamento de ficheiros e blocos.	Obrigatório para dispositivos de armazenamento de ficheiros e blocos. Não especificado para todos os outros dispositivos. Tem de 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 gestão do primeiro controlador para dispositivos de armazenamento de ficheiros/blocos.	Este campo é automaticamente definido como e0M para dispositivos de armazenamento de blocos de ficheiros.
stge_controller2_name	O nome físico do segundo controlador para dispositivos de armazenamento de ficheiros e blocos.	Este campo é automaticamente definido como <device-name>-02 para dispositivos de armazenamento de blocos de ficheiros.
stge_controller2_mgmt_port_mac	O endereço MAC da interface de gestão do segundo controlador para dispositivos de armazenamento de ficheiros/blocos.	Igual a stge_controller1_mgmt_port_mac.
stge_controller2_mgmt_port_name	O nome da interface de gestão do segundo controlador para dispositivos de armazenamento de ficheiros e blocos.	Igual a stge_controller1_mgmt_port_name.
stgeshelf_num_data_disks	O número de discos de dados presentes no dispositivo de prateleira de armazenamento de ficheiros/blocos.	Obrigatório para prateleiras de armazenamento de ficheiros 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 prateleira de armazenamento de ficheiros e blocos.	Este campo é automaticamente definido como <device-name>-01 para dispositivos de prateleira de armazenamento de blocos de ficheiros.
stgeshelf_controller2_name	O nome físico do segundo controlador para dispositivos de prateleira de armazenamento de ficheiros/blocos.	Este campo é automaticamente definido como <device-name>-02 para dispositivos de prateleira de armazenamento de blocos de ficheiros.
chassis_bmc_version	A versão do firmware do dispositivo de chassis.	Opcional para chassis. 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 utilizador do administrador da BMC para dispositivos de chassis.	Obrigatório para o chassis. 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 palavra-passe do administrador do BMC para dispositivos de chassis.	Obrigatório para o chassis. 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 chassis.	Obrigatório para o chassis. Não especificado para todos os outros dispositivos. Tem de 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 BMC para dispositivos de chassis.	Este campo é automaticamente definido como ilo para dispositivos de chassis.

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

² Os campos de nome de utilizador e palavra-passe são obrigatórios em secrets.yaml. Os nomes de utilizador e as palavras-passe fornecidos em devices.csv são usados para gerar secrets.yaml, mas não são necessários em devices.csv.