Delen via

Taakuitvoeringslogboeken weergeven en beheren

  • Artikel

Elke taak die wordt uitgevoerd in Azure Container Registry-taken genereert logboekuitvoer die u kunt controleren om te bepalen of de taakstappen zijn uitgevoerd.

In dit artikel wordt uitgelegd hoe u taakuitvoeringslogboeken kunt weergeven en beheren.

Gestreamde logboeken weergeven

Wanneer u een taak handmatig activeert, wordt logboekuitvoer rechtstreeks naar de console gestreamd. Wanneer u bijvoorbeeld handmatig een taak activeert met behulp van de opdracht az acr build, az acr run of az acr task run , ziet u dat logboekuitvoer naar de console wordt gestreamd.

Met het volgende voorbeeld az acr run command wordt handmatig een taak geactiveerd waarmee een container wordt uitgevoerd die uit hetzelfde register is opgehaald:

az acr run --registry mycontainerregistry1220 \
  --cmd '$Registry/samples/hello-world:v1' /dev/null

Gestreamd logboek:

Queued a run with ID: cf4
Waiting for an agent...
2020/03/09 20:30:10 Alias support enabled for version >= 1.1.0, please see https://aka.ms/acr/tasks/task-aliases for more information.
2020/03/09 20:30:10 Creating Docker network: acb_default_network, driver: 'bridge'
2020/03/09 20:30:10 Successfully set up Docker network: acb_default_network
2020/03/09 20:30:10 Setting up Docker configuration...
2020/03/09 20:30:11 Successfully set up Docker configuration
2020/03/09 20:30:11 Logging in to registry: mycontainerregistry1220azurecr.io
2020/03/09 20:30:12 Successfully logged into mycontainerregistry1220azurecr.io
2020/03/09 20:30:12 Executing step ID: acb_step_0. Timeout(sec): 600, Working directory: '', Network: 'acb_default_network'
2020/03/09 20:30:12 Launching container with name: acb_step_0
Unable to find image 'mycontainerregistry1220azurecr.io/samples/hello-world:v1' locally
v1: Pulling from samples/hello-world
Digest: sha256:92c7f9c92844bbbb5d0a101b22f7c2a7949e40f8ea90c8b3bc396879d95e888a
Status: Downloaded newer image for mycontainerregistry1220azurecr.io/samples/hello-world:v1

Hello from Docker!
This message shows that your installation appears to be working correctly.
[...]

2020/03/09 20:30:13 Successfully executed container: acb_step_0
2020/03/09 20:30:13 Step ID: acb_step_0 marked as successful (elapsed time in seconds: 1.180081)

Run ID: cf4 was successful after 5s

Opgeslagen logboeken weergeven

In Azure Container Registry worden uitvoeringslogboeken voor alle taken opgeslagen. U kunt opgeslagen uitvoeringslogboeken weergeven in Azure Portal. U kunt ook de opdracht az acr-taaklogboeken gebruiken om een geselecteerd logboek weer te geven. Logboeken worden standaard 30 dagen bewaard.

Als een taak automatisch wordt geactiveerd, bijvoorbeeld door een broncode-update, is het openen van de opgeslagen logboeken de enige manier om de uitvoeringslogboeken weer te geven. Automatische taaktriggers omvatten doorvoeringen van broncode of pull-aanvragen, updates van basisinstallatiekopieën en timertriggers.

Uitvoeringslogboeken weergeven in de portal:

  1. Navigeer naar het containerregister.
  2. Selecteer in Services de optie Takenuitvoeringen>.
  3. Selecteer een run-id om de uitvoeringsstatus en uitvoeringslogboeken weer te geven. Het logboek bevat dezelfde informatie als een gestreamd logboek, als er een wordt gegenereerd.

Aanmeldingsportal voor taakuitvoering weergeven

Als u een logboek wilt weergeven met behulp van de Azure CLI, voert u az acr-taaklogboeken uit en geeft u een uitvoerings-id, een taaknaam, specifieke installatiekopieën op die zijn gemaakt door een build-taak. Als er een taaknaam is opgegeven, geeft de opdracht het logboek weer voor de laatst gemaakte uitvoering.

In het volgende voorbeeld wordt het logboek voor de uitvoering uitgevoerd met id cf4:

az acr task logs --registry mycontainerregistry1220 \
  --run-id cf4

Alternatieve logboekopslag

U kunt taakuitvoeringslogboeken opslaan op een lokaal bestandssysteem of een alternatieve archiveringsoplossing gebruiken, zoals Azure Storage.

Maak bijvoorbeeld een lokale map met taaklogboeken en leid de uitvoer van az acr-taaklogboeken om naar een lokaal bestand:

mkdir ~/tasklogs

az acr task logs --registry mycontainerregistry1220 \
  --run-id cf4 > ~/tasklogs/cf4.log

U kunt ook lokale logboekbestanden opslaan in Azure Storage. Gebruik bijvoorbeeld de Azure CLI, Azure Portal of andere methoden om bestanden te uploaden naar een opslagaccount.

Volgende stappen