Compartilhar via

Conectar-se a um console de depuração de contêiner nos Aplicativos de Contêiner do Azure

A plataforma dos Aplicativos de Contêiner do Azure oferece um console de depuração para ajudar você a solucionar problemas do aplicativo nas seguintes circunstâncias:

  • Não é possível estabelecer conexão com o contêiner de destino quando ele só inclui o aplicativo e as respectivas dependências de runtime ou uma imagem “sem distro”.
  • Em caso de problemas de rede, as imagens não têm utilitários de depuração para ajudar na investigação.

É possível conectar-se ao console de depuração usando a CLI do Azure.

Observação

O console de depuração cria um contêiner separado, que compartilha os recursos subjacentes com o contêiner em que o aplicativo está em execução. Se já houver um contêiner de depuração, o console de depuração o reutilizará em vez de criar um novo. Há apenas um contêiner de depuração em execução por réplica de aplicativo de contêiner. Se não for preciso manter um contêiner de depuração em execução, insira sair ou use Ctrl/Cmd + D na sessão do console de depuração.

CLI do Azure

Para se conectar a um console de depuração de contêiner, use o comando az containerapp debug. Para sair do console, insira sair ou use Ctrl/Cmd + D.

Por exemplo, use o comando a seguir para se conectar a um console de depuração de contêiner em um aplicativo de contêiner que contém um único contêiner. Antes de executar o comando, substitua <PLACEHOLDERS> pelos valores do aplicativo de contêiner.

az containerapp debug \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP>

Para se conectar a um console de depuração de contêiner em um aplicativo de contêiner com diversas revisões, réplicas e contêineres, inclua os parâmetros a seguir no comando az containerapp debug.

Argumento Descrição
--revision O nome da revisão do contêiner que será depurado.
--replica O nome da réplica do contêiner que será depurado.
--container O nome do contêiner que será depurado.

É possível obter os nomes de revisão com o comando az containerapp revision list. Antes de executar o comando, substitua <PLACEHOLDERS> pelos valores do aplicativo de contêiner.

az containerapp revision list \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --query "[].name"

Use o comando az containerapp replica list para obter os nomes de revisão e de contêiner. Antes de executar o comando, substitua <PLACEHOLDERS> pelos valores do aplicativo de contêiner.

az containerapp replica list \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --revision <REVISION_NAME> \
  --query "[].{Containers:properties.containers[].name, Name:name}"

Conecte-se ao console de depuração de contêiner com o comando az containerapp debug. Antes de executar o comando, substitua <PLACEHOLDERS> pelos valores do aplicativo de contêiner.

az containerapp debug \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --revision <REVISION_NAME> \
  --replica <REPLICA_NAME> \
  --container <CONTAINER_NAME>

Ferramentas integradas no console de depuração

As seguintes ferramentas de diagnóstico estão pré-instaladas no console de depuração para ajudar você a solucionar problemas:

Para instalar outras ferramentas, execute o comando tdnf install -y <TOOL_NAME>. Antes de executar o comando, substitua <PLACEHOLDERS> pelos valores do aplicativo de contêiner.

Por exemplo, instale o JDK no console de depuração usando o seguinte comando:

tdnf install -y msopenjdk-17

Acessando o sistema de arquivos de um contêiner no console de depuração

Por padrão, o console de depuração é executado como usuário raiz. Você pode acessar o sistema de arquivos do contêiner por meio do /proc/1/cwd/ diretório. Se o contêiner não for executado como o usuário raiz, execute o seguinte comando antes de acessar o /proc/1/cwd/ diretório ou você receberá um erro de permissão negado.

switch-user

Para obter mais informações, consulte as seguintes páginas do manual do Linux:

Exibir fluxos de log do portal do Azure

  • Last updated on