Creazione di un pool di nodi di lavoro OKE

Utilizzare il comando oci ce node-pool create e i parametri necessari per creare un nuovo pool di nodi.

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

1. Ottenere le informazioni necessarie per eseguire il comando.

   • OCID del compartimento in cui si desidera creare il pool di nodi: oci iam compartment list

   • OCID del cluster per questo pool di nodi: oci ce cluster list

   • Nome del pool di nodi. Evitare di fornire informazioni riservate.

   • Configurazione del posizionamento per i nodi, inclusi l'OCID della subnet di lavoro e il dominio di errore. Vedere la descrizione "Configurazione posizionamento" nella procedura Console. Utilizzare il comando seguente per visualizzare il contenuto e il formato di questa opzione:

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

     Utilizzare il comando riportato di seguito per elencare i domini di errore: oci iam fault-domain list. Non specificare più domini di errore o più subnet nella configurazione del posizionamento. Per consentire al sistema di selezionare i domini di errore migliori, non specificare alcun dominio di errore.

   • (Solo cluster di pod networking VCN nativi) L'OCID della subnet pod. Vedere Creazione di una subnet pod (pod nativo VCN). Vedere anche la descrizione in Comunicazione pod nella procedura della console precedente. Utilizzare l'opzione --pod-subnet-ids. Sebbene il valore dell'opzione --pod-subnet-ids sia un array, è possibile specificare un solo OCID subnet pod.

     Il numero massimo di pod che si desidera eseguire su un singolo nodo di lavoro in un pool di nodi. Utilizzare l'opzione --max-pods-per-node. Il valore predefinito per il server di amministrazione è 31. È possibile immettere un numero compreso tra 1 e 110. Il numero di VNIC consentite dalla forma specificata (vedere "Il nome della forma" di seguito) limita questo numero massimo di pod. Vedere Forme nodo e numero di pod. Per conservare lo spazio di indirizzi della subnet pod, ridurre il numero massimo di pod che si desidera eseguire su un singolo nodo di lavoro. Ciò riduce il numero di indirizzi IP preallocati nella subnet del pod.

     (Facoltativo) L'OCID del gruppo di sicurezza di rete da utilizzare per i pod in questo pool di nodi. Utilizzare l'opzione --pod-nsg-ids. È possibile specificare fino a cinque gruppi NSG.

   • OCID dell'immagine da utilizzare per i nodi in questo pool di nodi.

     Utilizzare il seguente comando per ottenere l'OCID dell'immagine che si desidera utilizzare:

     $ oci compute image list --compartment-id compartment_OCID
                          

     Se l'immagine che si desidera utilizzare non è elencata, è possibile ottenere l'OCID dell'immagine dall'output del comando ce node-pool get per un pool di nodi in cui l'immagine è stata utilizzata in precedenza.

     Nota
     
     

     L'immagine specificata deve avere -OKE- nel relativo display-name e non deve avere una versione di Kubernetes più recente della versione di Kubernetes specificata al momento della creazione del cluster.

     La versione Kubernetes per il cluster viene visualizzata nell'output cluster list. La versione di Kubernetes per l'immagine viene visualizzata nella proprietà display-name nell'output image list. La versione Kubernetes dell'immagine seguente è la 1.29.9.

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

     Non specificare l'opzione --kubernetes-version nel comando node-pool create.

     È possibile specificare una dimensione del volume di avvio personalizzata in gigabyte. La dimensione predefinita del volume di avvio è 50 GB. Per specificare una dimensione del volume di avvio personalizzata, utilizzare l'opzione --node-source-details per specificare sia la dimensione del volume di avvio che l'immagine. Non è possibile specificare sia --node-image-id che --node-source-details. Utilizzare il comando seguente per visualizzare il contenuto e il formato dell'opzione Dettagli origine nodo.

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

     Se si specifica una dimensione personalizzata del volume di avvio, è necessario estendere la partizione per sfruttare la dimensione maggiore. Le immagini della piattaforma Oracle Linux includono il pacchetto oci-utils. Utilizzare il comando oci-growfs di tale pacchetto per estendere la partizione root e quindi aumentare il file system. Vedere oci-growfs.

   • Nome della forma dei nodi di lavoro in questo pool di nodi. Per i sistemi X10 di Compute Cloud@Customer, la forma dei nodi del piano di controllo è VM.PCAStandard.E5. Flessibile.

     Specificare la configurazione della forma, come illustrato nell'esempio riportato di seguito. Specificare un valore per ocpus. La proprietà memoryInGBs è facoltativa; il valore predefinito in gigabyte è 16 volte il numero di ocpus.

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

     Nota
     
     

     Alloca almeno 2 OCPU e 32 GB di memoria per ogni 10 pod in esecuzione. Potrebbe essere necessario allocare più risorse, a seconda dei carichi di lavoro pianificati. Vedere Resource Management per pod e container.

   • (Facoltativo) L'OCID del gruppo di sicurezza di rete da utilizzare per i nodi in questo pool di nodi. Utilizzare l'opzione --nsg-ids. Non specificare più di un gruppo NSG.

   • (Facoltativo) Etichette. L'impostazione delle etichette sui nodi consente di indirizzare i pod per la pianificazione su nodi o gruppi di nodi specifici. Utilizzare questa funzionalità per garantire che pod specifici vengano eseguiti solo su nodi con determinate proprietà di isolamento, sicurezza o normativa.

     Utilizzare l'opzione --initial-node-labels per aggiungere etichette ai nodi. Le etichette sono una lista di coppie chiave/valore da aggiungere ai nodi dopo che si sono unite al cluster Kubernetes. Esistono limitazioni per la chiave dei metadati. Vedere Limitazioni della chiave dei metadati.

     Di seguito è riportata un'etichetta di esempio da applicare ai nodi nel pool di nodi.

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

     Un modo semplice per selezionare i nodi in base alle loro etichette è utilizzare nodeSelector nella configurazione del pod. Kubernetes pianifica il pod solo sui nodi che dispongono di ciascuna delle etichette specificate nella sezione nodeSelector.

     Il seguente estratto di esempio da una configurazione pod specifica che i pod che utilizzano questa configurazione devono essere eseguiti su nodi con l'etichetta del tipo di disco ssd:

     nodeSelector:
       disktype: ssd

   • (Facoltativo) I metadati del nodo. Utilizzare l'opzione --node-metadata per collegare i dati utente personalizzati ai nodi. Per un esempio specifico, vedere la seguente voce relativa alle impostazioni proxy.

     Vedere Limitazioni chiave dei metadati. La dimensione massima dei metadati del nodo è di 32.000 byte.

   • (Facoltativo) Impostazioni proxy. Se la rete richiede impostazioni proxy per consentire ai nodi di lavoro di raggiungere registri o repository esterni, ad esempio, creare un argomento per l'opzione --node-metadata.

     Nell'argomento dell'opzione --node-metadata, fornire i valori per crio-proxy e crio-noproxy come mostrato nel seguente argomento del file di esempio:

     {
       "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>"
     }

     Se il cluster utilizza la rete pod VCN nativa, aggiungere 169.254.169.254 all'impostazione noproxy, come nell'esempio riportato di seguito.

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

   • (Facoltativo) Impostazioni di eliminazione di nodi e pool di nodi. È possibile specificare la modalità di gestione dell'eliminazione dei nodi quando si elimina un pool di nodi, si elimina un nodo specificato, si riduce la dimensione del pool di nodi o si modifica la configurazione del posizionamento dei nodi del pool di nodi. Questi parametri di eliminazione dei nodi possono anche essere impostati o modificati quando si aggiorna il pool di nodi, si elimina un nodo specificato o si elimina il pool di nodi.

     Per specificare le impostazioni di eliminazione del pool di nodi, creare un argomento per l'opzione --node-eviction-node-pool-settings. È possibile specificare la durata della tolleranza di rimozione (evictionGraceDuration) per i nodi. I nodi vengono sempre eliminati dopo che i loro pod sono stati sfrattati o alla fine della durata di tolleranza dello sfratto.

     • Durata tolleranza rimozione. Questo valore specifica il periodo di tempo che consente di collegare e svuotare i nodi di lavoro.

       Un nodo collegato non può avere nuovi pod posizionati su di esso. I pod esistenti su quel nodo non sono interessati.

       Quando un nodo viene svuotato, i contenitori di ogni pod terminano in modo normale ed eseguono qualsiasi pulizia necessaria.

       Il valore della durata della tolleranza di rimozione è espresso in formato ISO 8601. Il valore predefinito e il valore massimo sono 60 minuti (PT60M). Il valore minimo è 20 secondi (PT20S). OKE cerca sempre di rimuovere i nodi per almeno 20 secondi.

     • Forza eliminazione. I nodi vengono sempre eliminati dopo che i loro pod sono stati sfrattati o alla fine della durata di tolleranza dello sfratto. Dopo la durata di tolleranza di rimozione predefinita o specificata, il nodo viene eliminato, anche se uno o più contenitori pod non vengono completamente svuotati.

     L'argomento seguente mostra un esempio dell'opzione --node-eviction-node-pool-settings. Se si include la proprietà isForceDeleteAfterGraceDuration, il suo valore deve essere true. I nodi vengono sempre eliminati dopo che i loro pod sono stati sfrattati o alla fine della durata di tolleranza dello sfratto.

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

     Nota
     
     

     Se si utilizza Terraform e si specifica node_eviction_node_pool_settings, è necessario impostare in modo esplicito is_force_delete_after_grace_duration su true, anche se true è il valore predefinito. L'impostazione della proprietà is_force_delete_after_grace_duration non è facoltativa se si utilizza Terraform.

   • (Facoltativo) Tag. Aggiungere tag in formato libero per la risorsa pool di nodi utilizzando le opzioni --defined-tags o --freeform-tags. Non specificare valori per la tag definita OraclePCA-OKE.cluster_id o per la tag in formato libero ClusterResourceIdentifier. Questi valori di tag vengono generati dal sistema e applicati solo ai nodi (istanze), non alla risorsa del pool di nodi.

     Per aggiungere tag in formato libero a tutti i nodi del pool di nodi, utilizzare le opzioni --node-defined-tags e --node-freeform-tags.

     Importante
     
     

     Non specificare valori per la tag definita OraclePCA-OKE.cluster_id o per la tag in formato libero ClusterResourceIdentifier. Questi valori tag vengono generati dal sistema.

2. Eseguire il comando di creazione del pool di nodi.

   Ad esempio:

   Vedere la procedura Uso della console per informazioni sulle opzioni mostrate in questo esempio e su altre opzioni quali --node-boot-volume-size-in-gbs e nsg-ids. L'opzione --pod-subnet-ids è applicabile solo se il cluster utilizza la rete pod VCN nativa

   $ 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"

   Utilizzare il comando work-request get per controllare lo stato dell'operazione di creazione del pool di nodi. L'OCID della richiesta di lavoro si trova in created-by-work-request-id nella sezione metadata dell'output cluster get.

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

   Lo stato della richiesta di lavoro sarà ACCEPTED finché il cluster non sarà in stato Attivo o Non riuscito.

   Per identificare questi nodi in una lista di istanze, tenere presente che i nomi di questi nodi sono nel formato oke- ID , dove ID è il primo carattere di 32 dopo il nome nell'OCID del pool di nodi. Cercare le istanze nella lista i cui nomi contengono la stringa ID da questo OCID pool di nodi.

Per un elenco completo dei comandi, dei flag e delle opzioni dell'interfaccia CLI, vedere Command Line Reference.

Operazioni successive:

Utilizzare l'operazione CreateNodePool per creare un nuovo pool di nodi.

Per informazioni sull'uso dell'API e delle richieste di firma, vedere API REST e Credenziali di sicurezza. Per informazioni sugli SDK, vedere Software Development Kits and Command Line Interface.