9.2. Verifica la recepción del archivo cables.csv

Tiempo estimado para completar la actividad: 1 día

Propietario del componente operable: OELCM/HWaaS

Perfil de habilidad: ingeniero de implementación

El archivo cables.csv describe todas las conexiones de cable entre los dispositivos de hardware en una instancia aislada de Google Distributed Cloud (GDC). Es un archivo de entrada obligatorio para generar anulaciones de recursos.

Generación

  1. Asegúrate de recibir los archivos de hojas de cálculo de "datos dinámicos finales de fábrica" del proveedor de hardware:
    1. Un archivo de hoja de cálculo para cada rack de la instancia de Distributed Cloud.
    2. Cada hoja de cálculo contiene una pestaña con información sobre la conexión del cable.
  2. Recopila los registros de cableado de cada hoja de cálculo de "datos dinámicos finales de fábrica":
    1. Agrega manualmente los registros de cable de cada hoja de cálculo en una sola hoja combinada.
    2. Quita las filas vacías.
    3. Asegúrate de que solo haya una línea de encabezado como la primera fila.
    4. Cada fila posterior contiene la lista agregada de registros de cable de las hojas de cálculo de "datos dinámicos finales de fábrica".
  3. Convierte o exporta la hoja de cálculo agregada de "datos dinámicos finales de fábrica" al formato CSV (valores separados por comas).
  4. Ejecuta gdcloud system assets format-cables --input-cables <path/to/aggregated-factory-final-csv> --output-cables <output-path> para realizar una conversión con el mayor esfuerzo posible de la lista de cables "datos dinámicos finales de fábrica" al formato cables.csv de Distributed Cloud que se describe en la especificación de formato.

Especificación de formato

Para que las herramientas de implementación de Distributed Cloud analicen la información del archivo cables.csv y configuren correctamente el hardware de la instancia, debes darle al archivo un formato legible por máquina. En esta sección, se describe el formato esperado para el archivo cables.csv.

El archivo tiene un formato estándar de valores separados por comas en el que cada registro está separado por un delimitador ,. Cada fila, excepto el encabezado, hace referencia a un cable de la instancia de Distributed Cloud.

Nombre de la columna Descripción Formato
end_a_rack_location1 Ubicación del rack del dispositivo de hardware que se conecta al extremo A del cable. Es obligatorio para todas las conexiones.

Para conexiones de PDU (expresión regular): ^PDU-[LR]$
Para todos los demás dispositivos (expresión regular): ^U[0-9]{2}$

Ejemplo de PDU: PDU-L indica un cable que se conecta a un dispositivo de PDU en el lado izquierdo del rack desde la perspectiva posterior.
Ejemplo de no PDU: U32 indica un cable que se conecta a un dispositivo ubicado en la ubicación U 32 del rack.
end_a_device Es el nombre del dispositivo de hardware que se conecta al extremo A del cable. Es obligatorio para todas las conexiones.

Este campo debe coincidir con la especificación de nomenclatura del dispositivo.
end_a_port Nombre del puerto del dispositivo de hardware que se conecta al "extremo A" del cable. Es obligatorio para todas las conexiones.

Este campo debe coincidir con la especificación de nomenclatura de puertos para el dispositivo.
end_a_transceiver_vendor1 Proveedor del transceptor del extremo A del cable (si corresponde) Obligatorio si el extremo A del cable tiene un transceptor o una óptica. No especifiques si el tipo de cable es AOC o DAC.

Valores permitidos:
  • Cisco
  • HPE
  • Intel
  • NetApp
  • Palo Alto
  • Thales
end_a_transceiver_mpn Modelo del transceptor del extremo A del cable (si corresponde) Solo se requiere si este extremo del cable de fibra tiene un transceptor o una óptica. Si el tipo de cable es AOC o DAC, no se debe especificar este campo.

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_vendor1 Proveedor del adaptador para el extremo A del cable (si corresponde) Se requiere si el extremo A del cable tiene un adaptador.

Valores permitidos:
  • Cisco
  • FS
  • HPE
  • Mellanox
end_a_adapter_mpn1 Modelo del adaptador para el extremo A del cable (si corresponde) Solo se requiere si este extremo del cable tiene un adaptador.

Valores permitidos:
  • CVR-QSFP-SFP10G
  • CVR-QSFP28-SFP25G
  • MAM1Q00A-QSA28
  • QSFP28 a SFP28
  • RJ45 a DB9
end_b_rack_location1 Ubicación en el rack del dispositivo de hardware que se conecta al extremo B del cable. Igual que end_a_rack_location.
end_b_device Es el nombre del dispositivo de hardware que se conecta al extremo "B" del cable. Igual que end_b_device.
end_b_port Nombre del puerto del dispositivo de hardware que se conecta al extremo "B" del cable. Igual que end_a_port.
end_b_transceiver_vendor1 Proveedor del transceptor del extremo B del cable (si corresponde) Igual que end_a_transceiver_vendor.
end_b_transceiver_mpn Modelo del transceptor para el "extremo B" del cable (si corresponde). Igual que end_a_transceiver_mpn.
end_b_adapter_vendor1 Proveedor del adaptador para el extremo B del cable (si corresponde) Igual que end_a_adapter_vendor>.
end_b_adapter_mpn1 Modelo del adaptador para el extremo B del cable (si corresponde). Igual que end_a_adapter_mpn.
type Es el tipo de cable. Obligatorio para todos los cables.

Valores permitidos:
  • AOC
  • AOC 2x
  • CAT6
  • DAC
  • DAC 2x
  • DAC 4x
  • MMF
  • MMF 4x
  • MMF DAC
  • MMF MPO-12
  • RJ45
  • SMF
  • SMF 4x
vendor1 Es el proveedor del cable. Obligatorio para todos los cables.

Valores permitidos:
  • Cisco
  • FS
  • HPE
  • NetApp
  • Panduit
  • ProLabs
mpn Modelo del cable. Se requiere para todos los cables.1
Bloquea la generación de activos si no se especifican end_a_transceiver_mpn, end_b_transceiver_mpn ni mpn para las conexiones de separación y torsión.

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
speed1 Velocidad (en GB) del cable. Obligatorio para todos los cables.

Expresión regular: ^[0-9]+$
Ejemplo: 100

La velocidad de las conexiones -ft y -bk de los paneles de desglose será diferente.

Ejemplo:
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 Es la longitud del cable. Obligatorio para todos los cables.

Expresión regular: ^[0-9]*\.?[0-9]+(ft|m)$
Ejemplo: .5m
color1 Color del cable. Obligatorio para todos los cables.

Valores permitidos:
  • Aguamarina
  • negro
  • blue
  • verde
  • orange
  • púrpura
  • rojo
  • blanco
  • amarillo
description Es la descripción del cable. Opcional.

Se permite cualquier texto.

1 El campo se verifica para comprobar el formato, pero no bloquea la generación de activos.

Ejemplo

A continuación, se muestra un ejemplo de un archivo cables.csv para una instancia de GDCH imaginaria de 1 rack que contiene solo algunos cables y 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