Documentazione di Oracle Cloud Infrastructure

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:

È possibile utilizzare l'API e l'interfaccia CLI per visualizzare un elenco di tutte le versioni di un componente aggiuntivo del cluster specifico (inclusi i numeri di build della versione). Le versioni aggiuntive del cluster attualmente supportate hanno lo stato ACTIVE. Lo stato delle versioni dei componenti aggiuntivi del cluster non più supportate è DEPRECATED. Si noti che le versioni dei componenti aggiuntivi del cluster non più valide vengono fornite solo in circostanze eccezionali, ad esempio per eseguire un rollback. Si consiglia di non utilizzare una versione del componente aggiuntivo del cluster non più valida, né specificare una particolare build di una versione supportata per le normali operazioni.

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

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

    1. Seguire le istruzioni riportate in Uso della console per creare un cluster con impostazioni definite esplicitamente nel workflow 'Creazione personalizzata' per creare un cluster.
    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 la rete pod nella pagina Impostazione di rete, pertanto il plugin CNI non viene visualizzato nella sezione Configura componenti aggiuntivi cluster durante la creazione di un cluster.

    3. Selezionare l'opzione Modifica accanto al componente aggiuntivo che si desidera distribuire e configurare.

    4. Selezionare l'opzione Abilita <nome componente aggiuntivo> per distribuire e abilitare il componente aggiuntivo del 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 è disponibile una nuova versione.
      • Scegliere una versione: selezionare questa opzione quando si desidera controllare la versione del componente aggiuntivo distribuito da Oracle nel cluster. Un'avvertenza indica che l'utente è responsabile dell'aggiornamento del componente aggiuntivo. Se si sceglie questa opzione, selezionare la versione del componente aggiuntivo da distribuire nel cluster dalla lista Versione. Vedere Versioni supportate del componente aggiuntivo cluster.
      • Opzione: e Valore: (facoltativo) fare clic su Aggiungi configurazione per specificare una o più coppie chiave/valore da passare come argomenti all'add-on del cluster. Ad esempio, per il dashboard Kubernetes, è possibile selezionare l'opzione numOfReplicas e specificare un valore 3. Vedere Argomenti di configurazione dei componenti aggiuntivi del cluster.

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

    1. Nella pagina della lista Cluster, selezionare il nome del cluster che si desidera modificare. Se è necessaria assistenza per trovare la pagina della lista o il cluster, vedere Elenca cluster.
    2. Nella scheda Componenti aggiuntivi selezionare Gestisci componenti aggiuntivi.
    3. Selezionare l'opzione Modifica accanto al componente aggiuntivo del cluster che si desidera distribuire e configurare.

    4. Selezionare l'opzione Abilita <nome componente aggiuntivo> per distribuire e abilitare un componente aggiuntivo cluster non abilitato in precedenza in questo cluster oppure per abilitare un cluster distribuito in precedenza ma attualmente disabilitato.

    5. 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 è disponibile una nuova versione.
      • Scegliere una versione: scegliere questa opzione quando si desidera controllare la versione del componente aggiuntivo distribuito da Oracle nel cluster. Un'avvertenza indica che l'utente è responsabile dell'aggiornamento del componente aggiuntivo. Se si sceglie questa opzione, selezionare la versione del componente aggiuntivo da distribuire nel cluster dalla lista Versione. Vedere Versioni supportate del componente aggiuntivo cluster.
      • Opzione: e Valore: (facoltativo) selezionare Aggiungi configurazione per specificare una o più coppie chiave/valore da passare come argomenti al componente aggiuntivo del cluster. Ad esempio, per il dashboard Kubernetes, è possibile selezionare l'opzione numOfReplicas e specificare un valore 3. Vedere Argomenti di configurazione dei componenti aggiuntivi del cluster.
    6. Selezionare 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.