9.2. Valide a receção do ficheiro cables.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 cables.csv descreve todas as ligações por cabo entre os dispositivos de hardware numa instância isolada do Google Distributed Cloud (GDC). É um ficheiro de entrada obrigatório para gerar substituições de recursos.

Geração

1. Certifique-se de que recebe os ficheiros de folhas de cálculo "factory final dynamic data" 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 de ligação por cabo.
2. Recolha os registos de cablagem de todas as folhas de cálculo de "dados dinâmicos finais de fábrica":
   1. Agregue manualmente os registos de cabos 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 cabos das folhas de cálculo "factory final dynamic data".
3. Converta ou exporte a folha de cálculo "factory final dynamic data" agregada para o formato CSV (valores separados por vírgulas).
4. Execute gdcloud system assets format-cables --input-cables <path/to/aggregated-factory-final-csv> --output-cables <output-path> para fazer uma conversão da melhor forma possível da ficha de cabos de "dados dinâmicos finais de fábrica" para o formato cables.csv da Distributed Cloud descrito na especificação de formato.

Nota: o comando format-cables executa uma conversão com base no melhor esforço dos dados do fornecedor de hardware "dados dinâmicos finais de fábrica" para o formato Distributed Cloud cables.csv. 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 formatar manualmente os dados para cumprir o formato esperado.

Especificação do formato

Para que as ferramentas de implementação do Distributed Cloud analisem as informações no ficheiro cables.csv e configurem corretamente o hardware da instância, tem de formatar o ficheiro de forma legível por máquina. Esta secção descreve o formato esperado para o ficheiro cables.csv.

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

Nome da coluna	Descrição	Formato
end_a_rack_location^1	A localização do rack do dispositivo de hardware que se liga à "extremidade A" do cabo.	Obrigatório para todas as associações. Para ligaçõ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 liga a um dispositivo PDU no lado esquerdo do rack a partir da perspetiva traseira. Exemplo não PDU: U32 indica um cabo que se liga a um dispositivo localizado na localização U 32 do rack.
end_a_device	O nome do dispositivo de hardware que se liga à "extremidade A" do cabo.	Obrigatório para todas as associações. Este campo tem de corresponder à especificação de nomenclatura do dispositivo.
end_a_port	O nome da porta no dispositivo de hardware que se liga à "extremidade A" do cabo.	Obrigatório para todas as associações. Este campo tem de corresponder à especificação de nomenclatura de portas para o dispositivo.
end_a_transceiver_vendor^1	O fornecedor do transrecetor para a "extremidade A" do cabo (se aplicável).	Obrigatório se a extremidade A do cabo tiver um transceptor ou uma fibra ótica. 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 esta extremidade do cabo de fibra tiver um transceitor/ótica. Se o tipo de cabo for AOC ou DAC, este campo não pode 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 esta 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 do rack do dispositivo de hardware que se liga à "extremidade B" do cabo.	Igual a end_a_rack_location.
end_b_device	O nome do dispositivo de hardware que se liga à "extremidade B" do cabo.	Igual a end_b_device.
end_b_port	O nome da porta no dispositivo de hardware que se liga à "extremidade B" do cabo.	Igual a end_a_port.
end_b_transceiver_vendor^1	O fornecedor do transrecetor 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 elementos end_a_transceiver_mpn, end_b_transceiver_mpn e mpn for especificado para ligações de divisã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 ligações -ft e -bk dos painéis detalhados é 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: aqua preto azul verde cor de laranja roxo vermelho branco amarelo
description	A descrição do cabo.	Opcional. Qualquer texto permitido.

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

Exemplo

Segue-se um exemplo de um ficheiro cables.csv para uma instância GDCH imaginária de 1 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