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.
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 ver e gerenciar os recursos do Kubernetes, use o Kubernetes Explorer, que pode ser acessado no painel lateral à direita. Também é possível acessá-lo em Ferramentas > Cloud Code > Kubernetes > Visualizar Cluster Explorer.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 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.
As ações gerais do Kubernetes disponíveis, que podem ser acessadas por meio dos ícones no Kubernetes Explorer, são:
- Criar um novo aplicativo do Kubernetes com base em uma amostra
- Atualizar o Explorador
- Abra a documentação do Kubernetes do Cloud Code em um navegador da Web
Outras ações comuns de depuração do Kubernetes, que podem ser acessadas por meio dos ícones no Kubernetes Explorer, são:
- Executa a configuração atual de execução/depuração.
- Inicia a configuração de execução no modo de depuração.
- Interrompe uma sessão de depuração ativa.
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.
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.
Também é possível forçar a atualização de todo o Kubernetes Explorer usando o botão de atualização do Kubernetes Explorer.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. As informações sobre os recursos são apresentadas no painel do console do Kubernetes Explorer.Para visualizar os detalhes do recurso, também é possível clicar em qualquer recurso. Caso tenha anexado metadados, os metadados estarão disponíveis no painel "Detalhes do recurso" no Kubernetes Explorer.
Opções do Skaffold
- Configuração do Skaffold: seleciona um arquivo de configuração
skaffold.yaml
. Será detectado automaticamente se você tiver umskaffold.yaml
no projeto. - Perfil de implantação: seleciona um perfil
das opções disponíveis configuradas no arquivo
skaffold.yaml
. - Variáveis de ambiente: permite configurar variáveis de ambiente extras para serem transmitidas ao processo de implantação do Skaffold. As sinalizações do Skaffold também podem ser configuradas como variáveis de ambiente a serem usadas nesse campo. Consulte a documentação de referência da CLI do Skaffold para uma lista abrangente de variáveis de ambiente disponíveis do Skaffold.
- Nível de detalhes: permite definir o nível de detalhamento da saída como
trace
,debug
,info
,warn
,error
oufatal
. O nível de detalhes padrão éwarn
.
Opções do Kubernetes
Contexto de implantação: representa o contexto do Kubernetes em que o aplicativo foi implantado. O comportamento padrão, se um contexto de implantação não for especificado, será implantado no contexto atual do sistema, se houver.
Se preferir não implantar no contexto atual, na seção "Implantação" das configurações de execução/depuração, você pode optar por:
- Implantar localmente em um cluster do minikube: inicia um cluster do minikube gerenciado pelo Cloud Code para executar o app e interrompe o cluster após a interrupção da implantação. Se um cluster do minikube já estiver em execução, o Cloud Code usará o cluster atual para implantação.
Mudar o contexto e implantar para: altera o contexto atual no sistema para o contexto especificado na implantação.
Delete deployments when finished: exclui as implantações do Kubernetes quando o processo é finalizado. Esse é o comportamento padrão. Também é possível alternar essa configuração para impedir que as implantações sejam excluídas.
Personalizar a configuração de inicialização
Para configurar como o aplicativo é executado, personalize o
arquivo skaffold.yaml
.
Acessar YAML remoto
Para ver o YAML de um recurso no cluster, diretamente no Kubernetes Explorer. Navegue até um recurso no Kubernetes Explorer, como um pod, clique com o botão direito do mouse no nome do recurso e selecione Visualizar YAML remoto.O arquivo YAML correspondente ao recurso especificado é aberto em uma nova guia do editor.
Mostrar registros
Você pode transmitir e visualizar registros dos recursos do Kubernetes no console do Kubernetes Explorer para monitorar o progresso.
Depois que o aplicativo for criado e executado no modo normal ou de desenvolvimento, será possível monitorar o streaming de registros do app no seu ambiente de desenvolvimento integrado.
Também é possível ver os registros de um serviço específico navegando até o Kubernetes Explorer.
Para selecionar o recurso do qual você quer ver os registros, como um pod, uma implantação ou um serviço:
Clique com o botão direito do mouse no recurso e selecione Registros de stream. Como alternativa, é possível transmitir registros de contêineres individuais executados em pods.
Isso gera registros para o console do Kubernetes Explorer.
Para ver o status dos recursos na implantação:
Status de pod, implantação e nó: esses recursos do Kubernetes terão marcações de status coloridas ao lado dos rótulos. Vermelho para o estado com falha, amarelo para início/encerramento/alerta e verde para o estado íntegro e pretendido.
Descrições de recursos implantados: é possível executar um
kubectl describe
nos recursos implantados para exibir os detalhes, clicando com o botão direito do mouse e escolhendo Descrever.
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.
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.
É possível acessar o Kubernetes Explorer no painel lateral ou acessar Ferramentas > Cloud Code > Kubernetes > Visualizar o Explorador de clusters.
Para exibir os detalhes dos recursos implantados, clique com o botão direito do mouse em um rótulo de recurso no Kubernetes Explorer e clique em Descrever.
Clusters
- Adicione um cluster do Google Kubernetes Engine: adicione um cluster do GKE Standard ou Autopilot, ou crie um novo clicando em + Adicionar cluster do GKE no Kubernetes Explorer.
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.
Depois, clique em OK e acesse o cluster escolhido e os recursos subjacentes por meio do Kubernetes Explorer.Definir como contexto atual: 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 deles para definir como o contexto atual.
Namespaces
Definir como contexto atual: defina um namespace como ativo para que o contexto
kubectl
configurado acesse esse namespace por padrão.
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
Contêineres
- Visualizar registros:visualize os registros de um contêiner no console do Kubernetes Explorer.
- Acessar o terminal:acesse o terminal de um contêiner no console do Kubernetes Explorer.
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.
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:
A seguir
- Comece a usar o Cloud Code for IntelliJ para Kubernetes criando e implantando um aplicativo do Kubernetes com base em 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