Nesta página, você encontra uma visão geral do desenvolvimento do Kubernetes no Cloud Code.
Usar o Kubernetes Explorer no Cloud Code
Com o Kubernetes Explorer, é possível acessar informações sobre 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.
![Explorador do Kubernetes do Cloud Code](https://cloud.google.com/static/code/docs/shell/images/shell-dev-cluster-k8s-sections.png?authuser=1&hl=pt-br)
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. Os arquivos Kubeconfig são arquivos YAML que contêm os detalhes do cluster do Kubernetes, o certificado e o 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 visualizar e gerenciar os recursos do Kubernetes, acesse o Kubernetes Explorer clicando emAcessar a seção de 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.
Ações básicas
O explorador do Kubernetes usa a tecnologia do kubectl
. Se você tiver configurado o arquivo de configuração kubectl
para acessar seus clusters, será possível usar o Kubernetes Explorer para adicionar clusters e navegar por todos os namespaces, recursos e nós disponíveis para os clusters, independentemente de estarem no contexto ativo ou inativo.
Seção de clusters
As ações gerais do Kubernetes disponíveis, acessíveis por meio dos ícones na seção Clusters do Kubernetes Explorer, são:
- add Adicione um cluster ao KubeConfig
- refresh Atualizar o Kubernetes Explorer
- question_mark Abrir a documentação do Kubernetes no Cloud Code em um navegador da Web
Seção de sessões de desenvolvimento
As ações do Kubernetes disponíveis, acessíveis por meio dos ícones na seção Sessões de desenvolvimento do Kubernetes, são:
Abrir um aplicativo de amostra do Kubernetes
- play_arrow Execute o aplicativo
Depurar o aplicativo
Copiar um nome de recurso
É possível copiar qualquer nome de recurso do Kubernetes para a área de transferência (incluindo nomes de contêiner e cluster). Para copiar um nome de recurso, clique com o botão direito do mouse nele e escolha Copiar nome do recurso.
![Copiar o nome do recurso usando o menu do botão direito do mouse](https://cloud.google.com/static/code/docs/shell/images/shell-copy-resource-name.png?authuser=1&hl=pt-br)
Atualizar recursos
O Kubernetes Explorer monitora as alterações e é atualizado automaticamente para refletir as atualizações. Para forçar uma atualização de qualquer recurso do Kubernetes a fim de 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 do mouse](https://cloud.google.com/static/code/docs/shell/images/shell-refresh-resource.png?authuser=1&hl=pt-br)
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 do mouse](https://cloud.google.com/static/code/docs/shell/images/shell-describe-resource.png?authuser=1&hl=pt-br)
Personalizar a configuração de inicialização
Para configurar como o aplicativo é executado, personalize o
arquivo skaffold.yaml
.
Ver YAML remoto
Para visualizar o YAML de um recurso no cluster, selecione ou passe o cursor sobre o recurso para mostrar os ícones![](https://cloud.google.com/static/code/docs/vscode/images/vscode-edit-yaml-icon.png?authuser=1&hl=pt-br)
![](https://cloud.google.com/static/code/docs/vscode/images/vscode-view-yaml-icon.png?authuser=1&hl=pt-br)
![YAML de serviço do Kubernetes aberto usando o ícone "Ver YAML"](https://cloud.google.com/static/code/docs/shell/images/shell-view-yaml.png?authuser=1&hl=pt-br)
ver registros
É possível fazer streaming 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 pressionandoCtrl/Cmd+Shift+P
ou clicando em Visualizar > Paleta de comandos e selecione Cloud Code: visualizar registros.
O visualizador de registros é aberto em uma nova guia do editor.
Para conferir os registros de um pod ou contêiner, clique com o botão direito do mouse no recurso e selecione
Ver registros.
Inicie um terminal
Para pods e contêineres, abra um terminal interativo clicando com o botão direito do mouse no pod ou contêiner e selecionando Obter terminal.
![Como abrir um terminal interativo](https://cloud.google.com/static/code/docs/shell/images/shell-get-terminal.png?authuser=1&hl=pt-br)
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 ao Kubeconfig: adicione um cluster atual do GKE ou minikube ou crie um novo.
A caixa de diálogo "Adicionar cluster" é exibida. Escolha o projeto e o cluster que quer usar ou crie um novo cluster.
![Como escolher a plataforma de cluster](https://cloud.google.com/static/code/docs/shell/images/shell-cluster-choose-platform.png?authuser=1&hl=pt-br)
Definir como cluster ativo: defina o cluster especificado como ativo para que o contexto
kubectl
configurado acesse esse cluster por padrão.
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 dos contextos disponíveis para definir como o contexto atual.
Namespaces
Definir como namespace ativo:defina um namespace como ativo para que o contexto
kubectl
configurado acesse esse namespace por padrão.Clique com o botão direito do mouse no namespace que você quer definir como ativo.
Observe que um contexto do Kubernetes é um atalho que oferece acesso rápido
a um namespace no seu cluster. Em geral, os contextos são criados de modo automático quando você inicia um minikube ou um cluster do GKE. Se você não encontrar a opção Definir como contexto atual para um determinado namespace e quiser criar um contexto para ela, 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 um status de integridade](https://cloud.google.com/static/code/docs/vscode/images/vscode-pod-status-green.png?authuser=1&hl=pt-br)
Contêineres
- Ver registros: visualize os registros de um contêiner no console do Kubernetes Explorer.
- Ver terminal:acesse o terminal de um contêiner no console do Kubernetes Explorer.
Implantações
Ver registros: veja 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 de implantação verdes indicando status íntegro](https://cloud.google.com/static/code/docs/vscode/images/vscode-deploy-status-green.png?authuser=1&hl=pt-br)
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](https://cloud.google.com/static/code/docs/vscode/images/vscode-crd-list.png?authuser=1&hl=pt-br)
A seguir
- Comece a usar o Cloud Code para Cloud Shell para Kubernetes criando e implantando um aplicativo do Kubernetes a partir de uma exemplo de código.
- Use a sincronização de arquivos e a recarga automática para acelerar o desenvolvimento.
- Depurar seu aplicativo no Cloud Code