Sustitución de volúmenes de inicio de nodos de trabajador

Si ha agregado un nodo autogestionado a un cluster y posteriormente rota las credenciales del cluster, la sustitución del volumen de inicio del nodo autogestionado requiere pasos adicionales (además de los que se describen en Sustitución de volúmenes de inicio de nodos de trabajador). Los pasos adicionales son necesarios porque se hace referencia al certificado de CA del cluster en el script cloud-init de nodos autogestionados.

Supongamos que ya ha rotado el certificado de CA del cluster al que se ha agregado un nodo autogestionado, siguiendo las instrucciones de Rotating Cluster Credentials. Si ahora desea sustituir el volumen de inicio del nodo autogestionado, primero debe modificar la secuencia de comandos cloud-init del nodo autogestionado. Debe sustituir el certificado de CA anterior del cluster al que se hace referencia en el script por el certificado de CA actual del cluster. Siga estos pasos:

1. Obtenga detalles de la instancia informática que aloja el nodo autogestionado introduciendo:

   oci compute instance get --instance-id <instance-ocid>

   Por ejemplo:

   oci compute instance get --instance-id ocid1.instance.oc1.phx.any______blra

   Se devuelven detalles sobre la instancia informática.

2. Localice y anote el OCID del volumen de inicio (que se muestra en source-details en la salida del comando oci compute instance get) introduciendo:

   oci compute instance get --instance-id <instance-ocid> --query 'data."source-details"."boot-volume-id"' --raw-output
   

   Por ejemplo:

   oci compute instance get --instance-id ocid1.instance.oc1.phx.any______blra --query 'data."source-details"."boot-volume-id"' --raw-output
   

   Salida de ejemplo:

   ocid1.bootvolume.oc1.phx.aaaa______g4a

   El OCID del volumen de inicio se utiliza en un paso posterior.

3. Localice los valores metadata que se muestran en la salida de la siguiente manera:

   "metadata": {
   "ssh_authorized_keys": "<key-value>",
   "user_data": "<existing-base64-encoded-init-script>"
   }

   Tenga en cuenta que ssh_authorized_keys está presente cuando se ha configurado el acceso SSH al nodo (que suele ser, pero no siempre, el caso).

   Por ejemplo:

   "metadata": {
   "ssh_authorized_keys": "ssh-rsa AAAA_____ example@acme.com",
   "user_data": "IyEv___1234___PSIK"
   }

   El valor de user_data es el script cloud-init que se utilizó originalmente para agregar la instancia informática al cluster como un nodo autogestionado, en formato codificado base64. El script cloud-init especifica el punto final privado de la API de Kubernetes del cluster y el certificado de CA codificado con base64 anterior del cluster.
4. Copie los valores ssh_authorized_keys y user_data y guárdelos en un nuevo archivo denominado metadata.json introduciendo:

   oci compute instance get --instance-id <instance-ocid> --query 'data.metadata' --raw-output > metadata.json

   Archivo metadata.json de ejemplo:

   {
   "ssh_authorized_keys": "ssh-rsa AAAA_____ user@acme.com",
   "user_data": "IyEv___1234___PSIK"
   }

5. Copie el valor de user_data (el script cloud-init codificado original con base64) y descodifíquelo introduciendo:

   echo "<existing-base64-encoded-init-script>" | base64 --decode

   Por ejemplo:

   echo "IyEv___1234___PSIK" | base64 --decode

   La salida descodificada es el script cloud-init original. Por ejemplo:

   #!/usr/bin/env bash
   bash /etc/oke/oke-install.sh \
     --apiserver-endpoint "10.0.0.12" \
     --kubelet-ca-cert "LS0txxxx______Cg=="

   El valor de --kubelet-ca-cert es el certificado de CA anterior del cluster, en formato codificado con base64.

6. Guarde la salida descodificada como un archivo de texto denominado my-cloud-init-file.
7. Obtenga el certificado de CA actual del cluster (es decir, el certificado de CA del cluster después de la rotación) introduciendo:

   oci ce cluster create-kubeconfig --cluster-id <cluster-ocid> --region <region-identifier> --file - | grep -oE "LS0t.*"

   El certificado de CA codificado base64 actual del cluster se devuelve como una cadena alfanumérica larga, que comienza con los caracteres LS0t. Por ejemplo:

   LS0tyyyy______aP==

8. En el script cloud-init que ha guardado en my-cloud-init-file, sustituya el valor original de --kubelet-ca-cert por el certificado de CA codificado base64 actual y guarde el archivo.

   Por ejemplo:

   #!/usr/bin/env bash
   bash /etc/oke/oke-install.sh \
     --apiserver-endpoint "10.0.0.12" \
     --kubelet-ca-cert "LS0tyyyy______aP=="

9. Base64 codifica el script cloud-init actualizado en my-cloud-init-file. Por ejemplo, introduzca:

   base64 my-cloud-init-file

   El script cloud-init actualizado está codificado en base64 y devuelto como una cadena alfanumérica larga. Por ejemplo:

   IyEv___5678___PSIK

10. Actualice el archivo metadata.json que ha creado anteriormente, de la siguiente manera:

    • Si está presente, mantenga el valor de ssh_authorized_keys sin cambios.
    • Cambie el valor de user_data a la cadena alfanumérica codificada con base64 que acaba de crear a partir del script cloud-init actualizado.

    Por ejemplo:

    {
          "ssh_authorized_keys": "ssh-rsa AAAA_____ user@acme.com",
          "user_data": "IyEv___5678___PSIK"
    }

11. Utilice el OCID del volumen de inicio que ha anotado anteriormente para obtener detalles del volumen de inicio existente introduciendo:

    oci bv boot-volume get --boot-volume-id <boot-volume-ocid> --query 'data.{ "image_id": "image-id", "kms_key_id": "kms-key-id", "boot-volume-size-in-gbs": "boot-volume-size-in-gbs" }' --raw-output

    Por ejemplo:

    oci bv boot-volume get --boot-volume-id ocid1.bootvolume.oc1.phx.aaaa______g4a --query 'data.{ "image_id": "image-id", "kms_key_id": "kms-key-id", "boot-volume-size-in-gbs": "boot-volume-size-in-gbs" }' --raw-output

    Salida de ejemplo:

    {
      "image_id": "ocid1.image.oc1.phx.aaaa____cra",
      "boot-volume-size-in-gbs": 100,
      "kms_key_id": null
    }

12. Utilice la salida para especificar los mismos valores para las propiedades source-details de la instancia informática en un nuevo archivo json denominado my-instance-source-details.json, con el siguiente formato:

    {
    "image-id": "<returned-bv-image-ocid>",
    "source-type": "image",
    "boot-volume-size-in-gbs": <returned-bv-size>,
    "kms_key_id": <returned-bv-kms-key-ocid>
    "isPreserveBootVolumeEnabled": true
    }

    Tenga en cuenta que no tiene que incluir propiedades de volumen de inicio en my-instance-source-details.json que se muestran como que tienen un valor null en la salida del comando oci bv boot-volume get. Por ejemplo, si el volumen de inicio no está cifrado con una clave gestionada por el usuario, el valor de kms_key_id se muestra como null.

    Por ejemplo:

    {
    "image-id": "ocid1.image.oc1.phx.aaaa____cra",
    "source-type": "image",
    "boot-volume-size-in-gbs": 100,
    "isPreserveBootVolumeEnabled": true
    }

    Tenga en cuenta que debe proporcionar un valor para image-id para actualizar las propiedades user_data (específicamente, para actualizar el script cloud-init con el nuevo certificado de CA).

13. Actualice los detalles de la instancia informática que aloja el nodo autogestionado introduciendo

    oci compute instance update --instance-id ocid1.instance.oc1.phx.any______blra --metadata file://metadata.json --source-details file://my-instance-source-details.json
     

14. Verifique que la instancia informática que aloja el nodo autogestionado tiene el valor actualizado para user_data introduciendo:

    oci compute instance get --instance-id <instance-ocid>

    Por ejemplo:

    oci compute instance get --instance-id ocid1.instance.oc1.phx.any______blra

    Se devuelven detalles actualizados sobre la instancia informática que aloja el nodo autogestionado.

    {
      "data": {
        ...
        "metadata": {
          "ssh_authorized_keys": "ssh-rsa AAAA_____ user@acme.com",
          "user_data": "IyEv___5678___PSIK"
        ...

    Después de actualizar el valor user_data al archivo cloud-init codificado con base64 que contiene el nuevo certificado de CA de cluster, ahora puede sustituir el volumen de inicio del nodo autogestionado.

15. Sustituya el volumen de inicio del nodo autogestionado introduciendo:

    oci ce cluster replace-boot-volume-cluster-node --cluster-id <cluster-ocid> --node-id <instance-ocid> [OPTIONS]

    Por ejemplo:

    oci ce cluster replace-boot-volume-cluster-node --cluster-id ocid1.cluster.oc1.phx.aaaa______xoq --node-id ocid1.instance.oc1.phx.any______blra --node-eviction-settings "{\"evictionGraceDuration\": \"PT0M\",\"isForceActionAfterGraceDuration\": true}"

    Para obtener más información, consulte Sustitución de volúmenes de inicio de nodos de trabajador.