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

Tiempo estimado para completarlo: 1 día

Propietario del componente operativo: OELCM/HWaaS

Perfil de habilidades: ingeniero de implementaciones

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

Generación

  1. Asegúrese de que el proveedor de hardware le ha enviado los archivos de hoja de cálculo "factory final dynamic data":
    1. Un archivo de hoja de cálculo por 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 de los cables.
  2. Recopila los registros de cableado de todas las hojas de cálculo "factory final dynamic data":
    1. Agrega manualmente los registros de cable de cada hoja de cálculo en una hoja combinada.
    2. Elimina las filas vacías.
    3. Asegúrate de que solo haya una línea de encabezado en la primera fila.
    4. Cada fila posterior contiene la lista agregada de registros de cables de las hojas de cálculo "factory final dynamic data".
  3. Convierte o exporta la hoja de cálculo "factory final dynamic data" (datos dinámicos finales de fábrica) agregada 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 convertir de la mejor forma posible la lista de cables "factory final dynamic data" al formato Distributed Cloud cables.csv descrito 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 dar formato al archivo de forma que se pueda leer por máquina. En esta sección se describe el formato esperado del archivo cables.csv.

El archivo tiene el formato estándar de valores separados por comas, en el que cada registro está separado por un delimitador ,. Cada fila, excepto la de 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. Obligatorio para todas las conexiones.

Conexiones de PDU (expresión regular): ^PDU-[LR]$
Para el resto de los dispositivos (expresión regular): ^U[0-9]{2}$

Ejemplo de PDU: PDU-L indica un cable que se conecta a un dispositivo PDU en el lado izquierdo del rack desde la parte posterior.
Ejemplo sin PDU: U32 indica un cable que se conecta a un dispositivo situado en la ubicación 32 de la unidad del rack.
end_a_device Nombre del dispositivo de hardware que se conecta al extremo A del cable. 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. Obligatorio para todas las conexiones.

Este campo debe coincidir con la especificación de nomenclatura de puertos del dispositivo.
end_a_transceiver_vendor1 El proveedor del transceptor del extremo A del cable (si procede). Obligatorio si el extremo A del cable tiene un transceptor o un componente óptico. No especifiques si el tipo de cable es AOC o DAC.

Valores permitidos:
  • Cisco
  • HPE
  • Intel
  • NetApp
  • Palo Alto
  • Thales
end_a_transceiver_mpn El modelo del transceptor del extremo A del cable (si procede). Solo es necesario si este extremo del cable de fibra tiene un transceptor o un dispositivo óptico. Si el tipo de cable es AOC o DAC, este campo no se debe especificar.

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 El proveedor del adaptador del extremo A del cable (si procede). Obligatorio si el extremo A del cable tiene un adaptador.

Valores permitidos:
  • Cisco
  • FS
  • HPE
  • Mellanox
end_a_adapter_mpn1 El modelo del adaptador del extremo A del cable (si procede). Solo es obligatorio si este extremo del cable tiene un adaptador.

Valores permitidos:
  • CVR-QSFP-SFP10G
  • CVR-QSFP28-SFP25G
  • MAM1Q00A-QSA28
  • QSFP28-SFP28
  • RJ45-DB9
end_b_rack_location1 Ubicación del rack del dispositivo de hardware que se conecta al extremo B del cable. Igual que end_a_rack_location.
end_b_device Nombre del dispositivo de hardware que se conecta al extremo B del cable. Igual que end_b_device.
end_b_port El nombre del puerto del dispositivo de hardware que se conecta al extremo B del cable. Igual que end_a_port.
end_b_transceiver_vendor1 El proveedor del transceptor del extremo B del cable (si procede). Igual que end_a_transceiver_vendor.
end_b_transceiver_mpn El modelo del transceptor del extremo B del cable (si procede). Igual que end_a_transceiver_mpn.
end_b_adapter_vendor1 El proveedor del adaptador del extremo B del cable (si procede). Igual que end_a_adapter_vendor>.
end_b_adapter_mpn1 El modelo del adaptador del extremo B del cable (si procede). Igual que end_a_adapter_mpn.
type 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 El proveedor del cable. Obligatorio para todos los cables.

Valores permitidos:
  • Cisco
  • FS
  • HPE
  • NetApp
  • Panduit
  • ProLabs
mpn El modelo del cable. Obligatorio para todos los cables.1
Bloquea la generación de recursos si no se especifica ninguno de los elementos end_a_transceiver_mpn, end_b_transceiver_mpn y mpn para las conexiones de ruptura 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 La 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 acoplables 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 La longitud del cable. Obligatorio para todos los cables.

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

Valores permitidos:
  • Aguamarina
  • negro
  • azul
  • verde
  • naranja
  • morado
  • rojo
  • blanco
  • amarillo
description La descripción del cable. Opcional.

Se permite cualquier texto.

1 Se comprueba el formato del campo, pero no se bloquea la generación de recursos.

Ejemplo

Aquí tienes un ejemplo de un archivo cables.csv de una instancia de GDCH imaginaria de un rack que contiene solo unos pocos 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