Documentazione di Oracle Cloud Infrastructure

Utilizzo del server delle metriche Kubernetes come componente aggiuntivo cluster

Scopri come utilizzare il server delle metriche Kubernetes come componente aggiuntivo cluster su cluster con pool di nodi gestiti creati utilizzando OKE (Kubernetes Engine).

L'utilizzo del server delle metriche Kubernetes come componente aggiuntivo cluster anziché come programma standalone semplifica la configurazione e la manutenzione continua. Puoi più semplicemente:

  • Abilita o disabilita il server delle metriche Kubernetes.
  • Esegui l'opt-in e l'out degli aggiornamenti automatici da parte di Oracle.
  • Selezionare le versioni dei componenti aggiuntivi del server delle metriche Kubernetes.
  • Gestisci personalizzazioni specifiche del componente aggiuntivo utilizzando argomenti di configurazione approvati per coppie chiave-valore.

Per utilizzare il server delle metriche Kubernetes come componente aggiuntivo del cluster, è inoltre necessario distribuire cert-manager. È possibile distribuire cert-manager in due modi:

  • È possibile distribuire cert-manager come prodotto standalone open source. Se si distribuisce cert-manager come prodotto standalone, impostare l'argomento di configurazione skipAddonDependenciesCheck su true. Per ulteriori informazioni su cert-manager, consultare la documentazione di cert-manager.io.
  • È possibile distribuire cert-manager come componente aggiuntivo del cluster. Per ulteriori informazioni sulla distribuzione di cert-manager come componente aggiuntivo del cluster, vedere Installazione di un componente aggiuntivo del cluster.

In queste sezioni viene descritto come utilizzare il componente aggiuntivo Kubernetes Metrics Server:

Distribuzione del server delle metriche Kubernetes come componente aggiuntivo cluster

Scopri come utilizzare kubectl per distribuire il server delle metriche Kubernetes come componente aggiuntivo cluster su cluster con pool di nodi gestiti creati utilizzando OKE (Kubernetes Engine).

Le istruzioni riportate di seguito descrivono come distribuire il server delle metriche Kubernetes come componente aggiuntivo cluster.

Passo 1: creare il file di configurazione dei componenti aggiuntivi del server delle metriche Kubernetes

Nota

Queste istruzioni descrivono come creare un file di configurazione dei componenti aggiuntivi del server delle metriche Kubernetes per consentire la distribuzione del componente aggiuntivo del server delle metriche Kubernetes mediante l'interfaccia CLI. Il file di configurazione contiene argomenti di configurazione della coppia chiave/valore approvati. È necessario creare un file di configurazione quando si distribuisce il componente aggiuntivo utilizzando l'interfaccia CLI (o l'API). È inoltre possibile utilizzare la console per distribuire il componente aggiuntivo del server delle metriche Kubernetes, nel qual caso gli argomenti di configurazione vengono specificati nell'interfaccia utente. Per ulteriori informazioni sulla distribuzione del componente aggiuntivo Kubernetes Metrics Server mediante la console, vedere Installazione di un componente aggiuntivo cluster.

  1. In un editor appropriato, creare un file JSON con il nome desiderato (queste istruzioni presuppongono che il file sia denominato enablemetrics-server.json) contenente quanto segue:

    {
  "addonName": "KubernetesMetricsServer",
  "configurations": [
  ]
}

    Questo contenuto è sufficiente per abilitare il componente aggiuntivo del server delle metriche Kubernetes.

  2. (Facoltativo) Nel file enablemetrics-server.json creato, specificare altri argomenti di configurazione per personalizzare il componente aggiuntivo del server delle metriche Kubernetes. Per informazioni sugli argomenti di configurazione che è possibile impostare, vedere Argomenti di configurazione dei componenti aggiuntivi del server delle metriche Kubernetes.

  3. Salvare e chiudere il file enablemetrics-server.json.

Passo 2: distribuire l'add-on del server delle metriche Kubernetes nel cluster e confermare la distribuzione riuscita

Nota

Queste istruzioni descrivono come distribuire il componente aggiuntivo Kubernetes Metrics Server su cluster con pool di nodi gestiti, utilizzando l'interfaccia CLI e un file di configurazione. Puoi anche distribuire il componente aggiuntivo utilizzando la console e l'API. Per ulteriori informazioni, vedere Installazione di un componente aggiuntivo cluster.

  1. Se non è già stato fatto, attenersi alla procedura per impostare il file di configurazione kubeconfig del cluster e (se necessario) impostare la variabile di ambiente KUBECONFIG in modo che punti al file. Si noti che è necessario impostare il proprio file kubeconfig. Non è possibile accedere a un cluster utilizzando un file kubeconfig impostato da un altro utente. Vedere Impostazione dell'accesso al cluster.
  2. Verificare che l'add-on del server delle metriche Kubernetes non sia già stato installato nel cluster immettendo:
    oci ce cluster list-addons --cluster-id <cluster-ocid>

    dove <cluster-ocid> è l'OCID del cluster in cui si desidera distribuire il componente aggiuntivo del server delle metriche Kubernetes.

  3. Se l'utente di Oracle Cloud Infrastructure è un amministratore della tenancy o un amministratore del cluster, saltare il passo successivo e andare direttamente al passo seguente.
  4. Se l'utente di Oracle Cloud Infrastructure non è un amministratore della tenancy o un amministratore del cluster, chiedere a un amministratore della tenancy o a un amministratore del cluster di concedere all'utente il ruolo cluster di amministratore del cluster RBAC Kubernetes nel cluster immettendo:
    
kubectl create clusterrolebinding <my-cluster-admin-binding> --clusterrole=cluster-admin --user=<user-OCID>

    Per ulteriori informazioni, vedere Informazioni sul controllo dell'accesso e sul motore Kubernetes (OKE).

  5. Distribuire il componente aggiuntivo del server delle metriche Kubernetes nel cluster immettendo:

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --from-json file://./<path-to-config-file>

    Dove:

    • --cluster-id <cluster-ocid> è l'OCID del cluster in cui si desidera distribuire il componente aggiuntivo del server delle metriche Kubernetes.
    • --from-json file://<path-to-config-file> specifica la posizione del file di configurazione dei componenti aggiuntivi del server delle metriche Kubernetes creato in precedenza. Ad esempio, --from-json file://./enablemetrics-server.json

    Ad esempio:

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Viene creata una richiesta di lavoro per distribuire il componente aggiuntivo del server delle metriche Kubernetes.

  6. Verificare che il server delle metriche Kubernetes sia stato distribuito correttamente ed è disponibile immettendo:

    kubectl get deployment metrics-server -n kube-system

Aggiornamento del componente aggiuntivo Kubernetes Metrics Server

Nota

Queste istruzioni descrivono come aggiornare il componente aggiuntivo del server delle metriche Kubernetes utilizzando l'interfaccia CLI e un file di configurazione. Puoi anche aggiornare il componente aggiuntivo utilizzando la console e l'API. Per ulteriori informazioni, vedere Aggiornamento di un componente aggiuntivo cluster.

  1. Aprire il file di configurazione dei componenti aggiuntivi del server delle metriche Kubernetes in un editor appropriato

  2. Aggiungere, rimuovere o modificare i parametri di configurazione nel file di configurazione in base alle esigenze. Per informazioni sui parametri che è possibile impostare, vedere Argomenti di configurazione dei componenti aggiuntivi del server delle metriche Kubernetes.

  3. Aggiornare il componente aggiuntivo del server delle metriche Kubernetes utilizzando il comando oci ce cluster update-addon immettendo:
    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://<path-to-config-file> --cluster-id <cluster-ocid>

    Dove:

    • --cluster-id <cluster-ocid> è l'OCID del cluster in cui si desidera aggiornare il componente aggiuntivo del server delle metriche Kubernetes.
    • --from-json file://<path-to-config-file> specifica la posizione del file di configurazione dei componenti aggiuntivi del server delle metriche Kubernetes da utilizzare durante l'aggiornamento del componente aggiuntivo. Ad esempio, --from-json file://./enablemetrics-server.json

    Ad esempio:

    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Viene creata una richiesta di lavoro per aggiornare le risorse Kubernetes richieste dal server delle metriche Kubernetes.

  4. Facoltativo: visualizzare lo stato dei pod del server delle metriche Kubernetes per osservare l'avanzamento immettendo:
    kubectl get pods -n kube-system | grep metrics-server

Disabilitazione (e rimozione) del componente aggiuntivo del server delle metriche Kubernetes

Nota

Queste istruzioni descrivono come disabilitare e rimuovere il componente aggiuntivo del server delle metriche Kubernetes utilizzando l'interfaccia CLI e un file di configurazione. Puoi anche aggiornare il componente aggiuntivo utilizzando la console e l'API. Per ulteriori informazioni, vedere Disabilitazione (e rimozione) di un componente aggiuntivo del cluster.

  1. Disabilitare (e facoltativamente rimuovere) il componente aggiuntivo del server delle metriche Kubernetes utilizzando il comando oci ce cluster disable-addon, immettendo:

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --is-remove-existing-add-on <true|false>

    Dove:

    • --cluster-id <cluster-ocid> è l'OCID del cluster in cui si desidera disabilitare (e facoltativamente rimuovere) il componente aggiuntivo del server delle metriche Kubernetes.
    • --is-remove-existing-add-on <true|false> specifica di rimuovere completamente il componente aggiuntivo del server delle metriche Kubernetes (se impostato su true) o di non rimuovere il componente aggiuntivo, ma semplicemente di disabilitarlo e di non utilizzarlo (se impostato su false). Se disabiliti il componente aggiuntivo, Oracle non lo aggiorna più automaticamente quando diventano disponibili nuove versioni.

    Ad esempio:

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr --is-remove-existing-add-on true

    Viene creata una richiesta di lavoro per disabilitare (e facoltativamente rimuovere) il server delle metriche Kubernetes.

  2. Facoltativo: visualizzare lo stato dei pod del server delle metriche Kubernetes per osservare l'avanzamento immettendo:
    kubectl get pods -n kube-system | grep metrics-server