Como usar o Kubernetes Explorer

O painel do Kubernetes Explorer permite que você acesse informações sobre seus clusters, nós, cargas de trabalho e muito mais, diretamente do seu ambiente de desenvolvimento integrado. Também é possível definir um contexto atual, transmitir e visualizar registros, abrir um terminal interativo e visualizar descrições de recursos com o Kubernetes Explorer.

Como acessar o Kubernetes Explorer

Para facilitar o gerenciamento de recursos do Kubernetes, use o Kubernetes Explorer, acessível no painel lateral à direita. Também é possível acessá-lo em Ferramentas > Cloud Code > Kubernetes > Ver explorador de cluster.

Painel do Kubernetes Explorer aberto usando a guia na barra de tarefas do lado direito

Enquanto o Cloud Code usa o arquivo kubeconfig padrão, localizado no diretório "$HOME/.kube", para recuperar recursos do Kubernetes, é possível optar por usar arquivos kubeconfig alternativos. Consulte Como trabalhar com arquivos kubeconfig adicionais para detalhes sobre como gerenciar seus kubeconfigs.

Ações básicas

O Kubernetes Explorer usa a tecnologia kubectl. Desde que você tenha configurado o contexto kubectl para acessar os clusters, use o Kubernetes Explorer para navegar por todos os namespaces, recursos e nós disponíveis para seus clusters, independentemente dos que estão no contexto ativo ou inativo.

As ações gerais disponíveis do Kubernetes Explorer, acessíveis por meio dos respectivos ícones no Explorer, são:

  • Como criar um novo aplicativo do Kubernetes a partir de um exemplo de Novo app Kubernetes em um ícone de amostra
  • Atualizando o Explorador Atualizar ícone do explorador
  • Como abrir a documentação do Kubernetes do Cloud Code em um navegador da Web opencone "Abrir o Documentos"

Como copiar o nome do recurso

É possível copiar qualquer nome de recurso do Kubernetes para a área de transferência (incluindo nomes de contêiner e de cluster). Como copiar um nome de recurso usando o menu do botão direito do mouse

Como atualizar recursos

O Kubernetes Explorer verifica se há alterações e é atualizado automaticamente para refletir as atualizações. Para forçar a atualização de qualquer recurso do Kubernetes e buscar as informações mais recentes, clique com o botão direito no recurso e escolha Atualizar. Atualização de um pod usando o menu de atualização acessível pelo botão direito do mouse

É possível forçar uma atualização de todo o explorador usando o botão de atualização dele.

Botão de atualização do Kubernetes Explorer

Como descrever recursos

Para exibir os detalhes de qualquer recurso que não seja de cluster, escolha Descrever. Isso apresenta informações de recursos no painel do console do Kubernetes Explorer.

Opção "Descrever" disponível ao clicar com o botão direito do mouse em um recurso apropriado no painel do Kubernetes Explorer

Para visualizar os detalhes, você também pode clicar em qualquer recurso. Caso ele tenha metadados anexados, eles estarão disponíveis no painel "Detalhes do recurso" no Kubernetes Explorer.

Visualização de metadados de recursos no painel "Detalhes do recurso", disponível na segunda metade do Kubernetes Explorer

Como visualizar YAML remoto

É possível visualizar o YAML de um recurso no cluster diretamente pelo Kubernetes Explorer. Navegue até um recurso no Kubernetes Explorer, como um pod, clique com o botão direito no nome do recurso e selecione View Remote YAML.

Isso abre o arquivo YAML correspondente ao recurso especificado em uma nova guia do editor.

Visualização do YAML de um pod ao clicar com o botão direito do mouse no rótulo dele no Kubernetes Explorer e selecionando "Visualizar YAML remoto"

Streaming de registros

Para pods, contêineres, implantações, serviços e conjuntos de réplicas, é possível fazer streaming e visualizar registros desses recursos no console do Kubernetes Explorer para monitorar o progresso.

Streaming de registros de um pod usando o menu do botão direito do mouse para gerar registros no Console do Kubernetes Explorer

Como iniciar um terminal

Para pods e contêineres, é possível abrir um terminal interativo.

Como usar o menu de clique com o botão direito em um pod para acessar um terminal interativo no Console do Kubernetes Explorer

Ações específicas de recursos

O Kubernetes Explorer exibe clusters, namespaces, nós, cargas de trabalho (como implantações, réplicas, pods e contêineres), serviços e entradas, configurações (como secrets e mapas de configuração) e armazenamento (como volumes). Com o Kubernetes Explorer, é possível executar ações exclusivas em alguns desses recursos.

Clusters

  • Adicione um cluster do Google Kubernetes Engine: Adicione um cluster padrão ou do Autopilot do GKE ou crie um novo clicando no Adicionar cluster do GKE botãoAdicionar ícone de adição do cluster dentro do Kubernetes Explorer.

    Isso exibe a caixa de diálogo "Adicionar cluster do GKE", em que é possível escolher o projeto e o cluster que você quer usar. Também é possível criar um novo cluster e retornar a essa caixa de diálogo.

    Depois disso, clique em OK e acesse o cluster escolhido e os recursos subjacentes por meio do Kubernetes Explorer.

    Como adicionar um cluster do GKE com a caixa de diálogo do Kubernetes Explorer, com campos para nomes de projeto e de cluster

  • Definir como contexto atual: defina o cluster especificado como ativo para que o contexto kubectl configurado acesse esse cluster por padrão.

    Como definir um cluster como o contexto atual com o Kubernetes Explorer

    Se essa ação for bem-sucedida, o explorador será atualizado automaticamente e você verá o símbolo do Kubernetes ao lado do cluster apropriado.

    Além disso, se um cluster tiver vários contextos configurados, você poderá escolher um dos contextos disponíveis para definir como o contexto atual.

    Como escolher e configurar um cluster ativo em uma lista de vários contextos com o Kubernetes Explorer

Namespaces

  • Definir como contexto atual: defina um namespace como ativo para que o contexto kubectl configurado acesse esse namespace por padrão.

    Como definir um namespace como atual usando o menu do botão direito do mouse

    Se a ação for bem-sucedida, o explorador será atualizado automaticamente e você verá um asterisco ao lado do namespace para indicar que ele faz parte do contexto atual.

    Observe que um contexto do Kubernetes é um atalho que fornece acesso rápido a um namespace no cluster. Normalmente, os contextos são criados automaticamente quando você inicia um cluster do minikube ou do GKE. Se a opção Definir como contexto atual não for exibida para um determinado namespace e você quiser criar um contexto para ela, use o kubectl config set-context no seu terminal para definir um contexto com o cluster, o usuário e o namespace de sua preferência.

Pods

  • Registros de stream: faz streaming de registros de um pod para o Console do Kubernetes Explorer.
  • Obter terminal: receba um terminal para um pod no Console do Kubernetes Explorer.

    Além disso, os pods em execução têm marcas de status coloridas ao lado dos rótulos:

    • Vermelho: o pod está em estado de falha
    • Amarelo: o pod está sendo iniciado ou encerrado.
    • Verde: o pod está normal e em execução

    O status do pod é normal, conforme observado pela marca de seleção verde ao lado do rótulo do pod.

Contêineres

Implantações

  • Registros de stream: registros de stream de uma implantação no console do Kubernetes Explorer.

    As implantações ativas têm marcas de status coloridas ao lado dos rótulos e contagens de réplicas atuais/totais:

    • Amarelo: a implantação não tem disponibilidade mínima nem problemas de imagem;
    • Verde: a implantação está normal e tem disponibilidade mínima.

    O status da implantação está normal, conforme observado pela marca de seleção verde ao lado do rótulo da implantação

Nós

Os nós do cluster têm marcas de status coloridas ao lado dos nomes:

  • Amarelo: o nó apresenta um problema de recurso, como disponibilidade de memória ou disco;
  • Verde: o nó está normal.

Definições de recursos personalizados (CRDs)

O Kubernetes Explorer lista todas as definições de recursos personalizados (CRDs, na sigla em inglês) instaladas e disponíveis no cluster:

Lista de definições de recursos personalizados no explorador

Como receber suporte

Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Tools > Cloud Code > Ajuda / Sobre > Envie feedback ou relate um problema no GitHub ou faça uma pergunta no Stack Overflow.

Você também pode participar do canal #cloud-code, que faz parte da comunidade do Google Cloud no Slack.