Ubuntu auf Worker-Knoten mit benutzerdefinierten Images ausführen

Cloud-init-Skript für verwaltete Knoten erstellen

So erstellen Sie ein cloud-init-Skript zur Ausführung von Ubuntu auf verwalteten Knoten:

1. Erstellen Sie eine neue cloud-init-Skriptdatei von Grund auf mit einem Dateityp, der von cloud-init (wie .yaml) unterstützt wird, und fügen Sie der Skriptdatei die folgende Logik hinzu:

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

   Hierbei gilt:

   • <download-url> ist die URL, von der das im vorherigen Schritt erstellte Ubuntu-Knotenpackage heruntergeladen werden soll (siehe Schritt 2: URL zum Herunterladen eines Ubuntu-Knotenpackages erstellen). Beispiel: 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> ist laut der Nebenversion von Kubernetes, die Sie auf dem verwalteten Knoten ausführen möchten, eine der folgenden:
     • 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

     Die Nebenversion von Kubernetes muss mit der Nebenversion von Kubernetes übereinstimmen, die Sie beim Erstellen der Download-URL angegeben haben (siehe Schritt 2: URL zum Herunterladen eines Ubuntu-Knotenpackages erstellen).

   Beispiel: Wenn Sie Ubuntu 22.04 (Jammy) und Kubernetes-Version 1.29.1 auf verwalteten Knoten ausführen möchten, fügen Sie der Skriptdatei die folgende Logik hinzu:

   #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. Speichern Sie die cloud-init-Skriptdatei.

Cloud-init-Skript für selbstverwaltete Knoten erstellen

So erstellen Sie ein cloud-init-Skript zur Ausführung von Ubuntu auf selbstverwalteten Knoten:

1. Befolgen Sie die Anweisungen unter Cloud-init-Skripte für selbstverwaltete Knoten erstellen, um den privaten Kubernetes-API-Endpunkt des erweiterten Clusters abzurufen, dem Sie den selbstverwalteten Knoten mit der Konsole oder der CLI hinzufügen möchten.
2. Befolgen Sie die Anweisungen unter Cloud-init-Skripte für selbstverwaltete Knoten erstellen, um das base64-codierte CA-Zertifikat des Clusters über die Konsole oder die CLI aus der kubeconfig-Datei des Clusters abzurufen.
3. Erstellen Sie eine neue cloud-init-Skriptdatei von Grund auf mit einem Dateityp, der von cloud-init (wie .yaml) unterstützt wird, und fügen Sie der Skriptdatei die folgende Logik hinzu:

   #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>

   Hierbei gilt:

   • <download-url> ist die URL, von der das im vorherigen Schritt erstellte Ubuntu-Knotenpackage heruntergeladen werden soll (siehe Schritt 2: URL zum Herunterladen eines Ubuntu-Knotenpackages erstellen). Beispiel: 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> gehört gemäß der Nebenversion von Kubernetes, die Sie auf dem selbstverwalteten Knoten ausführen möchten, zu den folgenden Elementen:

     • 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

     Die Nebenversion von Kubernetes muss mit der Nebenversion von Kubernetes übereinstimmen, die Sie beim Erstellen der Download-URL angegeben haben (siehe Schritt 2: URL zum Herunterladen eines Ubuntu-Knotenpackages erstellen).

   • <cluster-endpoint> ist die IP-Adresse des Kubernetes-API-Endpunkts des Clusters, den Sie zuvor abgerufen haben.
   • <base64-encoded-certificate> ist das base64-codierte CA-Zertifikat des Clusters, das Sie zuvor erhalten haben (ab LS0t).

   Beispiel: Wenn Sie Ubuntu 22.04 (Jammy) und Kubernetes-Version 1.29.1 auf einem selbstverwalteten Knoten ausführen möchten, fügen Sie der Skriptdatei die folgende Logik hinzu:

   #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. Speichern Sie die cloud-init-Skriptdatei.

Ubuntu-Worker-Knoten als verwaltete Knoten hinzufügen

So fügen Sie verwaltete Knoten hinzu, auf denen Ubuntu in einem vorhandenen Cluster ausgeführt wird

1. Öffnen Sie eine Eingabeaufforderung, und verwenden Sie den Befehl oci ce node-pool create, um einen neuen Knotenpool zu erstellen.
2. Neben den obligatorischen Parametern, die für den Befehl erforderlich sind:
   1. Nehmen Sie den Parameter --node-image-id auf, und geben Sie die OCID des benutzerdefinierten Images an, das Sie in Schritt 1: Benutzerdefiniertes Image basierend auf einer vorhandenen Compute-Instanz erstellen, auf der das erforderliche Ubuntu-Release ausgeführt wird erstellt haben.
   2. Nehmen Sie den Parameter --node-metadata auf, und geben Sie das cloud-init-Skript an, das Sie für verwaltete Knoten erstellt haben, in Schritt 3: Erstellen Sie ein cloud-init-Skript, um das Ubuntu-Knotenpackage zu installieren und den Worker-Knoten im entsprechenden Format für Ihre Umgebung zu booten:
      • Linux: --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64 -w 0)'"}'
      • Mac: --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64- b 0)'"}'
      Hierbei gilt:

      • <cloud-init-file> ist der Name der von Ihnen erstellten cloud-init-Datei.
      • base64 gibt an, dass die Datei base64-codiert werden soll

   Sie könnten den folgenden Befehl auf einem Mac-Arbeitsplatz eingeben:

   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)'"}'

   Beachten Sie, dass die mit dem Parameter --kubernetes-version angegebene Kubernetes-Version der Kubernetes-Version entsprechen muss, die Sie im cloud-init-Skript angegeben haben (siehe Schritt 3: Cloud-init-Skript erstellen, um das Ubuntu-Knotenpackage zu installieren und den Worker-Knoten zu booten).

Ubuntu-Worker-Knoten als selbstverwaltete Knoten hinzufügen

Bevor Sie einen selbstverwalteten Knoten erstellen, bestätigen Sie Folgendes:

• Das Cluster, dem Sie den selbstverwalteten Knoten hinzufügen möchten, ist entsprechend für selbstverwaltete Knoten konfiguriert. Siehe Clusteranforderungen.
• Eine dynamische Gruppe und eine IAM-Policy sind bereits vorhanden, damit die Compute-Instanz, die den selbstverwalteten Knoten hostet, einem erweiterten Cluster beitreten kann, das mit der Kubernetes-Engine erstellt wurde. Siehe Dynamische Gruppe und Policy für selbstverwaltete Knoten erstellen.

Konsole verwenden

1. Erstellen Sie eine neue Compute-Instanz, um den selbstverwalteten Knoten zu hosten:
   1. Öffnen Sie das Navigationsmenü , und wählen Sie Compute aus. Wählen Sie unter Compute die Option Instanzen aus.
   2. Befolgen Sie die Anweisungen in der Compute-Servicedokumentation, um eine neue Compute-Instanz zu erstellen. Beachten Sie, dass geeignete Policys vorhanden sein müssen, damit die neue Compute-Instanz dem erweiterten Cluster beitreten kann. Siehe Dynamische Gruppe und Policy für selbstverwaltete Knoten erstellen.
   3. Klicken Sie im Abschnitt Image und Ausprägung auf Image ändern.
   4. Klicken Sie auf Meine Images, wählen Sie die Option Image-OCID aus, und geben Sie dann die OCID des benutzerdefinierten Images ein, das Sie in Schritt 1: Benutzerdefiniertes Image basierend auf einer vorhandenen Compute-Instanz erstellen, auf der das erforderliche Ubuntu-Release ausgeführt wird.
   5. Klicken Sie auf Erweiterte Optionen anzeigen, und wählen Sie auf der Registerkarte Management die Option Cloud-Init-Skript einfügen aus.
   6. Kopieren Sie das cloud-init-Skript, das Sie für selbstverwaltete Knoten erstellt haben, und fügen Sie es in Schritt 3: Erstellen Sie ein cloud-init-Skript, um das Ubuntu-Knotenpackage zu installieren, und booten Sie den Worker-Knoten in das Feld Cloud-init-Skript.
   7. Klicken Sie auf Erstellen, um die Compute-Instanz zum Hosten des selbstverwalteten Knotens zu erstellen.

   Wenn die Compute-Instanz erstellt wird, wird sie dem Cluster mit dem Kubernetes-API-Endpunkt, den Sie im cloud-init-Skript angegeben haben, als selbstverwalteter Knoten hinzugefügt.

2. (Optional) Prüfen Sie, ob der selbstverwaltete Knoten zum Kubernetes-Cluster hinzugefügt wurde und ob Labels dem Knoten hinzugefügt und wie erwartet festgelegt wurden. Befolgen Sie dazu die Anweisungen unter Selbstverwaltete Knoten erstellen.

CLI verwenden

1. Öffnen Sie eine Eingabeaufforderung, und geben Sie den Befehl oci Compute instance launch und die erforderlichen Parameter ein, um einen selbstverwalteten Knoten zu erstellen.
2. Neben den obligatorischen Parametern, die für den Befehl erforderlich sind:
   1. Nehmen Sie den Parameter --image-id auf, und geben Sie die OCID des benutzerdefinierten Images an, das Sie in Schritt 1: Benutzerdefiniertes Image basierend auf einer vorhandenen Compute-Instanz erstellen, auf der das erforderliche Ubuntu-Release ausgeführt wird erstellt haben.
   2. Nehmen Sie den Parameter --user-data-file auf, und geben Sie das cloud-init-Skript an, das Sie für selbstverwaltete Knoten erstellt haben, in Schritt 3: Erstellen Sie ein cloud-init-Skript, um das Ubuntu-Knotenpackage zu installieren und den Worker-Knoten zu booten.

   Beispiel: Geben Sie den folgenden Befehl ein:

   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

   Wenn die Compute-Instanz erstellt wird, wird sie dem Cluster mit dem Kubernetes-API-Endpunkt, den Sie im cloud-init-Skript angegeben haben, als selbstverwalteter Knoten hinzugefügt.