Actualiza el dispositivo y aplica parches

En esta página, se describen los pasos para actualizar y aplicar parches a tu dispositivo de appliance aislado de Google Distributed Cloud (GDC).

Prepárate para la actualización

Asegúrate de cumplir con los requisitos que se indican en esta sección antes de la actualización.

Antes de comenzar

Revisa los requisitos previos de la laptop para asegurarte de que la que usas para las actualizaciones y los parches cumpla con las especificaciones físicas y otros requisitos.

Primero, debes completar las siguientes acciones relacionadas con las herramientas de la interfaz de línea de comandos (CLI) de gdcloud:

1. Descarga las herramientas de la CLI gdcloud.
2. Instala las herramientas de la CLI gdcloud.
3. Actualiza las herramientas de la CLI de gdcloud según sea necesario.
4. Asegúrate de que docker-credential-gdcloud esté presente.
5. Verifica que HPE Chassis Manager ejecute la versión de firmware 2.10.12 o posterior. Si actualizas desde una versión de firmware anterior, consulta Actualiza el firmware de HPE Chassis Manager.

Transfiere los artefactos a la máquina de actualización

Debes tener acceso al bucket de Cloud Storage.

Sigue estos pasos para transferir los artefactos a la laptop que usas para las actualizaciones y los parches:

1. Descarga el paquete según la versión del parche seleccionada:

   VERSION=<x.x.x-gdch.yyy>
   RELEASE_SUFFIX="_te"
   DOWNLOADER=gdch-downloader-prod${RELEASE_SUFFIX}-$VERSION.sh
   gcloud storage cp "gs://$GCS_BUCKET/$VERSION/$DOWNLOADER" .
   gcloud storage cp "gs://$GCS_BUCKET/$VERSION/${DOWNLOADER}.sig" .
   
   PUBLIC_KEY=$(cat <<-PUBEND
   -----BEGIN PUBLIC KEY-----
   MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEn46iVSyFXsvuKLZ4dVOr2AqlXDnR
   5cKztkpraexHDxn/ozq03EvrdkRmZkSACFfcaEFyitpraidgAx8sPjvzXQ==
   -----END PUBLIC KEY-----
   PUBEND
   )
   echo "${PUBLIC_KEY}" > "key.pub"
   DOWNLOADER=gdch-downloader-${PRODUCT}-$VERSION.sh
   
   gcloud storage cp "gs://${GCS_BUCKET:-private-cloud-release}/$VERSION/$DOWNLOADER*" .
      openssl dgst -sha256 -verify "key.pub" -signature "${DOWNLOADER}.sig" ${DOWNLOADER} && chmod +x $DOWNLOADER && ./$DOWNLOADER --skip-unzip
   

   Este comando recupera el paquete de actualización y la secuencia de comandos del descargador en el directorio actual, por ejemplo, /home/download.

2. Ejecuta tree -L 3 /home/download.

   Resultado de ejemplo:

   /home/download
   ├── gdch
   │   └── x.x.x-gdch.x
   │       ├── bootstrapper
   │       │   ├── bootstrapper.iso
   │       │   └── bootstrapper.iso.sig
   │       ├── gdch-prod_te-x.x.x-gdch.x-sbom.tar.gz
   │       ├── gdch-prod_te-x.x.x-gdch.x-sbom.tar.gz.sig
   │       ├── prod_te_gdch.tar.gz
   │       └── prod_te_gdch.tar.gz.sig
   ├── gdch-downloader-prod_te-x.x.x-gdch.x.sh
   ├── gdch-downloader-prod_te-x.x.x-gdch.x.sh.1.sig
   ├── gdch-downloader-prod_te-x.x.x-gdch.x.sh.sig
      └── key.pub
   

3. Copia la actualización al entorno aislado con tu unidad USB.

   Copia la secuencia de comandos del descargador y el directorio gdch que descargaste en el paso 1 a tu unidad USB en la máquina de actualización en el entorno aislado.

4. En la máquina de actualización, verifica el contenido y extrae los archivos con la misma información que usaste para descargar el paquete. Por ejemplo, el siguiente código copia el paquete en el directorio /root.

   Descomprime el paquete:

   VERSION=x.x.x-gdch.x
   PRODUCT=prod_te
   DOWNLOADER=gdch-downloader-${PRODUCT}-$VERSION.sh
   openssl dgst -sha256 -verify "key.pub" -signature "${DOWNLOADER}.sig" ${DOWNLOADER} && chmod +x $DOWNLOADER && ./$DOWNLOADER --skip-download
   

   El paquete se descomprime en la ruta de acceso /root/gdch/full-release-x.x.x-gdch.x.

5. Confirma que la versión coincida con la que configuraste en VERSION:

   /root/gdch/full-release-x.x.x-gdch.x/gdcloud version
   

   Resultado de muestra:

   gdcloud version: 1.14.4-gdch.0
   

   Nota: A partir de ahora, todos los comandos de la CLI deben usar el objeto binario de gdcloud de los artefactos descargados recientemente.

Autenticar

Para autenticarte con tu proveedor de identidad configurado y solicitar un archivo kubeconfig para tu identidad de usuario y clúster, consulta Autenticar.

1. Accede y genera los archivos kubeconfig.

2. Configura los archivos kubeconfig como variables de entorno:

     export KUBECONFIG=ROOT_ADMIN_KUBECONFIG
     export MANAGEMENT_KUBECONFIG=MANAGEMENT_API_KUBECONFIG
   

3. Solicita los siguientes roles:

   • Upgrade Appliance Admin:

     kubectl --kubeconfig=$KUBECONFIG create clusterrolebinding upgrade-admin-te-initial-user --clusterrole=upgrade-admin-te --user=[e-mail]
     kubectl --kubeconfig=$MANAGEMENT_KUBECONFIG create clusterrolebinding upgrade-admin-te-initial-user --clusterrole=upgrade-admin-te --user=[e-mail]
     

   • System Artifact Management Admin:

      kubectl --kubeconfig=$KUBECONFIG create rolebinding system-artifact-management-admin-initial-user --role=system-artifact-management-admin --user=[e-mail] -n gpc-system
      kubectl --kubeconfig=$MANAGEMENT_KUBECONFIG create rolebinding system-artifact-management-admin-initial-user --role=system-artifact-management-admin --user=[e-mail] -n gpc-system
     

   • System Artifact Management Secrets Admin:

      kubectl --kubeconfig=$KUBECONFIG create rolebinding system-artifact-management-secrets-admin-initial-user --role=system-artifact-management-secrets-admin --user=[e-mail] -n anthos-creds
     

   • DNS Suffix Viewer:

      kubectl --kubeconfig=$MANAGEMENT_KUBECONFIG create rolebinding dnssuffix-viewer-initial-user --role=dnssuffix-viewer --user=[e-mail] -n gpc-system
     

   • System Artifact Registry Monitor:

      kubectl --kubeconfig=$KUBECONFIG create clusterrolebinding sar-monitor-initial-user --clusterrole=sar-monitor --user=[e-mail]
      kubectl --kubeconfig=$MANAGEMENT_KUBECONFIG create clusterrolebinding sar-monitor-initial-user --clusterrole=sar-monitor --user=[e-mail]
     

   • Upgrade Debugger:

     kubectl --kubeconfig=$KUBECONFIG create clusterrolebinding upgrade-debugger-initial-user --clusterrole=upgrade-debugger --user=[e-mail]
     

   • System Artifact Registry Debugger:

     kubectl --kubeconfig=$KUBECONFIG create clusterrolebinding sar-debugger-initial-user --clusterrole=sar-debugger --user=[e-mail]
     

4. Configura Docker:

   gdcloud auth configure-docker --config-cert=true
   

Inicia la actualización

Sigue los pasos que se indican a continuación para iniciar la actualización del appliance:

gdcloud appliance upgrade 

Consulta gdcloud appliance upgrade para obtener más información.

El comando ejecuta los siguientes pasos:

1. Ejecuta las comprobaciones previas en la máquina de actualización.
2. Ejecuta las comprobaciones previas para el almacenamiento de OTS.
3. Envía los artefactos al registro de artefactos.
4. Actualiza el software y el firmware del appliance, incluidos los siguientes:
   1. Clúster de administración raíz de GDC
   2. Servicios de GDC
   3. Los sistemas operativos (SO) de los nodos físicos y virtuales
   4. El cambio
   5. Almacenamiento

El comando controla las actualizaciones en secuencia y espera a que se complete cada paso. Después de completar los pasos y si la actualización se realiza correctamente, verás un mensaje similar al siguiente:

The GDC appliance upgrade completed successfully