Delen via

Verbinding maken met een console voor foutopsporing van containers in Azure Container Apps

Het Azure Container Apps-platform biedt een console voor foutopsporing om u te helpen bij het oplossen van problemen met uw toepassing onder de volgende omstandigheden:

  • U kunt geen verbinding maken met de doelcontainer wanneer u een container gebruikt die alleen de toepassing en de runtime-afhankelijkheden bevat, of een installatiekopieën zonder distributie.
  • Wanneer netwerkproblemen optreden, hebben uw installatiekopieën geen hulpprogramma's voor foutopsporing om ze te onderzoeken.

U kunt verbinding maken met de console voor foutopsporing met behulp van de Azure CLI.

Notitie

De console voor foutopsporing maakt een afzonderlijke container, die de onderliggende resources deelt met de container waarin uw app wordt uitgevoerd. Als er al een foutopsporingscontainer bestaat, wordt de bestaande console opnieuw gebruikt in plaats van een nieuwe te maken. Er is maximaal één actieve foutopsporingscontainer per container-app-replica. Als u geen foutopsporingscontainer actief wilt houden, voert u afsluiten in of gebruikt u Ctrl/Cmd + D in de consolesessie voor foutopsporing.

Azure-CLI

Gebruik de opdracht om verbinding te maken met een container met de az containerapp debug foutopsporingsconsole. Als u de console wilt afsluiten, voert u afsluiten in of gebruikt u Ctrl/Cmd + D.

Maak bijvoorbeeld verbinding met een console voor foutopsporing in een container in een container-app met één container met behulp van de volgende opdracht. Voordat u deze opdracht uitvoert, vervangt u de <PLACEHOLDERS> waarden van uw container-app.

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

Als u verbinding wilt maken met een console voor foutopsporing in een container in een container-app met meerdere revisies, replica's en containers, moet u de volgende parameters in de az containerapp debug opdracht opnemen.

Argumentatie Beschrijving
--revision De revisienaam van de container voor foutopsporing.
--replica De replicanaam van de container voor foutopsporing.
--container De containernaam van de container voor foutopsporing.

U kunt de revisienamen ophalen met de az containerapp revision list opdracht. Voordat u deze opdracht uitvoert, vervangt u de <PLACEHOLDERS> waarden van uw container-app.

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

Gebruik de az containerapp replica list opdracht om de replica- en containernamen op te halen. Voordat u deze opdracht uitvoert, vervangt u de <PLACEHOLDERS> waarden van uw container-app.

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

Maak verbinding met de console voor foutopsporing in de container met de az containerapp debug opdracht. Voordat u deze opdracht uitvoert, vervangt u de <PLACEHOLDERS> waarden van uw container-app.

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

Ingebouwde hulpprogramma's in de console voor foutopsporing

De volgende diagnostische hulpprogramma's zijn vooraf geïnstalleerd in de console voor foutopsporing om u te helpen bij het oplossen van problemen:

Als u andere hulpprogramma's wilt installeren, voert u de tdnf install -y <TOOL_NAME> opdracht uit. Voordat u deze opdracht uitvoert, vervangt u de <PLACEHOLDERS> waarden van uw container-app.

Installeer bijvoorbeeld JDK in de foutopsporingsconsole met behulp van de volgende opdracht:

tdnf install -y msopenjdk-17

Toegang tot het bestandssysteem van een container in de console voor foutopsporing

De foutopsporingsconsole wordt standaard uitgevoerd als root-gebruiker. U hebt toegang tot het bestandssysteem van uw container via de /proc/1/cwd/ map. Als uw container niet wordt uitgevoerd als de rootgebruiker, voert u de volgende opdracht uit voordat u de /proc/1/cwd/ map opent, anders krijgt u een foutmelding dat de machtiging is geweigerd.

switch-user

Zie de volgende Linux man-pagina's voor meer informatie:

Logboekstreams weergeven vanuit Azure Portal

  • Last updated on