Visão geral do Kubernetes no Cloud Code para Cloud Shell

Nesta página, você terá uma visão geral do desenvolvimento do Kubernetes no Cloud Code.

Usar o Kubernetes Explorer no Cloud Code

O Kubernetes Explorer permite acessar 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, fazer streaming e visualizar registros, abrir um terminal interativo e pesquisar descrições de recursos com o Kubernetes Explorer.

Pesquisador do Kubernetes no Cloud Code

O Cloud Code usa o arquivo kubeconfig padrão, localizado no diretório $HOME/.kube no MacOS/Linux ou %USERPROFILE%\.kube no Windows, para recuperar recursos do Kubernetes. É possível alternar ou adicionar novos arquivos Kubeconfig no Kubernetes Explorer. Kubeconfig são arquivos YAML que contêm detalhes do cluster do Kubernetes, certificado e token secreto para autenticação no cluster.

Para usar um arquivo kubeconfig diferente do kubeconfig padrão, consulte o guia Trabalhar com arquivos kubeconfig.

Acessar o Kubernetes Explorer

Para conferir e gerenciar os recursos do Kubernetes, acesse o Kubernetes Explorer clicando em Cloud Code e expandindo a seção do Kubernetes. Para conferir as sessões de depuração ou criar um app de exemplo, expanda a seção Sessões de desenvolvimento.

Acessar a seção Sessões de desenvolvimento

Use as sessões de desenvolvimento para executar ou depurar seu aplicativo do Kubernetes ou criar um aplicativo de amostra usando um modelo.

Quando você inicia uma sessão de desenvolvimento ou depuração, a seção Sessões de desenvolvimento exibe a visualização de geração de registros estruturada.

Painel de sessões de desenvolvimento

Para acessar as sessões de desenvolvimento, clique em Cloud Code e expanda a seção Sessões de desenvolvimento.

Ações básicas

O Kubernetes Explorer usa a tecnologia do kubectl. Se você tiver configurado o arquivo de configuração kubectl para acessar os clusters, será possível usar o explorador do Kubernetes para adicionar clusters e procurar todos os namespaces, recursos e nós disponíveis para os clusters, independentemente de estarem no contexto ativo ou inativo.

Seção "Clusters"

As ações gerais do Kubernetes disponíveis, que podem ser acessadas por meio dos ícones na seção Clusters do Kubernetes Explorer, são:

  • adicionar Adicionar um cluster ao KubeConfig
  • atualizar Atualizar o explorador do Kubernetes
  • question_mark Abra a documentação do Kubernetes do Cloud Code em um navegador da Web

Seção de sessões de desenvolvimento

As ações disponíveis do Kubernetes, que podem ser acessadas por meio dos ícones na seção Sessões de desenvolvimento do Kubernetes, são:

  • Ícone de amostra para abrir o Kubernetes Abra um aplicativo de amostra do Kubernetes
  • play_arrow Executar o aplicativo
  • Ícone de depuração Depurar o app

Copiar o nome de um recurso

Qualquer nome de recurso do Kubernetes pode ser copiado para a área de transferência, incluindo nomes de contêiner e cluster. Para copiar o nome de um recurso, clique com o botão direito nele e escolha Copy resource name.

Copiar o nome do recurso usando o menu do botão direito do mouse

Atualizar recursos

O explorador do Kubernetes detecta alterações e faz a atualização automaticamente para refletir as atualizações. Para forçar a atualização de qualquer recurso do Kubernetes para buscar as informações mais recentes, clique com o botão direito do mouse no recurso e escolha Atualizar.

Atualizar pods usando o menu do botão direito

Também é possível forçar uma atualização de toda a seção Clusters do Explorer do Kubernetes usando o botão de atualização da seção Clusters.

Botão de atualização da seção de clusters

Descrever recursos

Para exibir os detalhes de qualquer recurso que não seja de cluster, clique com o botão direito do mouse no recurso e selecione Descrever. Um terminal é aberto e exibe as informações do recurso. Descreva os detalhes do recurso no menu do botão direito

Personalizar a configuração de inicialização

Para configurar como o aplicativo é executado, personalize o arquivo skaffold.yaml.

Acessar YAML remoto

Para visualizar o YAML de um recurso no cluster, selecione ou passe o cursor sobre o recurso para mostrar os ícones Editar YAML e Ver YAML. Selecione o botão Ver YAML para abrir o arquivo YAML correspondente ao recurso especificado em uma nova guia do editor.

YAML de serviço do Kubernetes aberto usando o ícone "Ver YAML"

Mostrar registros

Você pode transmitir e visualizar registros dos recursos do Kubernetes no console do Kubernetes Explorer para monitorar o progresso.

Para abrir o visualizador de registros, abra a paleta de comandos pressionando Ctrl/Cmd+Shift+P ou clicando em Visualizar > Paleta de comandos e selecione Cloud Code: visualizar registros.

Caixa de diálogo "Ver registros" na paleta de comandos

O visualizador de registros é aberto em uma nova guia do editor.

Visualizador de registros Para conferir os registros de um pod ou contêiner, clique com o botão direito do mouse no recurso e selecione Ver registros.

Como visualizar registros de um pod

Inicie um terminal

Para pods e contêineres, clique com o botão direito do mouse no pod ou contêiner e selecione Receber terminal para abrir um terminal interativo.

Como abrir um terminal interativo

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

  • Adicionar um cluster ao Kubeconfig: adicione um cluster atual do GKE ou do minikube ou crie um novo.

A caixa de diálogo "Adicionar cluster" é exibida. Nela, é possível escolher o projeto e o cluster que você quer usar ou criar um novo.

Como escolher a plataforma de clusters

Crie ou escolha um cluster do GKE

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

    Definir o cluster como ativo usando o menu do botão direito do mouse

O Kubernetes Explorer é atualizado automaticamente, e você verá o símbolo do Kubernetes ao lado do cluster apropriado.

Se um cluster tiver vários contextos configurados, você poderá escolher um deles para definir como o contexto atual.

Namespaces

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

    Clique com o botão direito do mouse no namespace que você quer definir como ativo.

    Definir namespace como o contexto atual usando o menu do botão direito

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

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 minikube ou um cluster 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 ele, use o comando kubectl config set-context no terminal para definir um contexto com seu cluster, usuário e namespace preferidos.

Pods

  • Ver registros: visualize os registros de um pod no 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 terão 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
Marca de seleção verde ao lado do pod indicando status de integridade

Contêineres

Implantações

  • Visualizar registros: visualize os registros 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.
Ícones verdes de implantação indicando o status de integridade

Nós

Os nós do cluster terão 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 Explorer

A seguir