9.2. Verificar o recebimento do arquivo cables.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 cables.csv descreve todas as conexões de cabo entre os dispositivos de hardware em uma instância isolada do Google Distributed Cloud (GDC). É um arquivo de entrada obrigatório para gerar substituições de recursos.

Geração

1. Confirme o recebimento dos arquivos de planilha "dados dinâmicos finais da fábrica" 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 sobre a conexão de cabos.
2. Colete os registros de cabeamento de todas as planilhas "Dados dinâmicos finais da fábrica":
   1. Agregue manualmente os registros de cabos 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 cabos das planilhas "factory final dynamic data".
3. Converta ou exporte a planilha agregada "factory final dynamic data" para o formato CSV (valores separados por vírgula).
4. Execute gdcloud system assets format-cables --input-cables <path/to/aggregated-factory-final-csv> --output-cables <output-path> para fazer uma conversão de melhor esforço da lista de cabos "dados dinâmicos finais da fábrica" para o formato Distributed Cloud cables.csv descrito na especificação de formato.

Observação: o comando format-cables realiza uma conversão de melhor esforço dos dados do fornecedor de hardware "dados dinâmicos finais de fábrica" para o formato cables.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 ajustar manualmente os dados para atender ao formato esperado.

Especificação de formato

Para que as ferramentas de implantação do Distributed Cloud analisem as informações no arquivo cables.csv e configurem corretamente o hardware da instância, é preciso formatar o arquivo de maneira legível por máquina. Nesta seção, descrevemos o formato esperado para o arquivo cables.csv.

O arquivo é um formato padrão de valores separados por vírgulas em que cada registro é separado por um delimitador ,. Cada linha, exceto o cabeçalho, se refere a um cabo na instância do Distributed Cloud.

Nome da coluna	Descrição	Formato
end_a_rack_location^1	A localização no rack do dispositivo de hardware conectado à "extremidade A" do cabo.	Obrigatório para todas as conexões. Para conexões de PDU (expressão regular): ^PDU-[LR]$ Para todos os outros dispositivos (expressão regular): ^U[0-9]{2}$ Exemplo de PDU: PDU-L indica um cabo que se conecta a um dispositivo PDU no lado esquerdo do rack pela perspectiva traseira. Exemplo não PDU: U32 indica um cabo conectado a um dispositivo localizado na posição U 32 do rack.
end_a_device	O nome do dispositivo de hardware conectado à "extremidade A" do cabo.	Obrigatório para todas as conexões. Esse campo precisa corresponder à especificação de nomenclatura do dispositivo.
end_a_port	O nome da porta no dispositivo de hardware que se conecta à "extremidade A" do cabo.	Obrigatório para todas as conexões. Esse campo precisa corresponder à especificação de nomenclatura de porta do dispositivo.
end_a_transceiver_vendor^1	O fornecedor do transceptor para a "extremidade A" do cabo (se aplicável).	Obrigatório se a extremidade A do cabo tiver um transceptor ou uma fibra óptica. Não especifique se o tipo de cabo é AOC ou DAC. Valores permitidos: Cisco HPE Intel NetApp Palo Alto Thales
end_a_transceiver_mpn	O modelo do transceptor para a "extremidade A" do cabo (se aplicável).	Só é necessário se essa extremidade do cabo de fibra tiver um transceptor/óptica. Se o tipo de cabo for AOC ou DAC, este campo não poderá ser especificado. Valores permitidos: 25GBase-SR AFBR-709DMZ-IN3 E10GSFPLR PAN-QSFP28-100GBASE-LR4 PAN-SFP-PLUS-LR PAN-T-Q28-100GBASE-SR4 PAN-T-S-PLUS-SR QDD-400G-DR4-S QDD-400G-FR4-S QDD-400G-LR4-S QDD-400G-SR4.2-BD QSFP-100G-CWDM4-S QSFP-100G-DR-S QSFP-100G-FR-S QSFP-100G-LR4-S QSFP-100G-SL4 QSFP-100G-SR1.2 QSFP-100G-SR4-S QSFP-40/100-SRBD QSFP-4X10G-LR-S SFP-10/25G-LR-S SFP-10G-LR SFP-10G-LR-US SFP-10G-SR SFP-25G-SR-S X65404-N-C X6606A X-48895-00-R6
end_a_adapter_vendor^1	O fornecedor do adaptador para a "extremidade A" do cabo (se aplicável).	Obrigatório se a extremidade A do cabo tiver um adaptador. Valores permitidos: Cisco FS HPE Mellanox
end_a_adapter_mpn^1	O modelo do adaptador para a "extremidade A" do cabo, se aplicável.	Só é necessário se essa extremidade do cabo tiver um adaptador. Valores permitidos: CVR-QSFP-SFP10G CVR-QSFP28-SFP25G MAM1Q00A-QSA28 QSFP28-SFP28 RJ45-DB9
end_b_rack_location^1	A localização no rack do dispositivo de hardware conectado à "extremidade B" do cabo.	Igual a end_a_rack_location
end_b_device	O nome do dispositivo de hardware que se conecta à "extremidade B" do cabo.	Igual a end_b_device
end_b_port	O nome da porta no dispositivo de hardware que se conecta à "extremidade B" do cabo.	Igual a end_a_port
end_b_transceiver_vendor^1	O fornecedor do transceptor para a "extremidade B" do cabo (se aplicável).	Igual a end_a_transceiver_vendor
end_b_transceiver_mpn	O modelo do transceptor para a extremidade B do cabo (se aplicável).	Igual a end_a_transceiver_mpn
end_b_adapter_vendor^1	O fornecedor do adaptador para a "extremidade B" do cabo (se aplicável).	Igual a end_a_adapter_vendor>
end_b_adapter_mpn^1	O modelo do adaptador para a extremidade B do cabo (se aplicável).	Igual a end_a_adapter_mpn
type	O tipo de cabo.	Obrigatório para todos os cabos. Valores permitidos: AOC AOC 2x CAT6 DAC DAC 2x DAC 4x MMF MMF 4x MMF DAC MMF MPO-12 RJ45 SMF SMF 4x
vendor^1	O fornecedor do cabo.	Obrigatório para todos os cabos. Valores permitidos: Cisco FS HPE NetApp Panduit ProLabs
mpn	O modelo do cabo.	Obrigatório para todos os cabos.^1 Bloqueia a geração de recursos se nenhum dos end_a_transceiver_mpn, end_b_transceiver_mpn e mpn for especificado para conexões de separação e torsw. Valores permitidos: QSFP-100G-CU3M QSFP-4SFP25G-CU3M X-26013-00 X-QSFP-4SFP25G-CU2M X66211A-05-C X66211A-2 X66211B-2-N-C X66240A-05 X66240A-05-N-C
speed^1	A velocidade (em GB) do cabo.	Obrigatório para todos os cabos. Expressão regular: ^[0-9]+$ Exemplo: 100 A velocidade das conexões -ft e -bk dos painéis de destaque será diferente. Exemplo: xx-aa-torsw01:Eth1/1 <-> xx-aa-ppl01:r03Ap01BO-bk Speed:100 xx-aa-objs01:e1a <-> xx-aa-ppl01:r03Ap01BO-ft Speed:25 xx-aa-objs01:e2a <-> xx-aa-ppl01:r03Ap02BO-ft Speed:25
length	O comprimento do cabo.	Obrigatório para todos os cabos. Expressão regular: ^[0-9]*\.?[0-9]+(ft|m)$ Exemplo: .5m
color^1	A cor do cabo.	Obrigatório para todos os cabos. Valores permitidos: água preto blue verde orange roxo vermelho branco amarelo
description	A descrição do cabo.	Opcional. Qualquer texto é permitido.

O campo ¹ é verificado quanto ao formato, mas não impede a geração de recursos.

Exemplo

Este é um exemplo de arquivo cables.csv para uma instância imaginária do GDCH de um rack que contém apenas alguns cabos e dispositivos.

end_a_rack_location,end_a_device,end_a_port,end_a_transceiver_vendor,end_a_transceiver_mpn,end_a_adapter_vendor,end_a_adapter_mpn,end_b_rack_location,end_b_device,end_b_port,end_b_transceiver_vendor,end_b_transceiver_mpn,end_b_adapter_vendor,end_b_adapter_mpn,type,vendor,mpn,length,color,notes
42,za-aa-torsw01,Eth1/23/1,Cisco,QSFP-100G-SL4,,,40,az-aa-base03,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-1
42,za-aa-torsw01,Eth1/23/2,Cisco,QSFP-100G-SL4,,,39,az-aa-base02,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-2
42,za-aa-torsw01,Eth1/23/3,Cisco,QSFP-100G-SL4,,,38,az-aa-base01,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-3