Documentação do Oracle Cloud Infrastructure

Instalando um Complemento de Cluster

Descubra como instalar um complemento de cluster usando o Kubernetes Engine (OKE).

Você pode instalar um complemento de cluster ao criar um novo cluster ou para um cluster existente.

Para instruções específicas de instalação:

Para obter mais informações sobre complementos de cluster, consulte Configurando Complementos de Cluster.

  • Implantar e Configurar um Complemento de Cluster ao Criar um Cluster

    1. Siga as instruções em Usando a Console para criar um Cluster com Definições Configuradas Explicitamente no workflow 'Criação Personalizada' para criar um cluster.
    2. Exiba a seção Configurar complementos de cluster da página Criar Cluster para exibir os complementos de cluster ativados e disponíveis.

      Por padrão, ao criar um novo cluster:

      • Complementos essenciais do cluster (como CoreDNS e kube-proxy) são mostrados como ativados e atualizados automaticamente.
      • Os complementos opcionais do cluster (como Painel de Controle do Kubernetes) são mostrados como desativados.

      Observe que você escolhe o plug-in CNI para rede de pods na página Configuração da rede; portanto, o plug-in CNI não é mostrado na seção Configurar complementos de cluster ao criar um cluster.

    3. Selecione o nome do complemento que você deseja implantar e configurar.

    4. Selecione a opção Ativar <nome do add-on> para implantar e ativar o add-on do cluster ao criar o cluster.

      Observe que você não pode desativar complementos essenciais ao criar um cluster.

    5. Configure o complemento do cluster especificando os seguintes detalhes:
      • Atualizações automáticas: Selecione esta opção quando quiser que a Oracle atualize automaticamente o complemento quando uma nova versão estiver disponível.
      • Escolher uma versão: Selecione essa opção quando quiser controlar a versão do complemento que o sistema Oracle implanta no cluster. Um aviso indica que você assumiu a responsabilidade por atualizar a extensão. Se você escolher essa opção, selecione a versão do complemento a ser implantada no cluster na lista Versão. Consulte Versões Suportadas por Complemento de Cluster.
      • Opção: e Valor: (Opcional) Especifique um ou mais pares de chave/valor a serem passados como argumentos para o complemento do cluster. Por exemplo, para o Painel de Controle do Kubernetes, você pode selecionar a opção numOfReplicas e especificar um valor de 3. Consulte Argumentos de Configuração de Complemento de Cluster.

    Implantar e Configurar um Complemento de Cluster para um Cluster Aprimorado Existente

    1. Abra o menu de navegação e selecione Serviços ao Desenvolvedor. Em Contêineres e Artefatos, selecione Clusters do Kubernetes (OKE).
    2. Selecione o compartimento que contém o cluster.
    3. Na página Clusters, selecione o nome do cluster que você deseja modificar.
    4. Em Recursos, selecione Complementos.
    5. Selecione Gerenciar complementos e, em seguida, selecione o complemento de cluster que você deseja implantar e configurar.

    6. Selecione a opção Ativar <nome do add-on> para implantar e ativar um add-on de cluster que não foi ativado neste cluster antes ou para ativar um cluster que foi implantado anteriormente, mas está desativado no momento.

    7. Configure o complemento do cluster especificando os seguintes detalhes:
      • Atualizações automáticas: Escolha essa opção quando quiser que a Oracle atualize automaticamente o complemento quando uma nova versão estiver disponível.
      • Escolher uma versão: Escolha essa opção quando quiser controlar a versão do complemento que o sistema Oracle implanta no cluster. Um aviso indica que você assumiu a responsabilidade por atualizar a extensão. Se você escolher essa opção, selecione a versão do complemento a ser implantada no cluster na lista Versão. Consulte Versões Suportadas por Complemento de Cluster.
      • Opção: e Valor: (Opcional) Especifique um ou mais pares de chave/valor a serem passados como argumentos para o complemento do cluster. Por exemplo, para o Painel de Controle do Kubernetes, você pode selecionar a opção numOfReplicas e especificar um valor de 3. Consulte Argumentos de Configuração de Complemento de Cluster.
    8. Selecione Salvar alterações.

  • Use o comando oci ce cluster install-addon e os parâmetros necessários para implantar um complemento de cluster:

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

    Por exemplo:

    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
    Você usa o parâmetro --configurations para especificar um ou mais pares de chave/valor a serem especificados como argumentos para o complemento do cluster, no formato JSON. Você precisa fazer escape das aspas duplas dentro do JSON usando uma única barra invertida. Por exemplo:
    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\"}]"

    Observe que, se o próprio valor de uma chave for necessário no formato JSON, você precisará fazer escape das aspas duplas dentro do JSON aninhado usando três barras invertidas. Por exemplo:

    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\\\"}]\"}]"

    Para tornar o parâmetro --configurations menos pesado, coloque pares de chave/valor entre aspas simples (em vez de aspas duplas). Quando você coloca aspas simples no par chave/valor, não é necessário fazer escape das aspas duplas no JSON com uma única barra invertida. E se o próprio valor de uma chave contiver JSON, você só precisará fazer escape das aspas duplas no JSON aninhado com uma única barra invertida (em vez de três barras invertidas). Por exemplo:

    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\"}]"}]'

  • Execute a operação InstallAddon para instalar um complemento de cluster.