Documentação do Oracle Cloud Infrastructure

Trabalhando com o Kubernetes Metrics Server como um Complemento de Cluster

Descubra como usar o Kubernetes Metrics Server como complemento de cluster em clusters com pools de nós gerenciados que você criou usando o Kubernetes Engine (OKE).

Usar o Kubernetes Metrics Server como um complemento de cluster em vez de como um programa autônomo simplifica a configuração e a manutenção contínua. Você pode, mais simplesmente:

  • Ative ou desative o Kubernetes Metrics Server.
  • Aceite e cancele atualizações automáticas da Oracle.
  • Selecione as versões do complemento do Kubernetes Metrics Server.
  • Gerencie personalizações específicas de complementos usando argumentos de configuração de pares de chave/valor aprovados.

Para usar o Kubernetes Metrics Server como um complemento de cluster, você também precisa implantar o cert-manager. Você pode implantar o cert-manager de duas maneiras:

  • Você pode implantar o cert-manager como um produto independente de código-fonte aberto. Se você implantar o cert-manager como um produto independente, defina o argumento de configuração skipAddonDependenciesCheck como true. Para obter mais informações sobre o cert-manager, consulte a documentação cert-manager.io.
  • Você pode implantar o cert-manager como um complemento de cluster. Para obter mais informações sobre como implantar o cert-manager como um complemento de cluster, consulte Instalando um Complemento de Cluster.

Estas seções descrevem como trabalhar com o complemento do Kubernetes Metrics Server:

Implantando o Kubernetes Metrics Server como um Complemento de Cluster

Descubra como usar o kubectl para implantar o Kubernetes Metrics Server como complemento de cluster em clusters com pools de nós gerenciados que você criou usando o Kubernetes Engine (OKE).

Estas instruções descrevem como implantar o Kubernetes Metrics Server como um complemento de cluster:

Etapa 1: Criar o arquivo de configuração do complemento do Kubernetes Metrics Server

Observação

Estas instruções descrevem como criar um arquivo de configuração do complemento do Kubernetes Metrics Server para permitir que você implante o complemento do Kubernetes Metrics Server usando a CLI. O arquivo de configuração contém argumentos de configuração de par de chave/valor aprovados. Você precisa criar um arquivo de configuração ao implantar o complemento usando a CLI (ou usando a API). Você também pode usar a Console para implantar o complemento do Kubernetes Metrics Server. Nesse caso, você especifica argumentos de configuração na interface do usuário. Para obter mais informações sobre a implantação do complemento do Kubernetes Metrics Server usando a Console, consulte Instalando um Complemento de Cluster.

  1. Em um editor adequado, crie um arquivo JSON com um nome de sua escolha (essas instruções pressupõem que o arquivo seja chamado enablemetrics-server.json) contendo o seguinte:

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

    Este conteúdo é suficiente para ativar o complemento do Kubernetes Metrics Server.

  2. (Opcional) No arquivo enablemetrics-server.json criado, especifique outros argumentos de configuração para personalizar o complemento do Kubernetes Metrics Server. Para obter informações sobre os argumentos de configuração que você pode definir, consulte Kubernetes Metrics Server.

  3. Salvar e fechar o arquivo enablemetrics-server.json.

Etapa 2: Implante o complemento do Kubernetes Metrics Server no cluster e confirme a implantação bem-sucedida

Observação

Estas instruções descrevem como implantar o complemento do Kubernetes Metrics Server em clusters com pools de nós gerenciados, usando a CLI e um arquivo de configuração. Você também pode implantar o complemento usando a Console e a API. Para obter mais informações, consulte Instalando um Complemento de Cluster.

  1. Se você ainda não tiver feito isso, siga as etapas para configurar o arquivo de configuração kubeconfig do cluster e (se necessário) defina a variável de ambiente KUBECONFIG para apontar para o arquivo. Observe que você deve configurar seu próprio arquivo kubeconfig. Não é possível acessar um cluster usando um arquivo kubeconfig que outro usuário tenha configurado. Consulte Configurando o Acesso ao Cluster.
  2. Confirme se o complemento do Kubernetes Metrics Server ainda não foi instalado no cluster digitando:
    oci ce cluster list-addons --cluster-id <cluster-ocid>

    em que <cluster-ocid> corresponde ao OCID do cluster no qual você deseja implantar o complemento do Kubernetes Metrics Server.

  3. Se o usuário do Oracle Cloud Infrastructure for um administrador de tenancy ou de cluster, ignore a próxima etapa e vá direto para a etapa a seguir.
  4. Se o usuário do Oracle Cloud Infrastructure não for administrador de tenancy ou administrador de cluster, peça a um administrador de tenancy ou de cluster para conceder ao usuário a clusterrole cluster-admin do Kubernetes RBAC no cluster digitando:
    
kubectl create clusterrolebinding <my-cluster-admin-binding> --clusterrole=cluster-admin --user=<user-OCID>

    Para obter mais informações, consulte Sobre Controle de Acesso e Kubernetes Engine (OKE).

  5. Implante o complemento do Kubernetes Metrics Server no cluster digitando:

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

    em que:

    • --cluster-id <cluster-ocid> é o OCID do cluster no qual você deseja implantar o complemento do Kubernetes Metrics Server.
    • --from-json file://<path-to-config-file> especifica a localização do arquivo de configuração do complemento do Kubernetes Metrics Server criado anteriormente. Por exemplo, --from-json file://./enablemetrics-server.json

    Por exemplo:

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

    Uma solicitação de serviço é criada para implantar o complemento do Kubernetes Metrics Server.

  6. Confirme se o Kubernetes Metrics Server foi implantado com sucesso e se está disponível digitando:

    kubectl get deployment metrics-server -n kube-system

Atualizando o Complemento do Kubernetes Metrics Server

Observação

Estas instruções descrevem como atualizar o complemento do Kubernetes Metrics Server usando a CLI e um arquivo de configuração. Você também pode atualizar o complemento usando a Console e a API. Para obter mais informações, consulte Atualizando um Complemento de Cluster.

  1. Abra o arquivo de configuração do complemento do Kubernetes Metrics Server em um editor adequado

  2. Adicione, remova ou altere parâmetros de configuração no arquivo de configuração conforme necessário. Para obter informações sobre os parâmetros que você pode definir, consulte Kubernetes Metrics Server.

  3. Atualize o complemento do Kubernetes Metrics Server usando o comando oci ce cluster update-addon digitando:
    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://<path-to-config-file> --cluster-id <cluster-ocid>

    em que:

    • --cluster-id <cluster-ocid> é o OCID do cluster no qual você deseja atualizar o complemento do Kubernetes Metrics Server.
    • --from-json file://<path-to-config-file> especifica o local do arquivo de configuração do complemento do Kubernetes Metrics Server a ser usado ao atualizar o complemento. Por exemplo, --from-json file://./enablemetrics-server.json

    Por exemplo:

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

    Uma solicitação de serviço é criada para atualizar os recursos do Kubernetes exigidos pelo Kubernetes Metrics Server.

  4. Opcional: exiba o status dos pods do Kubernetes Metrics Server para observar o andamento, digitando:
    kubectl get pods -n kube-system | grep metrics-server

Desativando (e Removendo) o Complemento do Kubernetes Metrics Server

Observação

Estas instruções descrevem como desativar e remover o complemento do Kubernetes Metrics Server usando a CLI e um arquivo de configuração. Você também pode atualizar o complemento usando a Console e a API. Para obter mais informações, consulte Desativando (e Removendo) um Complemento de Cluster.

  1. Desative (e opcionalmente remova) o complemento do Kubernetes Metrics Server usando o comando oci ce cluster disable-addon, digitando:

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

    em que:

    • --cluster-id <cluster-ocid> é o OCID do cluster no qual você deseja desativar (e, opcionalmente, remover) o complemento do Kubernetes Metrics Server.
    • --is-remove-existing-add-on <true|false> especifica para remover completamente o complemento do Kubernetes Metrics Server (quando definido como true) ou para não remover o complemento, mas simplesmente desativá-lo e não usá-lo (quando definido como false). Se você desabilitar a extensão, a Oracle não a atualizará mais automaticamente quando novas versões estiverem disponíveis.

    Por exemplo:

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

    Uma solicitação de serviço é criada para desativar (e, opcionalmente, remover) o Kubernetes Metrics Server.

  2. Opcional: exiba o status dos pods do Kubernetes Metrics Server para observar o andamento, digitando:
    kubectl get pods -n kube-system | grep metrics-server