Migrazione ai cluster VCN nativi

Per eseguire la migrazione di un cluster esistente per integrare il proprio endpoint API Kubernetes nella propria VCN, effettuare le operazioni riportate di seguito.

1. Aprire il menu di navigazione e selezionare Developer Services. In Container e artifact, selezionare Cluster Kubernetes (OKE).

2. Scegliere un compartimento in cui si dispone dell'autorizzazione per lavorare.

   Le etichette Migrazione richiesta vengono visualizzate nella pagina Elenco cluster accanto ai nomi dei cluster con endpoint API Kubernetes non integrati nella VCN.

3. Nella pagina Elenco cluster, fare clic sul nome del cluster di cui si desidera eseguire la migrazione.

   Quando si seleziona un cluster di cui è possibile eseguire la migrazione, nella parte superiore della pagina Dettagli cluster viene visualizzato il pulsante Esegui migrazione cluster.

4. Se si desidera che l'endpoint API Kubernetes del cluster sia accessibile pubblicamente da Internet e ospitato in una nuova subnet pubblica nella stessa VCN del cluster (creazione e configurazione di nuove risorse di rete in base alle esigenze), eseguire una migrazione automatica come indicato di seguito.
   1. Nella parte superiore della pagina Dettagli cluster, fare clic su Esegui migrazione cluster per integrare l'endpoint API Kubernetes del cluster nella propria VCN.
   2. Nella finestra di dialogo Esegui migrazione a cluster nativo VCN, selezionare Migrazione automatica per creare una nuova subnet regionale nella VCN del cluster con un blocco CIDR 10.0.0.0/28, insieme a liste di sicurezza e tabelle di instradamento.
   3. Fare clic su Avvia workflow ed esaminare il riepilogo della migrazione nella finestra di dialogo Migrazione cluster endpoint VCN nativa.
   4. Fare clic su Esegui migrazione per creare nuove risorse di rete ed eseguire la migrazione del cluster.

      Il motore Kubernetes avvia la migrazione del cluster, come mostrato nella finestra di dialogo Migrazione del cluster.

   5. Fare clic su Chiudi per chiudere la finestra di dialogo Migrazione del cluster.
5. Se desideri che l'endpoint API Kubernetes del cluster sia accessibile in modo privato all'interno della tua VCN o sia accessibile pubblicamente da Internet e ospitato in una subnet pubblica o privata regionale esistente nella stessa VCN del cluster, esegui una migrazione personalizzata come indicato di seguito.
   1. Confermare che le seguenti risorse di rete esistono già nella VCN e sono configurate in modo corretto per ospitare l'endpoint API Kubernetes (in caso contrario, crearle e configurarle in modo appropriato):
      • una subnet pubblica o privata regionale (vedere Configurazione della subnet dell'endpoint API Kubernetes)
      • se la subnet è pubblica, un gateway Internet (vedere Configurazione del gateway Internet)
      • se la subnet è privata, un gateway NAT (vedere Configurazione del gateway NAT) e un gateway di servizi (vedere Configurazione del gateway di servizi)
      • una tabella di instradamento con le regole di instradamento necessarie (vedere Tabella di instradamento per le subnet degli endpoint dell'API Kubernetes)
      • un gruppo di sicurezza di rete (consigliato) e/o una lista di sicurezza con le regole di entrata e uscita necessarie (vedere Regole di sicurezza per l'endpoint API Kubernetes)

      Ad esempio, le configurazioni, vedere Esempio di configurazioni delle risorse di rete.

   2. Nella parte superiore della pagina Dettagli cluster, fare clic su Esegui migrazione cluster per integrare l'endpoint API Kubernetes del cluster nella propria VCN.
   3. Nella finestra di dialogo Esegui migrazione a cluster nativo VCN selezionare Migrazione personalizzata.
   4. Fare clic su Avvia workflow e specificare:
      • Subnet dell'endpoint API Kubernetes: una subnet regionale in cui ospitare l'endpoint API Kubernetes del cluster. La subnet specificata può essere pubblica o privata. All'endpoint API Kubernetes viene sempre assegnato un indirizzo IP privato. Se si specifica una subnet pubblica, è possibile esporre facoltativamente l'endpoint API Kubernetes a Internet assegnando un indirizzo IP pubblico all'endpoint (così come l'indirizzo IP privato). Per semplificare la gestione degli accessi, Oracle consiglia che l'endpoint API Kubernetes si trovi in una subnet diversa rispetto ai nodi di lavoro e ai load balancer. Per ulteriori informazioni, consulta il piano di controllo cluster Kubernetes e l'API Kubernetes.
      • Utilizzare i gruppi di sicurezza di rete per controllare il traffico: facoltativamente, limitare l'accesso all'endpoint API Kubernetes del cluster utilizzando uno o più gruppi di sicurezza di rete (NSG) specificati. Per ulteriori informazioni sulle regole di sicurezza da specificare per il gruppo NSG, vedere Regole di sicurezza per l'endpoint API Kubernetes.
      • Assegnare un indirizzo IP pubblico all'endpoint API: se è stata selezionata una subnet pubblica per l'endpoint API Kubernetes, è possibile esporre l'endpoint a Internet assegnando un indirizzo IP pubblico all'endpoint (così come l'indirizzo IP privato). Se non si assegna un indirizzo IP pubblico, aggiornare le regole di instradamento e di sicurezza per abilitare l'accesso all'endpoint utilizzando un gateway di servizio e un gateway NAT (vedere Configurazione della subnet dell'endpoint API Kubernetes).
   5. Fare clic su Esegui migrazione per creare nuove risorse di rete ed eseguire la migrazione del cluster.

      Il motore Kubernetes avvia la migrazione del cluster.

La migrazione di solito richiede circa 15 minuti per essere completata. Durante questo periodo, l'API Kubernetes continua a essere accessibile tramite l'endpoint pubblico non integrato nella tua VCN. Tuttavia, le operazioni del ciclo di vita del cluster (ad esempio aggiornamenti del cluster, creazione ed eliminazione del pool di nodi) non sono disponibili.

Una volta completata la migrazione, la pagina Dettagli cluster mostra il nome della subnet dell'endpoint API Kubernetes, l'indirizzo IP dell'endpoint privato API Kubernetes e, se è stato assegnato un indirizzo IP pubblico all'endpoint API Kubernetes, l'indirizzo IP dell'endpoint pubblico API Kubernetes.

La pagina Dettagli cluster indica inoltre che sono necessari 30 giorni per aggiornare la configurazione di kubectl, strumenti e pipeline CI/CD per accedere al nuovo endpoint API Kubernetes (vedere Impostazione dell'accesso a un cluster migrato). Durante questo periodo di disattivazione, il cluster appena migrato è accessibile sia tramite il nuovo endpoint API Kubernetes nella VCN che tramite l'endpoint API Kubernetes pubblico non integrato nella propria VCN.

Dopo aver eseguito la migrazione di un cluster per integrare il relativo endpoint API Kubernetes nella tua VCN, devi aggiornare la configurazione di kubectl, strumenti e pipeline CI/CD per utilizzare il nuovo endpoint API Kubernetes. Come minimo, dovrai aggiornare il file di configurazione Kubernetes del cluster (comunemente noto come file 'kubeconfig') per abilitare l'accesso al cluster migrato utilizzando kubectl, come descritto in questo argomento. È inoltre necessario aggiornare tutti i file manifest che includono riferimenti all'indirizzo IP dell'endpoint API Kubernetes del cluster.

Seguire le istruzioni riportate in questo argomento per generare un nuovo file kubeconfig. Queste istruzioni presuppongono che il file kubeconfig del cluster venga salvato nella posizione predefinita ($HOME/.kube) e con il nome predefinito (config). In caso contrario, adattare le istruzioni di conseguenza.

1. Nella finestra del terminale in cui normalmente vengono eseguiti i comandi CLI di Oracle Cloud Infrastructure, eseguire il comando seguente per aggiornare il file kubeconfig esistente del cluster:

   oci ce cluster create-kubeconfig --cluster-id <cluster-ocid> --file <kubeconfig-file-location> --region <region-name> --token-version 2.0.0 --kube-endpoint PRIVATE_ENDPOINT|PUBLIC_ENDPOINT

   Dove:

   • --cluster-id <cluster-ocid> è l'OCID del cluster esistente che si desidera rendere nativo per la VCN.
   • --file <kubeconfig-file-location> è la posizione del file kubeconfig del cluster.
   • --region <region-name> è l'area in cui si trova il cluster.
   • --kube-endpoint PRIVATE_ENDPOINT|PUBLIC_ENDPOINT specifica se aggiungere l'indirizzo IP privato o l'indirizzo IP pubblico dell'endpoint API Kubernetes del cluster al file kubeconfig. Per ulteriori informazioni, consulta il piano di controllo cluster Kubernetes e l'API Kubernetes.

   Ad esempio:

   oci ce cluster create-kubeconfig --cluster-id ocid1.cluster.oc1.phx.aaaaaaaaae... --file $HOME/.kube/config --region us-phoenix-1 --token-version 2.0.0 --kube-endpoint PUBLIC_ENDPOINT

   Supponendo che il file kubeconfig esista già nella posizione specificata, i dettagli sul cluster vengono aggiunti come nuovo contesto al file kubeconfig esistente, incluso il nuovo endpoint API Kubernetes del cluster nella propria VCN. L'elemento current-context: nel file kubeconfig è impostato per puntare al contesto appena aggiunto.

   Per ulteriori informazioni sull'impostazione del file kubeconfig, vedere Impostazione dell'accesso al cluster.

2. Verificare che kubectl possa connettersi al cluster utilizzando l'endpoint API Kubernetes nella propria VCN immettendo il comando seguente:

   kubectl get nodes

   Vengono visualizzate informazioni sui nodi nel cluster.

   Ora puoi utilizzare kubectl per eseguire operazioni sul cluster utilizzando l'endpoint API Kubernetes nella tua VCN.