Instalando um Complemento de Cluster

• Console
• CLI
• API

• 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 add-ons do cluster da página Criar Cluster para exibir os add-ons do 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 pod 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. Clique no nome da extensão que deseja implantar e configurar.

  4. Selecione a opção Ativar <add-on name> para implantar e ativar o complemento 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 for disponibilizada.
     • Escolher uma versão: Selecione essa opção quando quiser controlar a versão do complemento que a Oracle implanta no cluster. Um aviso indica que você assumiu a responsabilidade pela atualização da extensão. Se você escolher essa opção, selecione na lista Versão a versão do complemento a ser implantado no cluster. Consulte Versões Suportadas de Complemento do 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 clique em Serviços ao Desenvolvedor. Em Contêineres e Artefatos, clique em Clusters do Kubernetes (OKE).
  2. Selecione o compartimento que contém o cluster.
  3. Na página Clusters, clique no nome do cluster que você deseja modificar.
  4. Em Recursos, clique em Extensões.
  5. Clique em Gerenciar complementos e, em seguida, clique no complemento de cluster que você deseja implantar e configurar.

  6. Selecione a opção Ativar <add-on name> para implantar e ativar um complemento de cluster que não tenha sido ativado neste cluster antes ou para ativar um cluster que tenha sido implantado anteriormente, mas que esteja 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 for disponibilizada.
     • Escolher uma versão: Escolha essa opção quando quiser controlar a versão do complemento que a Oracle implanta no cluster. Um aviso indica que você assumiu a responsabilidade pela atualização da extensão. Se você escolher essa opção, selecione na lista Versão a versão do complemento a ser implantado no cluster. Consulte Versões Suportadas de Complemento do 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. Clique em 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.