9.1. Verificar la recepción del archivo devices.csv

Tiempo estimado para completarlo: 1 día

Propietario del componente operativo: OELCM/HWaaS

Perfil de habilidades: ingeniero de implementaciones

El archivo devices.csv describe todos los dispositivos de hardware de una instancia air-gapped de Google Distributed Cloud (GDC). Asegúrate de que se ha recibido este archivo y comprueba que tiene el formato esperado. Ten en cuenta que este archivo se conocía anteriormente como archivo de identificación de dispositivo (DEID). Además, comprueba que el hardware y sus conexiones de red coincidan con los archivos.

Generación

  1. Asegúrate de recibir los archivos de hoja de cálculo de identificación del dispositivo ("DEID") del proveedor de hardware:
    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 el dispositivo.
  2. Recopila los registros de dispositivos de cada hoja de cálculo de DEIDs:
    1. Agrega manualmente los registros de dispositivos 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 dispositivos de las hojas de cálculo de DEID.
  3. Convierte o exporta la hoja de cálculo de datos anonimizados agregados al formato CSV (valores separados por comas).
  4. Convierte la lista de cables DEID al formato Distributed Cloud devices.csv descrito en la especificación de formato de la mejor forma posible:

    gdcloud system assets format-deid --input-deid PATH_TO_AGGREGATED_DEID_FILE --output-devices OUTPUT_PATH
    

Especificación de formato

Nombre de la columna Descripción Formato
serial_number Los números de serie asignados al dispositivo de hardware y a los subdispositivos que se encuentren en el mismo chasis (si procede). Obligatorio para todos los dispositivos. En el caso de los dispositivos NetApp que contengan varias controladoras en el mismo chasis, especifica primero el número de serie del chasis, luego el número de serie de la primera controladora y, por último, el número de serie de la segunda controladora (todos separados por comas). Alfanumérico. Expresión regular:
objsshelf stge stgeshelf ^[a-zA-Z0-9]+,[a-zA-Z0-9]+,[a-zA-Z0-9]+$
otra ^U[0-9]{1,2}$

Ejemplo:

objsshelf stge stgeshelf 2M221301D9,2M221301DA,2M221301DB
otra 2M221301D9

instance_id

ID de la instancia de Distributed Cloud asociada al dispositivo de hardware.

Obligatorio para todos los dispositivos.

Debe ser la misma para todos los dispositivos de la misma instancia.

Expresión regular: ^([a-z0-9]{2,})$

Ejemplo:

aa

rack_id

ID del rack asociado al dispositivo de hardware.

Obligatorio para todos los dispositivos.

Debe ser la misma para todos los dispositivos de la misma estantería.

Expresión regular: ^([a-z0-9]{2,})$

Ejemplo:

aa

rack_location1

La ubicación del rack del dispositivo de hardware.

Obligatorio para todos los dispositivos, excepto los bastidores. En el caso de los dispositivos PDU, especifica la ubicación de la PDU. En el caso de otros dispositivos, especifica la ubicación de la unidad de rack de la parte superior del dispositivo.

Expresión regular:

pdu ^PDU-[LR]$
rack ^n\/a$
otra ^U[0-9]{1,2}$

Ejemplo:

pdu PDU-L indica un cable que se conecta a un dispositivo PDU en el lado izquierdo del rack desde la parte posterior.
rack n/a
otra U42

rack_units

La altura (en unidades de rack) del dispositivo de hardware.

Obligatorio para todos los dispositivos, excepto racks y PDUs. Especifica la altura del dispositivo en unidades de rack.

Expresión regular:

pdu rack ^n\/a$
otra ^[0-9]+$

Ejemplo:

pdu rack n/a
otra 1

tipo

El tipo de dispositivo de hardware.

Obligatorio para todos los dispositivos.

Expresión regular:

^(rack)|(pdu)|(server)|(mgmtsw)|(mgmtaggsw)|(torsw)|(aggsw)|(stgesw)|(fw)|(hsm)|(objsadm)|(objs)|(objsshelf)|(stge)|( stgeshelf)$

Ejemplo:

servidor

name

El nombre físico del dispositivo de hardware.

Obligatorio para todos los dispositivos.

El formato necesario depende del tipo de dispositivo de hardware. Por lo general, todos los tipos de dispositivos requieren el mismo formato de "-<rack_id>-<device_type>", con la excepción de que algunos tipos de dispositivos de almacenamiento requieren un sufijo adicional.

Este campo debe coincidir con la especificación del nombre del dispositivo.

modelo

Nombre del producto legible por personas del dispositivo de hardware.

Obligatorio para todos los dispositivos.

Este campo debe coincidir con la especificación del modelo del dispositivo.

vendor

El fabricante del dispositivo de hardware.

Este campo se rellena automáticamente en función del modelo.

asset_tag1

La etiqueta impresa del dispositivo de hardware.

Obligatorio para todos los dispositivos.

Expresión regular:

pdu ^n\/a$
otra ^[A-Z]{2}-(RCK|SVR|SWT|STG|PPL|HSM|FWL|OBJ|NTP|CON|CHS|PDU)-[0-9]{6}$

Ejemplo:

pdu n/a
otra US-SRV-123456

server_cpu_model

El modelo de las CPUs del dispositivo del servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Modelos de CPU de servidor aceptados:

  • Intel Xeon Silver 4210R
  • Intel Xeon Silver 4216
  • Intel Xeon Gold 5220R
  • Intel Xeon Gold 6230R
  • Intel Xeon Silver 4214R
  • Intel Xeon Gold 6226R
  • Intel Xeon Gold 5317
  • Intel Xeon Platinum 8280
  • Intel Xeon Gold 6212U
  • Intel Xeon Gold 6312U
  • Intel Xeon Gold 5418Y
  • Intel Xeon Silver 4410Y
  • Intel Xeon Gold 6538Y+
  • Intel Xeon Platinum 8558

server_num_cpus

Número de CPUs presentes en el dispositivo del servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Numérico.

Expresión regular:

servidor ^[0-9]+$
otra ^n\/a$

Ejemplo:

servidor 2
otra n/a

server_memory_gb

La cantidad de memoria (en GB) del dispositivo de servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^[0-9]+$
otra ^n\/a$

Ejemplo:

servidor 288
otra n/a

server_gpu_model1

El modelo de las GPUs del dispositivo del servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Modelos de GPU de servidor aceptados:

  • nVidia T4 16 GB
  • nVidia A100 40 GB
  • nVidia A100 80 GB
  • nVidia H100 NVL PCIe 94 GB
  • nVidia H100 PCIe 80 GB
  • nVidia H100 XSM 80 GB

server_num_gpus

Número de GPUs del dispositivo de servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^[0-9]+$
otra ^n\/a$

Ejemplo:

servidor 1
otra n/a

server_bios_version1

La versión de la BIOS del dispositivo de servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^U[0-9]+$
otra ^n\/a$

Ejemplo:

servidor U32
otra n/a

server_bmc_version1

Versión de firmware del controlador de hardware en el dispositivo del servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^[0-9]+\.[0-9]+$
otra ^n\/a$

Ejemplo:

servidor 2,55
otra n/a

server_bmc_username2

Nombre de usuario del administrador de BMC para dispositivos de servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^[a-zA-Z0-9]+$
otra ^n\/a$

Ejemplo:

servidor Administrador
otra n/a

server_bmc_password2

La contraseña de administrador de BMC para dispositivos de servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$
otra ^n\/a$

Ejemplo:

servidor ASDF1234
otra n/a

server_bmc_port_mac

La dirección MAC del puerto BMC de los dispositivos de servidor.

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

servidor ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

servidor f0:0d:ca:fe:00:01
otra n/a

server_bmc_port_name

Nombre del puerto BMC de los dispositivos de servidor.

Este campo se definirá automáticamente como ilo en los dispositivos de servidor.

server_mgmt_port_mac

Dirección MAC de la interfaz de gestión de los dispositivos de servidor.

Igual que server_bmc_mac.

server_mgmt_port_name

Nombre de la interfaz de gestión de dispositivos de servidor.

Este campo se definirá automáticamente como LOM1 en los dispositivos de servidor.

server_data1_port_mac

Dirección MAC de la primera interfaz de datos de los dispositivos de servidor.

Igual que server_bmc_mac.

server_data1_port_name

Nombre de la primera interfaz de datos de los dispositivos de servidor

Obligatorio para los servidores. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^s[1-9]p[1-9]$
otra ^n\/a$

Ejemplo:

servidor s1p1
otra n/a

server_data2_port_mac

Dirección MAC de la segunda interfaz de datos de los dispositivos de servidor.

Igual que server_bmc_mac.

server_data2_port_name

Nombre de la segunda interfaz de datos de los dispositivos de servidor.

Igual que server_data1_port_name.

switch_username2

Nombre de usuario del administrador para cambiar de dispositivo.

Obligatorio para los interruptores. No se especifica para el resto de los dispositivos.

Expresión regular:

mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9]+$
otra ^n\/a$

Ejemplo:

mgmtsw mgmtaggsw torsw aggsw stgesw Administrador
Otro n/a

switch_password2

La contraseña de administrador de los dispositivos de interruptor.

Obligatorio para los interruptores. No se especifica para el resto de los dispositivos.

Expresión regular:

mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$
otra ^n\/a$

Ejemplo:

mgmtsw mgmtaggsw torsw aggsw stgesw ASDF1234
otra n/a

switch_mgmt_port_mac

Dirección MAC del puerto supeth1 de los dispositivos de conmutación. Para obtenerla, puedes saltarte el PoAP, cargar la configuración predeterminada del switch y ejecutar "show mac address-table | include sup-eth1".

Obligatorio para los interruptores. No se especifica para el resto de los dispositivos.

Expresión regular:

mgmtsw mgmtaggsw torsw aggsw stgesw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

mgmtsw mgmtaggsw torsw aggsw stgesw f0:0d:ca:fe:00:01
otra n/a

fw_mgmt_port_mac

Dirección MAC de la interfaz de gestión de los dispositivos de cortafuegos.

Obligatorio para los cortafuegos. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

fw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

fw f0:0d:ca:fe:00:01
otra n/a

fw_mgmt_port_name

Nombre de la interfaz de gestión de dispositivos de cortafuegos.

Este campo se definirá automáticamente como mgt en los dispositivos de firewall.

hsm_mgmt_port_mac

Dirección MAC de la interfaz de gestión de los dispositivos HSM.

Obligatorio para los HSMs. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

hsm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

hsm f0:0d:ca:fe:00:01
otra n/a

hsm_mgmt_port_name

Nombre de la interfaz de gestión de dispositivos HSM.

Este campo se asignará automáticamente a mgmt0 en los dispositivos HSM.

hsm_data1_port_mac

Dirección MAC de la primera interfaz de datos de los dispositivos HSM.

Igual que hsm_mgmt_port_mac.

hsm_data1_port_name

Nombre de la primera interfaz de datos de los dispositivos HSM.

Este campo se asignará automáticamente a data0 en los dispositivos HSM.

hsm_data2_port_mac

Dirección MAC de la segunda interfaz de datos de los dispositivos HSM.

Igual que hsm_mgmt_port_mac.

hsm_data2_port_name

Nombre de la segunda interfaz de datos para dispositivos HSM.

Este campo se asignará automáticamente a data0 en los dispositivos HSM.

objsadm_bmc_port_mac

La dirección MAC del puerto BMC de los dispositivos de administrador de Object Storage.

Obligatorio para los dispositivos de administrador de almacenamiento de objetos. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

objsadm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

objsadm f0:0d:ca:fe:00:01
otra n/a

objsadm_bmc_port_name

Nombre del puerto BMC de los dispositivos de administrador de almacenamiento de objetos.

Este campo se definirá automáticamente como OOBM para los dispositivos de administrador de almacenamiento de objetos.

objsadm_mgmt1_port_mac

Dirección MAC de la primera interfaz de gestión de los dispositivos de administración de Object Storage.

Igual que objsadm_bmc_port_mac.

objsadm_mgmt1_port_name

Nombre de la primera interfaz de gestión de dispositivos de administrador de almacenamiento de objetos.

Este campo se definirá automáticamente como e01 para los dispositivos de administrador de almacenamiento de objetos.

objs_bmc_port_mac

La dirección MAC del puerto BMC de los dispositivos Object Storage Compute Controller.

Obligatorio para los controladores de Compute de almacenamiento de objetos. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

objs ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

objs f0:0d:ca:fe:00:01
otra n/a

objs_bmc_port_name

Nombre del puerto BMC de los dispositivos Object Storage Compute Controller.

Este campo se definirá automáticamente como OOBM para los dispositivos de computación de almacenamiento de objetos.

objs_mgmt1_port_mac

Dirección MAC de la primera interfaz de gestión de los dispositivos de controlador de computación de Object Storage.

Igual que objs_bmc_port_mac.

objs_mgmt1_port_name

Nombre de la primera interfaz de gestión de dispositivos Object Storage Compute Controller.

Este campo se definirá automáticamente como e01 para los dispositivos de computación de almacenamiento de objetos.

objsshelf_num_data_disks

Número de discos de datos presentes en el dispositivo Object Storage Shelf.

Obligatorio para los estantes del controlador de almacenamiento de objetos. No se especifica para el resto de los dispositivos.

Numérico.

Expresión regular:

objsshelf ^[0-9]+$
otra ^n\/a$

Ejemplo:

objsshelf 60
otra n/a

objsshelf_controller1_name

Nombre físico del primer controlador de dispositivos Object Storage Shelf.

Este campo se definirá automáticamente como <device-name>-01 para los dispositivos de estantería de almacenamiento de objetos.

objsshelf_controller1_serial_number

Número de serie del primer controlador de dispositivos Object Storage Shelf.

Alfanumérico.

objsshelf_controller1_mgmt_port_mac

Dirección MAC de la interfaz de gestión del primer controlador de los dispositivos Object Storage Shelf.

Obligatorio para los controladores de estanterías de almacenamiento de objetos. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

objsshelf ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

objsshelf f0:0d:ca:fe:00:01
otra n/a

objsshelf_controller1_mgmt_port_name

Nombre de la interfaz de gestión del primer controlador de dispositivos Object Storage Shelf.

Este campo se definirá automáticamente como <A-P1 para los dispositivos de estantería de almacenamiento de objetos.

objsshelf_controller2_name

Nombre físico del segundo controlador de los dispositivos Object Storage Shelf.

Este campo se definirá automáticamente como <device-name>-02 para los dispositivos de estantería de almacenamiento de objetos.

objsshelf_controller2_serial_number

Número de serie del segundo mando de dispositivos Object Storage Shelf.

Alfanumérico.

objsshelf_controller2_mgmt_port_mac

Dirección MAC de la interfaz de gestión del segundo controlador de los dispositivos Object Storage Shelf.

Igual que objsshelf_controller1_mgmt_port_mac.

objsshelf_controller2_mgmt_port_name

Nombre de la interfaz de gestión del segundo controlador de los dispositivos Object Storage Shelf.

Este campo se definirá automáticamente como B-P1 para los dispositivos de estantería de almacenamiento de objetos.

stge_num_data_disks

Número de discos de datos presentes en el dispositivo de almacenamiento de archivos y de bloques.

Obligatorio para dispositivos de almacenamiento de archivos y en bloques. No se especifica para el resto de los dispositivos.

Numérico.

Expresión regular:

stge ^[0-9]+$
otra ^n\/a$

Ejemplo:

stge 60
otra n/a

stge_controller1_name

El nombre físico del primer controlador de dispositivos de almacenamiento de archivos o en bloque.

Este campo se definirá automáticamente como <device-name>-01 para los dispositivos de almacenamiento en bloque de archivos.

stge_controller1_mgmt_port_mac

Dirección MAC de la interfaz de gestión del primer controlador de dispositivos de almacenamiento de archivos y en bloque.

Obligatorio para dispositivos de almacenamiento de archivos y en bloques. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

stge ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

stge f0:0d:ca:fe:00:01
otra n/a

stge_controller1_mgmt_port_name

Nombre de la interfaz de gestión del primer controlador de dispositivos de almacenamiento de archivos o de bloques.

Este campo se definirá automáticamente como e0M para los dispositivos de almacenamiento en bloque de archivos.

stge_controller2_name

Nombre físico del segundo controlador de dispositivos de almacenamiento de archivos y en bloques.

Este campo se definirá automáticamente como <device-name>-02 para los dispositivos de almacenamiento en bloque de archivos.

stge_controller2_mgmt_port_mac

Dirección MAC de la interfaz de gestión del segundo controlador para dispositivos de almacenamiento de archivos o en bloque.

Igual que stge_controller1_mgmt_port_mac.

stge_controller2_mgmt_port_name

Nombre de la interfaz de gestión del segundo controlador de dispositivos de almacenamiento de archivos y en bloques.

Igual que stge_controller1_mgmt_port_name.

stgeshelf_num_data_disks

Número de discos de datos presentes en el dispositivo File/Block Storage Shelf.

Obligatorio para estanterías de almacenamiento de archivos y en bloques. No se especifica para el resto de los dispositivos.

Numérico.

Expresión regular:

stgeshelf ^[0-9]+$
otra ^n\/a$

Ejemplo:

stgeshelf 60
otra n/a

stgeshelf_controller1_name

Nombre físico del primer controlador de los dispositivos de estantería de almacenamiento de archivos y bloques.

Este campo se definirá automáticamente como <device-name>-01 en los dispositivos de almacenamiento en estantería de bloques de archivos.

stgeshelf_controller2_name

Nombre físico del segundo controlador de los dispositivos File/Block Storage Shelf.

Este campo se definirá automáticamente como <device-name>-02 en los dispositivos de almacenamiento en estantería de bloques de archivos.

chassis_bmc_version

Versión de firmware del dispositivo del chasis.

Opcional para chasis. No se especifica para el resto de los dispositivos.

Expresión regular:

servidor ^([0-9]+\.)+[0-9]+(-b[0-9]+)?$
otra ^n\/a$

Ejemplo:

chasis 2.2-b11
otra n/a

chassis_bmc_username2

Nombre de usuario del administrador de BMC para dispositivos de chasis.

Obligatorio para chasis. No se especifica para el resto de los dispositivos.

Expresión regular:

chasis ^[a-zA-Z0-9]+$
otra ^n\/a$

Ejemplo:

chasis Administrador
otra n/a

chassis_bmc_password2

La contraseña de administrador de BMC para dispositivos de chasis.

Obligatorio para chasis. No se especifica para el resto de los dispositivos.

Expresión regular:

chasis ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$
otra ^n\/a$

Ejemplo:

chasis ASDF1234
otra n/a

chassis_bmc_port_mac

La dirección MAC del puerto BMC de los dispositivos de chasis.

Obligatorio para chasis. No se especifica para el resto de los dispositivos.

Debe ser una dirección MAC válida.

Expresión regular:

servidor ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
otra ^n\/a$

Ejemplo:

servidor f0:0d:ca:fe:00:01
otra n/a

chassis_bmc_port_name

El nombre del puerto BMC de los dispositivos de chasis.

Este campo se definirá automáticamente como ilo en los dispositivos de chasis.

1 Se comprobará el formato del campo, pero no se bloqueará la generación de recursos.

2 Los campos de nombre de usuario y contraseña son obligatorios en secrets.yaml. Los nombres de usuario y las contraseñas que se proporcionen en devices.csv se usarán para generar secrets.yaml, pero no son obligatorios en devices.csv.