Exécution d'Ubuntu sur des noeuds de travail à l'aide d'images personnalisées

Création d'un script cloud-init pour les noeuds gérés

Pour créer un script cloud-init pour exécuter Ubuntu sur des noeuds gérés :

1. Créez un nouveau fichier de script cloud-init à partir de zéro avec un type de fichier pris en charge par cloud-init (tel que .yaml), et ajoutez la logique suivante au fichier de script :

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

   où :

   • <download-url> est l'URL à partir de laquelle télécharger l'ensemble de noeuds Ubuntu que vous avez construit à l'étape précédente (voir Étape 2 : Construire l'URL à partir de laquelle télécharger un ensemble de noeuds Ubuntu). Par exemple, 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> est l'un des suivants, selon la version mineure de Kubernetes que vous voulez exécuter sur le noeud géré :
     • 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.10
     • oci-oke-node-all-1.32.1
     • oci-oke-node-all-1.33.1

     La version mineure de Kubernetes doit correspondre à la version mineure de Kubernetes que vous avez spécifiée lors de la création de l'URL de téléchargement (voir Étape 2 : Construire l'URL à partir de laquelle télécharger un ensemble de noeuds Ubuntu).

   Par exemple, si vous voulez exécuter Ubuntu 22.04 (jammy) et Kubernetes version 1.29.1 sur des noeuds gérés, ajoutez la logique suivante au fichier 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. Enregistrez le fichier de script cloud-init.

Création d'un script cloud-init pour les noeuds auto-gérés

Pour créer un script cloud-init pour exécuter Ubuntu sur des noeuds autogérés :

1. Suivez les instructions sous Création de scripts Cloud-init pour les noeuds autogérés pour obtenir le point d'extrémité privé de l'API Kubernetes de la grappe améliorée à laquelle vous voulez ajouter le noeud autogéré, à l'aide de la console ou de l'interface de ligne de commande.
2. Suivez les instructions sous Création de scripts Cloud-init pour les noeuds autogérés pour obtenir le certificat AC encodé en base64 de la grappe à partir du fichier kubeconfig de la grappe, à l'aide de la console ou de l'interface de ligne de commande.
3. Créez un nouveau fichier de script cloud-init à partir de zéro avec un type de fichier pris en charge par cloud-init (tel que .yaml), et ajoutez la logique suivante au fichier 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>

   où :

   • <download-url> est l'URL à partir de laquelle télécharger l'ensemble de noeuds Ubuntu que vous avez construit à l'étape précédente (voir Étape 2 : Construire l'URL à partir de laquelle télécharger un ensemble de noeuds Ubuntu). Par exemple, 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> est l'un des suivants, selon la version mineure de Kubernetes que vous voulez exécuter sur le noeud autogéré :

     • 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.10
     • oci-oke-node-all-1.32.1
     • oci-oke-node-all-1.33.1

     La version mineure de Kubernetes doit correspondre à la version mineure de Kubernetes que vous avez spécifiée lors de la création de l'URL de téléchargement (voir Étape 2 : Construire l'URL à partir de laquelle télécharger un ensemble de noeuds Ubuntu).

   • <cluster-endpoint> est l'adresse IP du point d'extrémité de l'API Kubernetes de la grappe que vous avez obtenu précédemment.
   • <base64-encoded-certificate> est le certificat d'autorité de certification encodé en base64 de la grappe que vous avez obtenu précédemment (commençant par les caractères LS0t).

   Par exemple, si vous voulez exécuter Ubuntu 22.04 (Jammy) et Kubernetes version 1.29.1 sur un noeud autogéré, ajoutez la logique suivante au fichier 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. Enregistrez le fichier de script cloud-init.

Ajout de noeuds de travail Ubuntu en tant que noeuds gérés

Pour ajouter des noeuds gérés exécutant Ubuntu dans une grappe existante

1. Ouvrez une invite de commande et utilisez la commande oci ce node-pool create pour créer un nouveau groupe de noeuds.
2. En plus des paramètres obligatoires requis par la commande :
   1. Incluez le paramètre --node-image-id et spécifiez l'OCID de l'image personnalisée que vous avez créée à l'étape 1 : Créer une image personnalisée basée sur une instance de calcul existante exécutant la version Ubuntu requise.
   2. Incluez le paramètre --node-metadata et spécifiez le script cloud-init que vous avez créé pour les noeuds gérés à l'étape 3 : Créer un script cloud-init pour installer l'ensemble de noeuds Ubuntu et initialiser le noeud de travail, dans le format approprié pour votre environnement :
      • Linux : --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64 -w 0)'"}'
      • Mac : --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64- b 0)'"}'
      où :

      • <cloud-init-file> est le nom du fichier cloud-init que vous avez créé
      • base64 indique que le fichier doit être encodé en base64

   Par exemple, vous pouvez entrer la commande suivante sur une station de travail 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)'"}'

   Notez que la version de Kubernetes que vous spécifiez à l'aide du paramètre --kubernetes-version doit correspondre à la version de Kubernetes que vous avez spécifiée dans le script cloud-init (voir Étape 3 : Créer un script cloud-init pour installer l'ensemble de noeuds Ubuntu et initialiser le noeud de travail).

Ajout de noeuds de travail Ubuntu en tant que noeuds autogérés

Avant de créer un noeud autogéré, vérifiez que :

• Le cluster auquel vous souhaitez ajouter le noeud autogéré est configuré de manière appropriée pour les noeuds autogérés. Voir Exigences relatives aux grappes.
• Un groupe dynamique et une politique IAM existent déjà pour permettre à l'instance de calcul hébergeant le noeud autogéré de rejoindre une grappe améliorée créée avec Kubernetes Engine. Voir Création d'un groupe dynamique et d'une politique pour les noeuds autogérés.

Utilisation de la console

1. Créez une instance de calcul pour héberger le noeud autogéré :
   1. Ouvrez le menu de navigation et sélectionnez Calcul. Sous Calcul, sélectionnez Instances.
   2. Pour créer une nouvelle instance de calcul, suivez les instructions de la documentation du service de calcul. Notez que des politiques appropriées doivent exister pour permettre à la nouvelle instance de calcul de se joindre à la grappe améliorée. Voir Création d'un groupe dynamique et d'une politique pour les noeuds autogérés.
   3. Dans la section Image et forme, sélectionnez Modifier l'image.
   4. Sélectionnez Mes images, sélectionnez l'option OCID de l'image, puis entrez l'OCID de l'image personnalisée que vous avez créée à l'étape 1 : Créer une image personnalisée basée sur une instance de calcul existante exécutant la version Ubuntu requise.
   5. Sélectionnez Afficher les options avancées et, dans l'onglet Gestion, sélectionnez l'option Coller le script cloud-init.
   6. Copiez et collez le script cloud-init que vous avez créé pour les noeuds autogérés à l'étape 3 : Créer un script cloud-init pour installer l'ensemble de noeuds Ubuntu et amorcer le noeud de travail, dans le champ Script Cloud-init.
   7. Sélectionnez Créer pour créer l'instance de calcul pour héberger le noeud autogéré.

   Lorsque l'instance de calcul est créée, elle est ajoutée en tant que noeud autogéré à la grappe avec le point d'extrémité de l'API Kubernetes que vous avez spécifié dans le script cloud-init.

2. (Facultatif) Vérifiez que le noeud autogéré a été ajouté à la grappe Kubernetes et que des étiquettes ont été ajoutées au noeud et définies comme prévu, en suivant les instructions sous Création de noeuds autogérés.

Utilisation de l'interface de ligne de commande

1. Ouvrez une invite de commande et entrez la commande oci Compute instance launch et les paramètres requis pour créer un noeud auto-géré.
2. En plus des paramètres obligatoires requis par la commande :
   1. Incluez le paramètre --image-id et spécifiez l'OCID de l'image personnalisée que vous avez créée à l'étape 1 : Créer une image personnalisée basée sur une instance de calcul existante exécutant la version Ubuntu requise.
   2. Incluez le paramètre --user-data-file et spécifiez le script cloud-init que vous avez créé pour les noeuds autogérés à l'étape 3 : Créer un script cloud-init pour installer l'ensemble de noeuds Ubuntu et initialiser le noeud de travail.

   Par exemple, vous pouvez entrer la commande suivante :

   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

   Lorsque l'instance de calcul est créée, elle est ajoutée en tant que noeud autogéré à la grappe avec le point d'extrémité de l'API Kubernetes que vous avez spécifié dans le script cloud-init.