O Cloud Code permite depurar facilmente um aplicativo implantado em um cluster do Kubernetes aproveitando skaffold debug. Depure o aplicativo em um cluster local (como Minikube ou Docker para computador), Google Kubernetes Engine (GKE) ou qualquer outro provedor de nuvem.
Não é necessário concluir a configuração manual, como configurar o encaminhamento de portas ou injetar argumentos de depuração específicos da linguagem. Você só precisa de um aplicativo do Kubernetes pronto para o Cloud Code que inclua um arquivo de configuração skaffold.yaml e uma configuração de inicialização cloudcode.kubernetes.
Como depurar um aplicativo
- Na barra de status do Cloud Code, escolha o comando Depurar no Kubernetes.
- Se o aplicativo não tiver a configuração do Skaffold ou a configuração de inicialização
cloudcode.kubernetes, o Cloud Code ajuda a defini-las. - Confirme se você quer usar o contexto atual do Kubernetes (em inglês) para executar o aplicativo ou alternar para um preferencial.
Se tiver escolhido um cluster remoto como contexto, você precisará fornecer um registro de imagem para enviar as imagens.
Os exemplos a seguir demonstram como especificar onde as imagens do contêiner são armazenadas para alguns registros comuns:
Docker Hub docker.io/{account}
Se você estiver usando um repositório privado do Docker Hub, verifique se você está autenticado corretamente.Google Container Repository (GCR) gcr.io/{project_id} Repositório de contêineres da AWS (ECR, na sigla em inglês) {aws_account_id}.dkr.ecr.{region}.amazonaws.com/{meu-app} Registro de contêineres do Azure (ACR, na sigla em inglês) {my_acr_name}.azurecr.io/{meu-app} Para gerar o nome do repositório de imagens final, o Cloud Code concatena esse registro de imagem com o nome da imagem especificado nos manifestos do Kubernetes. Essa escolha é armazenada na configuração de inicialização
cloudcode.kubernetes, encontrada em .vscode/launch.json.Para mais informações, consulte o guia de gerenciamento do registro de imagens.
O Cloud Code cria seus contêineres, os envia para o registro, aplica as configurações do Kubernetes ao cluster e aguarda o lançamento.
Após a implantação, o Cloud Code encaminha automaticamente todas as portas de contêiner declaradas para sua máquina e exibe os URLs na janela de saída para que você possa navegar pelo seu aplicativo ativo.
Para cada contêiner depurável no seu aplicativo, confirme ou insira o diretório no contêiner remoto em que o programa que você quer depurar está localizado.
Como alternativa, pressione ESC para pular a depuração do contêiner.
O Cloud Code anexa uma sessão de depuração para cada contêiner depurável no aplicativo.
Agora é possível executar as mesmas tarefas que você normalmente realiza ao depurar código local, como definir pontos de interrupção e percorrer códigos, em um cluster ativo do Kubernetes.
Por padrão, quando você salva uma alteração no aplicativo, o Cloud Code faz a reimplantação do aplicativo e configura uma nova sessão de depuração. É possível alternar esse recurso com a sinalização
watchna configuração de inicialização do seu projeto.Para inspecionar informações de pilha e variáveis, use a barra lateral de depuração (em inglês). Para interagir com a sessão, use o Console de depuração (em inglês) no depurador do painel inferior.
Após a conclusão da sessão, outras opções de menu contextual estarão disponíveis para monitorar o aplicativo e os recursos dele usando a barra de status do Cloud Code, incluindo:
- Abrir registros de implantação: abra os registros do aplicativo de uma implantação específica com o visualizador de registros do Cloud Code
- Abrir URL do serviço: abre o URL do serviço de aplicativo de um serviço específico em um navegador da Web.
Ativar/desativar o modo de exibição: alternar o modo de exibição para a sessão atual. Por padrão, o Cloud Code monitora continuamente o sistema de arquivos em busca de alterações nos arquivos, como a configuração ou o código do Kubernetes, recria os contêineres e reimplanta o aplicativo no cluster para que { 101}As edições são refletidas quase em tempo real.
Para encerrar a sessão de depuração, clique em
Interromper na barra de ferramentas de depuração.Depois de encerrar a sessão de depuração, todos os recursos implantados do Kubernetes serão excluídos do cluster.
Detalhes da configuração
O Cloud Code, com tecnologia do Skaffold, gerencia automaticamente os seguintes detalhes de configuração para todas as linguagens compatíveis:
- Encaminhar a porta de depuração para que o depurador seja anexado.
- Como anexar um depurador a um ou mais contêineres depuráveis no aplicativo.
Se seu aplicativo tiver vários contêineres depuráveis (contêineres compatíveis com a linguagem do Cloud Code) configurados em
skaffold.yaml, um depurador será anexado a cada um dos contêineres depuráveis. - Manter definições de mapeamento de origem entre sessões Você pode personalizar essas definições editando seu
.vscode/launch.jsondiretamente.
O Cloud Code também processa os seguintes detalhes específicos de configuração da linguagem:
Node.js
Como reescrever o ponto de entrada para invocar:
node --inspect=localhost:9229
Python
Como instalar o depurador do módulo ptvsd usando um contêiner de inicialização e reescrever o ponto de entrada para invocar:
python -m ptvsd --host localhost --port 5678
Go
A instalação do depurador dlv usando um contêiner Init e reescrever o ponto de entrada de modo que a sessão de depuração iniciada seja executada apenas com um servidor de depuração (no modo headless) continua o processo depurado no início, aceita várias conexões de clientes e detecta localhost:56268:
dlv exec --headless --continue --accept-multiclient --listen=localhost:56268 --api-version=2, <app> --
Java
Adicionando um ambiente JAVA_TOOLS_OPTIONS com a configuração apropriada do Java Debug Wire Protocol (JDWP) para que o agente de depuração do JDWP escute uma conexão de soquete na porta 5005 e permita que a VM seja iniciada antes de o depurador está anexado:
jdwp=transport=dt_socket,server=y,suspend=n,address=5005,quiet=y
Para mais detalhes sobre a depuração com tecnologia Skaffold, consulte a documentação do skaffold debug.
Como anexar o depurador a um pod do Kubernetes
O Cloud Code para VS Code também é compatível com a vinculação de um depurador a um pod do Kubernetes. Para uma comparação, consulte Como anexar a um pod do Kubernetes ou depurar um aplicativo do Kubernetes.