Incluindo serviços usando complementos gerenciados

Os complementos gerenciados do IBM Cloud Kubernetes Service são uma maneira fácil de aprimorar seu cluster com recursos extras. A versão do driver, do plug-in ou da ferramenta de software livre incluída em seu cluster é testada pela IBM e aprovada para ser usada no IBM Cloud Kubernetes Service.

Os complementos gerenciados que podem ser instalados em seu cluster dependem do tipo do cluster, da plataforma de contêiner e do provedor de infraestrutura escolhidos.

Suporte

Os complementos gerenciados são totalmente integrados na organização de suporte do IBM Cloud. Se tiver uma pergunta ou um problema com o uso dos complementos gerenciados, será possível usar um dos canais de suporte do IBM Cloud Kubernetes Service. Para obter mais informações, consulte Obtendo ajuda e suporte.

faturamento

Se a ferramenta incluída em seu cluster incorrer em custos, eles serão integrados automaticamente e listados como parte de seu faturamento do IBM Cloud Kubernetes Service. O ciclo de faturamento é determinado pelo IBM Cloud, dependendo de quando você ativou o complemento em seu cluster.

Em geral, não é necessário fazer nenhuma configuração adicional, como endereços IP ou abrir portas. No entanto, consulte a documentação de cada complemento gerenciado para localizar os pré-requisitos que o cluster deve encontrar antes de instalar o complemento gerenciado.

Incluindo complementos gerenciados

Para ativar um complemento gerenciado em seu cluster a partir da CLI, use o comando ibmcloud ks cluster addon enable. Para habilitar um complemento gerenciado no seu cluster no console, use o painel “Complementos” da página de detalhes do cluster. Ao ativar o complemento gerenciado, uma versão compatível da ferramenta, incluindo todos os recursos do Kubernetes, é instalada automaticamente no seu cluster.

Para obter mais informações sobre os pré-requisitos de cada complemento, consulte:

Atualizando complementos gerenciados

As versões de cada complemento gerenciado são testadas pelo IBM Cloud e aprovadas para uso no IBM Cloud Kubernetes Service. Para atualizar os componentes de um complemento para a versão mais recente compatível com o IBM Cloud Kubernetes Service, utilize os links a seguir.

Revise os links a seguir para etapas de atualização específicas para cada complemento.

Revisando estados e status de complemento

É possível verificar o estado de funcionamento e o status de um complemento de cluster executando o comando a seguir.

ibmcloud ks cluster addon ls -c CLUSTER_NAME_OR_ID

Saída de exemplo

Name            Version   Health State   Health Status
debug-tool      2.0.0     normal         Addon Ready
istio           1.4       -              Enabling

O Estado de funcionamento reflete o ciclo de vida dos componentes de complemento. Cada estado é descrito na tabela a seguir.

Estados de funcionamento de complemento
Estado de funcionamento de complemento Descrição
critical

O complemento não está pronto para ser usado por um dos seguintes motivos:

  • Alguns ou todos os componentes do complemento estão com problemas.
  • A implantação do complemento falhou.
  • O complemento pode estar em uma versão não suportada.
  • Verifique o campo “Status de integridade ” para obter mais informações.
normal O complemento é implementado com sucesso. Confira o status para verificar se o complemento está Ready ou para ver se uma atualização está disponível.
pending Alguns ou todos os componentes do complemento estão sendo implementados atualmente. Aguarde que o estado se torne normal antes de trabalhar com seu complemento.
updating O complemento está sendo atualizado e não está pronto para ser usado. Verifique o campo Status de funcionamento para a versão para a qual o complemento está sendo atualizado.
warning O complemento pode não funcionar corretamente devido a limitações de cluster. Verifique o campo Status de funcionamento para obter mais informações.

O Status de funcionamento fornece detalhes sobre qual operação de complemento está em andamento. Cada status é descrito na tabela a seguir.

Status de funcionamento de complemento
Código de status Status de funcionamento do complemento Descrição
H1500 Addon Ready O complemento é implementado com sucesso e está funcionando.
H1501, H1502, H1503 Addon Not Ready

Alguns ou todos os componentes do complemento estão fora de funcionamento. Verifique se todos os pods de componentes de add-on estão em execução.

  • Por exemplo, para o add-on Istio, verifique se os pods nos namespaces istio-system e ibm-operators estão em um estado Running executando o comando kubectl get pods -n NAMESPACE.
H1504, H1505, H1506, H1507, H1508 Failure determining health status. O funcionamento do complemento não pode ser determinado. Abra um caso de suporte. Na descrição, inclua o código de erro do status de funcionamento.
H1509 Addon Unsupported O complemento executa uma versão não suportada ou a versão do complemento não é suportada para a sua versão do cluster. Atualize seu complemento para a versão mais recente ou consulte etapas específicas de atualização para o Istio.
H1510 Cluster resources low, not enough workers in Ready state.

O complemento não está pronto para ser usado por uma das razões a seguir:
Enabling O complemento está sendo implementado atualmente no cluster. Observe que o complemento pode levar até 15 minutos para instalar.
H1512 Addon daemonset might not be available on all Ready nodes.

Para o complemento de rota estática: o operador de rota estática DaemonSet não está disponível em nenhum dos nós do trabalhador, o que o impede a aplicação de recursos de rota estática. Os nós do trabalhador não podem executar o operador de rota estática DaemonSet pelas razões a seguir:

Ainda tendo problemas com o Istio add-on? Confira esses tópicos de resolução de problemas para depurar a sua implementação do Istio.