OKE-Worker-Knotenpool erstellen

Verwenden Sie den Befehl oci ce node-pool create und die erforderlichen Parameter, um einen neuen Knotenpool zu erstellen.

oci ce node-pool create --cluster-id <cluster_OCID> --compartment-id <compartment_OCID> --name <pool_name> --node-shape <node_shape_name> [OPTIONS]

1. Rufen Sie die Informationen ab, die Sie zum Ausführen des Befehls benötigen.

   • Die OCID des Compartments, in dem Sie den Knotenpool erstellen möchten: oci iam compartment list

   • Die OCID des Clusters für diesen Knotenpool: oci ce cluster list

   • Der Name des Knotenpools. Geben Sie dabei keine vertraulichen Informationen ein.

   • Die Platzierungskonfiguration für die Knoten, einschließlich Worker-Subnetz-OCID und Faultdomain. Siehe die Beschreibung "Platzierungskonfiguration" in der Prozedur "Konsole". Verwenden Sie den folgenden Befehl, um den Inhalt und das Format dieser Option anzuzeigen:

     $ oci ce node-pool create --generate-param-json-input placement-configs

     Verwenden Sie den folgenden Befehl, um Faultdomains aufzulisten: oci iam fault-domain list. Geben Sie in der Platzierungskonfiguration nicht mehr als eine Faultdomain oder mehrere Subnetze an. Damit das System die besten Faultdomains auswählen kann, geben Sie keine Faultdomain an.

   • (nur VCN-native Podnetzwerkcluster) Die OCID des Podsubnetzes. Siehe Podsubnetz erstellen (VCN-nativer Pod). Siehe auch die Beschreibung in der Podkommunikation in der vorherigen Konsolenprozedur. Verwenden Sie die Option --pod-subnet-ids. Obwohl der Wert der Option --pod-subnet-ids ein Array ist, können Sie nur eine Podsubnetz-OCID angeben.

     Die maximale Anzahl von Pods, die Sie auf einem einzelnen Worker-Knoten in einem Knotenpool ausführen möchten. Verwenden Sie die Option --max-pods-per-node. Der Standardwert ist 31. Sie können eine Zahl zwischen 1 und 110 eingeben. Die Anzahl der VNICs, die von der angegebenen Ausprägung zulässig sind (siehe "Der Name der Ausprägung" unten), begrenzt diese maximale Podanzahl. Siehe Knotenausprägungen und Anzahl der Pods. Um den Adressraum des Podsubnetzes zu erhalten, reduzieren Sie die maximale Anzahl von Pods, die Sie auf einem einzelnen Worker-Knoten ausführen möchten. Dadurch wird die Anzahl der IP-Adressen reduziert, die im Podsubnetz vorab zugewiesen sind.

     (Optional) Die OCID der Netzwerksicherheitsgruppe, die für die Pods in diesem Knotenpool verwendet werden soll. Verwenden Sie die Option --pod-nsg-ids. Sie können bis zu fünf NSGs angeben.

   • Die OCID des Images, das für die Knoten in diesem Knotenpool verwendet werden soll.

     Mit dem folgenden Befehl können Sie die OCID des Images abrufen, das Sie verwenden möchten:

     $ oci compute image list --compartment-id compartment_OCID
                          

     Wenn das Image, das Sie verwenden möchten, nicht aufgeführt ist, können Sie die OCID des Images aus der Ausgabe des Befehls ce node-pool get für einen Knotenpool abrufen, in dem Sie dieses Image zuvor verwendet haben.

     Hinweis
     
     

     Das angegebene Image muss -OKE- in display-name enthalten und darf keine Kubernetes-Version aufweisen, die neuer ist als die Kubernetes-Version, die Sie beim Erstellen des Clusters angegeben haben.

     Die Kubernetes-Version für das Cluster wird in der cluster list-Ausgabe angezeigt. Die Kubernetes-Version für das Image wird in der Eigenschaft display-name in der Ausgabe von image list angezeigt. Die Kubernetes-Version des folgenden Images lautet 1.29.9.

     "display-name": "uln-pca-Oracle-Linux8-OKE-1.29.9-20250325.oci"

     Geben Sie die Option --kubernetes-version nicht im Befehl node-pool create an.

     Sie können eine benutzerdefinierte Boot-Volume-Größe in Gigabyte angeben. Die Standardgröße des Boot-Volumes beträgt 50 GB. Um eine benutzerdefinierte Boot-Volume-Größe anzugeben, verwenden Sie die Option --node-source-details, um sowohl die Boot-Volume-Größe als auch das Image anzugeben. Sie können nicht sowohl --node-image-id als auch --node-source-details angeben. Verwenden Sie den folgenden Befehl, um den Inhalt und das Format der Option für die Knotenquellendetails anzuzeigen.

     $ oci ce node-pool create --generate-param-json-input node-source-details

     Wenn Sie eine benutzerdefinierte Boot-Volume-Größe angeben, müssen Sie die Partition erweitern, um die größere Größe nutzen zu können. Oracle Linux-Plattformimages enthalten das Package oci-utils. Verwenden Sie den Befehl oci-growfs von diesem Package, um die Root-Partition zu erweitern und das Dateisystem dann zu vergrößern. Siehe oci-growfs.

   • Der Name der Ausprägung der Worker-Knoten in diesem Knotenpool. Bei Compute Cloud@Customer-X10-Systemen ist die Ausprägung der Control-Plane-Knoten VM.PCAStandard.E5. Flex.

     Geben Sie die Ausprägungskonfiguration an, wie im folgenden Beispiel dargestellt. Sie müssen einen Wert für ocpus angeben. Die Eigenschaft memoryInGBs ist optional. Der Standardwert in Gigabyte ist das 16-fache der ocpus-Anzahl.

     --node-shape-config '{"ocpus": 32, "memoryInGBs": 512}'

     Hinweis
     
     

     Weisen Sie mindestens 2 OCPUs und 32 GB Arbeitsspeicher für alle 10 ausgeführten Pods zu. Abhängig von den geplanten Workloads müssen Sie möglicherweise weitere Ressourcen zuweisen. Siehe Resource Management für Pods und Container.

   • (Optional) Die OCID der Netzwerksicherheitsgruppe, die für die Knoten in diesem Knotenpool verwendet werden soll. Verwenden Sie die Option --nsg-ids. Geben Sie nur eine NSG an.

   • (Optional) Labels. Wenn Sie Labels auf Knoten festlegen, können Sie Pods für die Planung auf bestimmten Knoten oder Knotengruppen als Ziel festlegen. Mit dieser Funktionalität können Sie sicherstellen, dass bestimmte Pods nur auf Knoten mit bestimmten Isolations-, Sicherheits- oder regulatorischen Eigenschaften ausgeführt werden.

     Verwenden Sie die Option --initial-node-labels, um den Knoten Labels hinzuzufügen. Labels sind eine Liste von Schlüssel/Wert-Paaren, die Knoten nach dem Beitritt zum Kubernetes-Cluster hinzugefügt werden sollen. Es gibt Einschränkungen für Metadatenschlüssel. Siehe Metadatenschlüsseleinschränkungen.

     Im Folgenden finden Sie ein Beispiellabel für die Knoten im Knotenpool:

     --initial-node-labels '[{"key":"disktype","value":"ssd"}]

     Eine einfache Möglichkeit, Knoten basierend auf ihren Labels auszuwählen, ist die Verwendung von nodeSelector in der Podkonfiguration. Kubernetes plant den Pod nur auf Knoten mit den Labels, die im Abschnitt nodeSelector angegeben sind.

     Der folgende Beispielauszug aus einer Podkonfiguration gibt an, dass Pods, die diese Konfiguration verwenden, auf Knoten mit dem Datenträgertyplabel ssd ausgeführt werden müssen:

     nodeSelector:
       disktype: ssd

   • (Optional) Knotenmetadaten. Verwenden Sie die Option --node-metadata, um benutzerdefinierte Benutzerdaten an Knoten anzuhängen. Ein bestimmtes Beispiel finden Sie im folgenden Proxy-Einstellungselement.

     Siehe Metadatenschlüsseleinschränkungen. Die maximale Größe von Knotenmetadaten beträgt 32.000 Byte.

   • (Optional) Proxyeinstellungen. Wenn Ihr Netzwerk Proxyeinstellungen erfordert, damit Worker-Knoten externe Registrys oder Repositorys erreichen können, erstellen Sie beispielsweise ein Argument für die Option --node-metadata.

     Geben Sie im Optionsargument --node-metadata Werte für crio-proxy und crio-noproxy an, wie im folgenden Beispieldateiargument gezeigt:

     {
       "crio-proxy": "http://<your_proxy>.<your_domain_name>:<your_port>",
       "crio-noproxy": "localhost,127.0.0.1,<your_domain_name>,ocir.io,<Kubernetes_cidr>,<pods_cidr>"
     }

     Wenn das Cluster VCN-natives Podnetzwerk verwendet, fügen Sie 169.254.169.254 zur noproxy-Einstellung hinzu, wie im folgenden Beispiel dargestellt:

     "crio-noproxy": "localhost,127.0.0.1,your_domain_name,ocir.io,Kubernetes_cidr,pods_cidr,169.254.169.254"

   • (Optional) Einstellungen zum Löschen von Knoten und Knotenpools. Sie können angeben, wie das Löschen von Knoten behandelt werden soll, wenn Sie einen Knotenpool löschen, einen angegebenen Knoten löschen, die Größe des Knotenpools verringern oder die Platzierungskonfiguration der Knotenpoolknoten ändern. Diese Parameter zum Löschen von Knoten können auch festgelegt oder geändert werden, wenn Sie den Knotenpool aktualisieren, einen angegebenen Knoten löschen oder den Knotenpool löschen.

     Um Einstellungen zum Löschen von Knotenpools anzugeben, erstellen Sie ein Argument für die Option --node-eviction-node-pool-settings. Sie können die Verlängerungsdauer für die Entfernung (evictionGraceDuration) für Knoten angeben. Knoten werden immer gelöscht, nachdem ihre Pods entfernt wurden oder nach Ablauf der Verlängerungsfrist für die Räumung.

     • Verlängerungsfrist für Räumung. Dieser Wert gibt an, wie lange Worker-Knoten ab- und entladen werden dürfen.

       Auf einem Knoten, der abgemeldet ist, können keine neuen Pods platziert werden. Vorhandene Pods auf diesem Knoten sind nicht betroffen.

       Wenn ein Knoten geleert wird, werden die Container jedes Pods ordnungsgemäß beendet und führen alle erforderlichen Bereinigungen durch.

       Der Wert für die Verlängerungsfrist für die Räumung wird im ISO 8601-Format angegeben. Der Standardwert und der Höchstwert sind 60 Minuten (PT60M). Der Mindestwert beträgt 20 Sekunden (PT20S). OKE versucht immer, Knoten für mindestens 20 Sekunden zu entleeren.

     • Zwangsweise löschen. Knoten werden immer gelöscht, nachdem ihre Pods entfernt wurden oder nach Ablauf der Verlängerungsfrist für die Räumung. Nach der standardmäßigen oder angegebenen Verlängerungsdauer für die Entfernung wird der Knoten gelöscht, selbst wenn mindestens ein Podcontainer nicht vollständig entleert ist.

     Das Folgende zeigt ein Beispielargument für die Option --node-eviction-node-pool-settings. Wenn Sie die Eigenschaft isForceDeleteAfterGraceDuration einschließen, muss ihr Wert true sein. Knoten werden immer gelöscht, nachdem ihre Pods entfernt wurden oder nach Ablauf der Verlängerungsfrist für die Räumung.

     --node-eviction-node-pool-settings '{"evictionGraceDuration": "PT30M", "isForceDeleteAfterGraceDuration": true}'

     Hinweis
     
     

     Wenn Sie Terraform verwenden und node_eviction_node_pool_settings angeben, müssen Sie is_force_delete_after_grace_duration explizit auf true setzen, obwohl "true" der Standardwert ist. Die Eigenschaftseinstellung is_force_delete_after_grace_duration ist nicht optional, wenn Sie Terraform verwenden.

   • (Optional) Tags. Fügen Sie mit den Optionen --defined-tags oder --freeform-tags Freiformtags für die Knotenpoolressource hinzu. Geben Sie keine Werte für das definierte Tag OraclePCA-OKE.cluster_id oder für das Freiformtag ClusterResourceIdentifier an. Diese Tagwerte werden vom System generiert und nur auf Knoten (Instanzen) und nicht auf die Knotenpoolressource angewendet.

     Um allen Knoten im Knotenpool Freiformtags hinzuzufügen, verwenden Sie die Optionen --node-defined-tags und --node-freeform-tags.

     Wichtig
     
     

     Geben Sie keine Werte für das definierte Tag OraclePCA-OKE.cluster_id oder für das Freiformtag ClusterResourceIdentifier an. Diese Tag-Werte werden vom System generiert.

2. Führen Sie den Befehl zum Erstellen des Knotenpools aus.

   Beispiel:

   Informationen zu den in diesem Beispiel gezeigten Optionen und anderen Optionen wie --node-boot-volume-size-in-gbs und nsg-ids finden Sie in der Prozedur Konsole verwenden. Die Option --pod-subnet-ids ist nur anwendbar, wenn das Cluster VCN-natives Podnetzwerk verwendet

   $ oci ce node-pool create \
   --cluster-id ocid1.cluster.unique_ID --compartment-id ocid1.compartment.unique_ID \
   --name node_pool_name --node-shape shape_name --node-image-id ocid1.image.unique_ID \
   --placement-configs '[{"availabilityDomain":"AD-1","subnetId":"ocid1.subnet.unique_ID"}]' \
   --pod-subnet-ids '["ocid1.subnet.unique_ID"]' --size 10 --ssh-public-key "public_key_text"

   Verwenden Sie den Befehl work-request get, um den Status des Erstellungsvorgangs des Knotenpools zu prüfen. Die Arbeitsanforderungs-OCID befindet sich in created-by-work-request-id im Abschnitt metadata der Ausgabe cluster get.

   $ oci ce work-request get --work-request-id workrequest_OCID
                  

   Der Arbeitsanforderungsstatus lautet ACCEPTED, bis das Cluster den Status "Aktiv" oder "Nicht erfolgreich" aufweist.

   Um diese Knoten in einer Liste von Instanzen zu identifizieren, beachten Sie, dass die Namen dieser Knoten das Format oke- ID aufweisen. Dabei ist ID die ersten 32 Zeichen nach dem Namen in der Knotenpool-OCID. Suchen Sie in der Liste nach den Instanzen, deren Namen die Zeichenfolge ID aus dieser Knotenpool-OCID enthalten.

Eine vollständige Liste der CLI-Befehle, Kennzeichen und Optionen finden Sie in der Befehlszeilenreferenz.

Weitere Schritte:

Verwenden Sie den Vorgang CreateNodePool, um einen neuen Knotenpool zu erstellen.

Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-APIs und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter Software Development Kits und Befehlszeilenschnittstelle (CLI).