Ejecución de Ubuntu en nodos de trabajador mediante imágenes personalizadas

Creación de un script cloud-init para nodos gestionados

Para crear un script cloud-init para ejecutar Ubuntu en nodos gestionados:

1. Cree un nuevo archivo de script cloud-init desde cero con un tipo de archivo soportado por cloud-init (como .yaml) y agregue la siguiente lógica al archivo de script:

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] <download-url>'}
   packages:                                                       
    - <oci-package-name>
   runcmd:
    - oke bootstrap

   donde:

   • <download-url> es la URL desde la que descargar el paquete de nodos de Ubuntu que ha creado en el paso anterior (consulte Paso 2: Crear la URL desde la que descargar un paquete de nodos de Ubuntu). Por ejemplo, https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable main
   • <oci-package-name> es uno de los siguientes, según la versión secundaria de Kubernetes que desea ejecutar en el nodo gestionado:
     • oci-oke-node-all-1.27.10
     • oci-oke-node-all-1.28.10
     • oci-oke-node-all-1.29.1
     • oci-oke-node-all-1.30.10
     • oci-oke-node-all-1.31.1
     • oci-oke-node-all-1.32.1
     • oci-oke-node-all-1.33.0

     La versión secundaria de Kubernetes debe coincidir con la versión secundaria de Kubernetes especificada al crear la URL de descarga (consulte Paso 2: Creación de la URL desde la que se descargará un paquete de nodos de Ubuntu).

   Por ejemplo, si desea ejecutar Ubuntu 22.04 (jammy) y la versión 1.29.1 de Kubernetes en nodos gestionados, agregue la siguiente lógica al archivo de script:

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable main'}
   packages:                                                       
    - oci-oke-node-all-1.29.1
   runcmd:
    - oke bootstrap

2. Guarde el archivo de script de cloud-init.

Creación de un script cloud-init para nodos autogestionados

Para crear un script cloud-init para ejecutar Ubuntu en nodos autogestionados:

1. Siga las instrucciones de Creación de scripts de cloud-init para nodos autogestionados para obtener el punto final privado de la API de Kubernetes del cluster mejorado al que desea agregar el nodo autogestionado mediante la consola o la CLI.
2. Siga las instrucciones de Creating Cloud-init Scripts for Self-managed Nodes para obtener el certificado de CA codificado en base64 del cluster desde el archivo kubeconfig del cluster, mediante la consola o la CLI.
3. Cree un nuevo archivo de script cloud-init desde cero con un tipo de archivo soportado por cloud-init (como .yaml) y agregue la siguiente lógica al archivo de script:

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] <download-url>'}
   packages:
    - <oci-package-name>
   write_files:
   - path: /etc/oke/oke-apiserver
    permissions: '0644'
    content: <cluster-endpoint>
   - encoding: b64
    path: /etc/kubernetes/ca.crt
    permissions: '0644'
    content: <base64-encoded-certificate>
   runcmd:
     - oke bootstrap --ca <base64-encoded-certificate> --apiserver-host <cluster-endpoint>

   donde:

   • <download-url> es la URL desde la que descargar el paquete de nodos de Ubuntu que ha creado en el paso anterior (consulte Paso 2: Crear la URL desde la que descargar un paquete de nodos de Ubuntu). Por ejemplo, https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable main

   • <oci-package-name> es uno de los siguientes, según la versión secundaria de Kubernetes que desea ejecutar en el nodo autogestionado:

     • oci-oke-node-all-1.27.10
     • oci-oke-node-all-1.28.10
     • oci-oke-node-all-1.29.1
     • oci-oke-node-all-1.30.10
     • oci-oke-node-all-1.31.1
     • oci-oke-node-all-1.32.1
     • oci-oke-node-all-1.33.0

     La versión secundaria de Kubernetes debe coincidir con la versión secundaria de Kubernetes especificada al crear la URL de descarga (consulte Paso 2: Creación de la URL desde la que se descargará un paquete de nodos de Ubuntu).

   • <cluster-endpoint> es la dirección IP del punto final de API de Kubernetes del cluster que ha obtenido anteriormente.
   • <base64-encoded-certificate> es el certificado de CA codificado en base64 del cluster que ha obtenido anteriormente (a partir de los caracteres LS0t).

   Por ejemplo, si desea ejecutar Ubuntu 22.04 (Jammy) y Kubernetes versión 1.29.1 en un nodo autogestionado, agregue la siguiente lógica al archivo de script:

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable main'}
   packages:
    - oci-oke-node-all-1.29.1
   write_files:
   - path: /etc/oke/oke-apiserver
    permissions: '0644'
    content: 10.114.0.5
   - encoding: b64
    path: /etc/kubernetes/ca.crt
    permissions: '0644'
    content: LS0tLS1...LS0tCg==
   runcmd:
     - oke bootstrap --ca LS0tLS1...LS0tCg== --apiserver-host 10.114.0.5

4. Guarde el archivo de script de cloud-init.

Agregando nodos de trabajador de Ubuntu como nodos gestionados

Para agregar nodos gestionados que ejecuten Ubuntu en un cluster existente

1. Abra un símbolo del sistema y utilice el comando oci ce node-pool create para crear un nuevo pool de nodos.
2. Además de los parámetros obligatorios requeridos por el comando:
   1. Incluya el parámetro --node-image-id y especifique el OCID de la imagen personalizada que ha creado en el Paso 1: Crear una imagen personalizada basada en una instancia informática existente que ejecute la versión de Ubuntu necesaria.
   2. Incluya el parámetro --node-metadata y especifique el script cloud-init que ha creado para los nodos gestionados en el Step 3: Create a cloud-init script to install the Ubuntu node package and bootstrap the worker node, con el formato adecuado para su entorno:
      • Linux: --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64 -w 0)'"}'
      • Mac: --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64- b 0)'"}'
      donde:

      • <cloud-init-file> es el nombre del archivo cloud-init que ha creado
      • base64 especifica que el archivo se va a codificar en base64

   Por ejemplo, puede introducir el siguiente comando en una estación de trabajo Mac:

   oci ce node-pool create \
   --cluster-id ocid1.cluster.oc1.iad.aaaa______m4w \
   --name my-ubuntu-nodepool \
   --node-image-id ocid1.image.oc1.iad.aaaa______zpq \
   --compartment-id ocid1.tenancy.oc1..aaa______q4a \
   --kubernetes-version v1.29.1 \
   --node-shape VM.Standard2.1 \
   --placement-configs "[{\"availabilityDomain\":\"PKGK:US-ASHBURN-AD-1\", \"subnetId\":\"ocid1.subnet.oc1.iad.aaaa______kfa\"}]" \
   --size 3 \
   --region us-ashburn-1 \
   --node-metadata '{"user_data": "'$(cat my-mgd-ubuntu-cloud-init.yaml | base64 -b 0)'"}'

   Tenga en cuenta que la versión de Kubernetes que especifique mediante el parámetro --kubernetes-version debe corresponder a la versión de Kubernetes especificada en el script cloud-init (consulte Paso 3: Creación de un script cloud-init para instalar el paquete de nodos de Ubuntu y realizar el inicialización del nodo de trabajador).

Agregando nodos de trabajador de Ubuntu como nodos autogestionados

Antes de crear un nodo autogestionado, confirme que:

• El cluster al que desea agregar el nodo autogestionado está configurado correctamente para los nodos autogestionados. Consulte Cluster Requirements.
• Ya existe un grupo dinámico y una política de IAM para permitir que la instancia informática que aloja el nodo autogestionado se una a un cluster mejorado creado con Kubernetes Engine. Consulte Creating a Dynamic Group and a Policy for Self-Managed Nodes.

Uso de la consola

1. Cree una nueva instancia informática para alojar el nodo autogestionado:
   1. Abra el menú de navegación y seleccione Recursos informáticos. En Recursos informáticos, seleccione Instancias.
   2. Siga las instrucciones de la documentación del servicio de recursos informáticos para crear una nueva instancia informática. Tenga en cuenta que deben existir políticas adecuadas para permitir que la nueva instancia informática se una al cluster mejorado. Consulte Creating a Dynamic Group and a Policy for Self-Managed Nodes.
   3. En la sección Imagen y una unidad, seleccione Cambiar imagen.
   4. Seleccione Mis imágenes, seleccione la opción OCID de imagen y, a continuación, introduzca el OCID de la imagen personalizada que ha creado en el Paso 1: Crear una imagen personalizada basada en una instancia informática existente que ejecute la versión de Ubuntu necesaria.
   5. Seleccione Mostrar opciones avanzadas y, en el separador Gestión, seleccione la opción Pegar script cloud-init.
   6. Copie y pegue el script cloud-init que ha creado para los nodos autogestionados en el Paso 3: Crear un script cloud-init para instalar el paquete de nodos de Ubuntu e iniciar el nodo de trabajador en el campo Secuencia de comandos cloud-init.
   7. Seleccione Crear para crear la instancia informática para alojar el nodo autogestionado.

   Cuando se crea la instancia informática, se agrega como nodo autogestionado al cluster con el punto final de API de Kubernetes especificado en el script cloud-init.

2. (Opcional) Verifique que el nodo autogestionado se ha agregado al cluster de Kubernetes y que las etiquetas se han agregado al nodo y se han definido como se esperaba, siguiendo las instrucciones de Creación de nodos autogestionados.

Uso de la CLI

1. Abra un símbolo del sistema e introduzca el comando oci Compute instance launch y los parámetros necesarios para crear un nodo autogestionado.
2. Además de los parámetros obligatorios requeridos por el comando:
   1. Incluya el parámetro --image-id y especifique el OCID de la imagen personalizada que ha creado en el Paso 1: Crear una imagen personalizada basada en una instancia informática existente que ejecute la versión de Ubuntu necesaria.
   2. Incluya el parámetro --user-data-file y especifique el script cloud-init que ha creado para los nodos autogestionados en el Paso 3: Crear un script cloud-init para instalar el paquete de nodos de Ubuntu e iniciar el nodo de trabajador.

   Por ejemplo, puede introducir el siguiente comando:

   oci compute instance launch \
   --availability-domain zkJl:PHX-AD-1 \
   --compartment-id ocid1.compartment.oc1..aaaaaaa______neoq \
   --shape VM.Standard2.2 \
   --subnet-id ocid1.subnet.oc1.phx.aaaaaaa______hzia \
   --user-data-file my-selfmgd-ubuntu-cloud-init.yaml \
   --image-id ocid1.image.oc1.phx.aaaaaaa______slcr

   Cuando se crea la instancia informática, se agrega como nodo autogestionado al cluster con el punto final de API de Kubernetes especificado en el script cloud-init.