Creazione di un pool di nodi di lavoro OKE

Utilizzare il comando oci ce node-pool create e i parametri richiesti 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

   • Il 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 di calcolo dell'interfaccia utente Web. 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 seguente per elencare i domini di errore: oci iam fault-domain list. Non specificare più di un dominio 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 di calcolo dell'interfaccia utente Web. 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 comando seguente 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 è stata utilizzata questa immagine in precedenza.

     Nota
     
     

     L'immagine specificata deve avere -OKE- nel relativo display-name e non deve avere una versione Kubernetes più recente della versione 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. Impossibile 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 del volume di avvio personalizzata, è necessario estendere la partizione per sfruttare le dimensioni maggiori. Le immagini della piattaforma Oracle Linux includono il pacchetto oci-utils. Utilizzare il comando oci-growfs del pacchetto per estendere la partizione root e quindi ingrandire il file system. Vedere oci-growfs.

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

     Specificare la configurazione della forma, come mostrato nell'esempio seguente. 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 normative.

     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 l'accesso al cluster Kubernetes. Per ulteriori informazioni sui limiti dei metadati, vedere Limitazioni 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 con ciascuna delle etichette specificate nella sezione nodeSelector.

     L'estratto di esempio riportato di seguito da una configurazione pod specifica che i pod che utilizzano questa configurazione devono essere eseguiti sui nodi con etichetta del tipo di disco ssd.

     nodeSelector:
       disktype: ssd

   • (Facoltativo) Metadati del nodo. Utilizzare l'opzione --node-metadata per collegare i dati utente personalizzati ai nodi. Per un esempio specifico, vedere l'elemento delle impostazioni proxy riportato di seguito.

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

   • (Opzionale) 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 nell'argomento del file di esempio seguente:

     {
       "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 dei nodi e dei pool di nodi. È possibile specificare come gestire l'eliminazione dei nodi quando si elimina un pool di nodi, si elimina un nodo specificato, si diminuisce la dimensione del pool di nodi o si modifica la configurazione di posizionamento dei nodi del pool di nodi. Questi parametri di eliminazione dei nodi possono essere impostati o modificati anche 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 relativi pod sono stati rimossi o alla fine della durata di tolleranza di rimozione.

     • Durata grazia rimozione. Questo valore specifica il periodo di tempo necessario per consentire il cordone e il drenaggio dei nodi di lavoro.

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

       Quando un nodo viene svuotato, i contenitori di ciascun pod terminano in modo normale ed eseguono qualsiasi cleanup necessario.

       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 eliminare i nodi per almeno 20 secondi.

     • Forza eliminazione. I nodi vengono sempre eliminati dopo che i relativi pod sono stati rimossi o alla fine della durata di tolleranza di rimozione. 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.

     Di seguito è riportato un argomento di esempio per l'opzione --node-eviction-node-pool-settings. Se si include la proprietà isForceDeleteAfterGraceDuration, il valore deve essere true. I nodi vengono sempre eliminati dopo che i relativi pod sono stati rimossi o alla fine della durata di tolleranza di rimozione.

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

   • (Opzionale) Tag. Aggiungere tag definite o in formato libero per la risorsa del pool di nodi utilizzando le opzioni --defined-tags o --freeform-tags. Non specificare i 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 definite o in formato libero a tutti i nodi nel pool di nodi, utilizzare le opzioni --node-defined-tags e --node-freeform-tags.

     Importante
     
     

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

2. Eseguire il comando Crea pool di nodi.

   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"

   L'output del comando node-pool create è lo stesso dell'output del comando node-pool get. Viene visualizzato l'OCID cluster e viene visualizzato un breve riepilogo di ogni nodo. Per ulteriori informazioni su un nodo, utilizzare il comando compute instance get con l'OCID del nodo.

   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 è i primi 32 caratteri dopo il nome nell'OCID del pool di nodi. Cercare le istanze nella lista i cui nomi contengono la stringa ID di questo OCID pool di nodi.

Operazioni successive:

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

Passi successivi: