Installazione di un componente aggiuntivo del cluster

Scopri come installare un componente aggiuntivo cluster utilizzando Kubernetes Engine (OKE).

È possibile installare un componente aggiuntivo di cluster quando si crea un nuovo cluster o per un cluster esistente.

Per istruzioni specifiche sull'installazione:

Per ulteriori informazioni sui componenti aggiuntivi del cluster, vedere Configurazione dei componenti aggiuntivi del cluster.

  • Distribuire e configurare un componente aggiuntivo cluster durante la creazione di un cluster

    1. Per creare un cluster, attenersi alle istruzioni fornite nella sezione Utilizzo della console per creare un cluster con impostazioni definite in modo esplicito nel workflow 'Creazione personalizzata'.
    2. Visualizzare la sezione Configura componenti aggiuntivi cluster della pagina Crea cluster per visualizzare i componenti aggiuntivi cluster abilitati e disponibili.

      Per impostazione predefinita, quando si crea un nuovo cluster:

      • I componenti aggiuntivi cluster essenziali (ad esempio CoreDNS e kube-proxy) vengono visualizzati come abilitati e aggiornati automaticamente.
      • I componenti aggiuntivi cluster facoltativi (come il dashboard Kubernetes) vengono visualizzati come disabilitati.

      Si noti che si sceglie il plugin CNI per il pod networking nella pagina Impostazione di rete, pertanto il plugin CNI non viene visualizzato nella sezione Configura componenti aggiuntivi cluster quando si crea un cluster.

    3. Fare clic sul nome del componente aggiuntivo da distribuire e configurare.
    4. Selezionare l'opzione Abilita <add-on name> per distribuire e abilitare il componente aggiuntivo cluster durante la creazione del cluster.

      Tenere presente che non è possibile disabilitare i componenti aggiuntivi essenziali durante la creazione di un cluster.

    5. Configurare il componente aggiuntivo cluster specificando i dettagli riportati di seguito.
      • Aggiornamenti automatici: selezionare questa opzione quando si desidera che Oracle aggiorni automaticamente il componente aggiuntivo quando diventa disponibile una nuova versione.
      • Scegli una versione: selezionare questa opzione quando si desidera controllare la versione del componente aggiuntivo che Oracle distribuisce nel cluster. Un'avvertenza indica che ti assumi la responsabilità di aggiornare il componente aggiuntivo. Se si sceglie questa opzione, selezionare la versione del componente aggiuntivo da distribuire nel cluster dalla lista Versione. Vedere Versioni supportate dei componenti aggiuntivi cluster.
      • Opzione: e Valore: (facoltativo) specificare una o più coppie chiave/valore da passare come argomenti per il componente aggiuntivo cluster. Ad esempio, per il dashboard Kubernetes, è possibile selezionare l'opzione numOfReplicas e specificare il valore 3. Vedere Argomenti di configurazione dei componenti aggiuntivi cluster.

    Distribuisci e configura un componente aggiuntivo cluster per un cluster avanzato esistente

    1. Aprire il menu di navigazione e selezionare Developer Services. In Container e artifact, selezionare Cluster Kubernetes (OKE).
    2. Selezionare il compartimento che contiene il cluster.
    3. Nella pagina Cluster fare clic sul nome del cluster che si desidera modificare.
    4. In Risorse, fare clic su Componenti aggiuntivi.
    5. Fare clic su Gestisci componenti aggiuntivi, quindi fare clic sul componente aggiuntivo cluster che si desidera distribuire e configurare.
    6. Selezionare l'opzione Abilita <add-on name> per distribuire e abilitare un componente aggiuntivo cluster non abilitato in precedenza su questo cluster oppure per abilitare un cluster distribuito in precedenza ma attualmente disabilitato.

    7. Configurare il componente aggiuntivo cluster specificando i dettagli riportati di seguito.
      • Aggiornamenti automatici: scegliere questa opzione quando si desidera che Oracle aggiorni automaticamente il componente aggiuntivo quando diventa disponibile una nuova versione.
      • Scegliere una versione: scegliere questa opzione quando si desidera controllare la versione del componente aggiuntivo che Oracle distribuisce nel cluster. Un'avvertenza indica che ti assumi la responsabilità di aggiornare il componente aggiuntivo. Se si sceglie questa opzione, selezionare la versione del componente aggiuntivo da distribuire nel cluster dalla lista Versione. Vedere Versioni supportate dei componenti aggiuntivi cluster.
      • Opzione: e Valore: (facoltativo) specificare una o più coppie chiave/valore da passare come argomenti per il componente aggiuntivo cluster. Ad esempio, per il dashboard Kubernetes, è possibile selezionare l'opzione numOfReplicas e specificare il valore 3. Vedere Argomenti di configurazione dei componenti aggiuntivi cluster.
    8. Fare clic su Salva modifiche.
  • Utilizzare il comando oci ce cluster install-addon e i parametri richiesti per distribuire un componente aggiuntivo cluster:

    oci ce cluster install-addon --cluster-id <cluster-ocid> --addon-name <addon-name> [OPTIONS]

    Ad esempio:

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2
    Il parametro --configurations consente di specificare una o più coppie chiave/valore da passare come argomenti al componente aggiuntivo cluster in formato JSON. È necessario eseguire l'escape delle virgolette doppie all'interno della notazione JSON utilizzando una singola barra rovesciata. Ad esempio:
    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"numOfReplicas\", \"value\": \"3\"}]"

    Si noti che se il valore di una chiave è richiesto in formato JSON, è necessario eseguire l'escape delle virgolette doppie all'interno della notazione JSON nidificata utilizzando tre barre rovesciate. Ad esempio:

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"tolerations\", \"value\": \"[{\\\"key\\\":\\\"special\\\", \\\"value\\\":\\\"true\\\", \\\"effect\\\":\\\"noSchedule\\\",\\\"operator\\\":\\\"exists\\\"}]\"}]"

    Per rendere il parametro --configurations meno ingombrante, racchiudere le coppie chiave/valore tra virgolette singole (anziché tra virgolette doppie). Quando si racchiude la coppia chiave/valore tra virgolette singole, non è necessario eseguire l'escape delle virgolette doppie nella notazione JSON con una singola barra rovesciata. E se il valore di una chiave stessa contiene JSON, è necessario eseguire solo le virgolette doppie nella notazione JSON nidificata con una singola barra rovesciata (anziché tre barre rovesciate). Ad esempio:

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "numOfReplicas", "value": "3"}]'
    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "tolerations", "value": "[{\"key\":\"special\", \"value\":\"true\", \"effect\":\"noSchedule\",\"operator\":\"exists\"}]"}]'
  • Eseguire l'operazione InstallAddon per installare un componente aggiuntivo cluster.