9.2. Verifica la ricezione del file cables.csv

Tempo stimato per il completamento: 1 giorno

Proprietario del componente utilizzabile: OELCM/HWaaS

Profilo delle competenze: ingegnere del deployment

Il file cables.csv descrive tutti i collegamenti dei cavi tra i dispositivi hardware in un'istanza air-gap di Google Distributed Cloud (GDC). È un file di input obbligatorio per generare override delle risorse.

Generazione

  1. Assicurati di ricevere i file del foglio di lavoro "factory final dynamic data" dal fornitore dell'hardware:
    1. Un file di foglio di lavoro per ogni rack nell'istanza di Distributed Cloud.
    2. Ogni foglio di lavoro contiene una scheda con le informazioni sul collegamento del cavo.
  2. Raccogli i record di cablaggio da ogni foglio di lavoro "factory final dynamic data":
    1. Aggrega manualmente i record dei cavi di ogni foglio di lavoro in un unico foglio combinato.
    2. Rimuovi le righe vuote.
    3. Assicurati che ci sia una sola riga di intestazione come prima riga.
    4. Ogni riga successiva contiene l'elenco aggregato dei record dei cavi dei fogli di lavoro "Dati dinamici finali di fabbrica".
  3. Converti o esporta il foglio di lavoro "Dati dinamici finali di fabbrica" aggregato nel formato CSV (valori separati da virgole).
  4. Esegui gdcloud system assets format-cables --input-cables <path/to/aggregated-factory-final-csv> --output-cables <output-path> per eseguire una conversione ottimale dell'elenco dei cavi "factory final dynamic data" nel formato Distributed Cloud cables.csv descritto nella specifica del formato.

Specifica del formato

Affinché gli strumenti di deployment di Distributed Cloud analizzino le informazioni nel file cables.csv e configurino correttamente l'hardware dell'istanza, devi formattare il file in modo leggibile dalla macchina. Questa sezione descrive il formato previsto per il file cables.csv.

Il file è in formato CSV (valori separati da virgole) standard, in cui ogni record è separato da un delimitatore ,. Ogni riga, a parte l'intestazione, si riferisce a un cavo nell'istanza Distributed Cloud.

Nome colonna Descrizione Formato
end_a_rack_location1 La posizione del rack del dispositivo hardware che si collega all'"Estremità A" del cavo. Obbligatorio per tutte le connessioni.

Per le connessioni PDU (espressione regolare): ^PDU-[LR]$
Per tutti gli altri dispositivi (espressione regolare): ^U[0-9]{2}$

Esempio di PDU: PDU-L indica un cavo che si collega a un dispositivo PDU sul lato sinistro del rack dalla prospettiva posteriore.
Esempio non PDU: U32 indica un cavo che si collega a un dispositivo che si trova nella posizione U 32 del rack.
end_a_device Il nome del dispositivo hardware che si connette all'"estremità A" del cavo. Obbligatorio per tutte le connessioni.

Questo campo deve corrispondere alla specifica di denominazione del dispositivo.
end_a_port Il nome della porta sul dispositivo hardware che si collega all'"Estremità A" del cavo. Obbligatorio per tutte le connessioni.

Questo campo deve corrispondere alla specifica di denominazione delle porte per il dispositivo.
end_a_transceiver_vendor1 Il fornitore del ricetrasmettitore per l'estremità A del cavo (se applicabile). Obbligatorio se l'estremità A del cavo ha un ricetrasmettitore o un'ottica. Non specificare se il tipo di cavo è AOC o DAC.

Valori consentiti:
  • Cisco
  • HPE
  • Intel
  • NetApp
  • Palo Alto
  • Thales
end_a_transceiver_mpn Il modello del ricetrasmettitore per l'estremità A del cavo (se applicabile). Obbligatorio solo se questa estremità del cavo in fibra ottica ha un ricetrasmettitore/componente ottico. Se il tipo di cavo è AOC o DAC, questo campo non deve essere specificato.

Valori consentiti:
  • 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-RE-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_vendor1 Il fornitore dell'adattatore per l'estremità A del cavo (se applicabile). Obbligatorio se l'estremità A del cavo ha un adattatore.

Valori consentiti:
  • Cisco
  • FS
  • HPE
  • Mellanox
end_a_adapter_mpn1 Il modello dell'adattatore per l'"Estremità A" del cavo (se applicabile). Obbligatorio solo se questa estremità del cavo ha un adattatore.

Valori consentiti:
  • CVR-QSFP-SFP10G
  • CVR-QSFP28-SFP25G
  • MAM1Q00A-QSA28
  • QSFP28-SFP28
  • RJ45-DB9
end_b_rack_location1 La posizione del rack del dispositivo hardware che si connette all'estremità B del cavo. Uguale a end_a_rack_location.
end_b_device Il nome del dispositivo hardware che si connette all'estremità B del cavo. Uguale a end_b_device.
end_b_port Il nome della porta sul dispositivo hardware che si collega all'"estremità B" del cavo. Uguale a end_a_port.
end_b_transceiver_vendor1 Il fornitore del ricetrasmettitore per l'estremità B del cavo (se applicabile). Uguale a end_a_transceiver_vendor.
end_b_transceiver_mpn Il modello del ricetrasmettitore per l'"estremità B" del cavo (se applicabile). Uguale a end_a_transceiver_mpn.
end_b_adapter_vendor1 Il fornitore dell'adattatore per l'"Estremità B" del cavo (se applicabile). Uguale a end_a_adapter_vendor>.
end_b_adapter_mpn1 Il modello dell'adattatore per l'"estremità B" del cavo (se applicabile). Uguale a end_a_adapter_mpn.
type Il tipo di cavo. Obbligatorio per tutti i cavi.

Valori consentiti:
  • AOC
  • AOC 2x
  • CAT6
  • DAC
  • DAC 2x
  • DAC 4x
  • MMF
  • MMF 4x
  • MMF DAC
  • MMF MPO-12
  • RJ45
  • SMF
  • SMF 4x
vendor1 Il fornitore del cavo. Obbligatorio per tutti i cavi.

Valori consentiti:
  • Cisco
  • FS
  • HPE
  • NetApp
  • Panduit
  • ProLabs
mpn Il modello del cavo. Obbligatorio per tutti i cavi.1
Blocca la generazione di asset se non sono specificati end_a_transceiver_mpn, end_b_transceiver_mpn e mpn per le connessioni breakout e torsw.

Valori consentiti:
  • 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
speed1 La velocità (in GB) del cavo. Obbligatorio per tutti i cavi.

Espressione regolare: ^[0-9]+$
Esempio: 100

La velocità delle connessioni -ft e -bk dei pannelli breakout sarà diversa.

Esempio:
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 La lunghezza del cavo. Obbligatorio per tutti i cavi.

Espressione regolare: ^[0-9]*\.?[0-9]+(ft|m)$
Esempio: .5m
color1 Il colore del cavo. Obbligatorio per tutti i cavi.

Valori consentiti:
  • acquamarina
  • nero
  • blu
  • verde
  • orange
  • viola
  • red
  • bianco
  • giallo
description La descrizione del cavo. Facoltativo.

È consentito qualsiasi testo.

1 Il campo viene controllato per il formato, ma non blocca la generazione dell'asset.

Esempio

Ecco un esempio di file cables.csv per un'istanza GDCH immaginaria a 1 rack che contiene solo alcuni cavi e dispositivi.

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