タスク実行ログを表示および管理する

  • [アーティクル]

Azure Container Registry タスクのそれぞれのタスク実行で、タスク ステップが正常に実行されたかどうかを判別するために検査できるログ出力が生成されます。

この記事では、タスク実行ログの表示および管理方法について説明します。

ストリーム配信されるログを表示する

タスクを手動でトリガーすると、ログ出力が直接コンソールにストリーム配信されます。 たとえば、az acr build、az acr run、または az acr task run コマンドを使用して手動でタスクをトリガーする場合、コンソールにストリーム配信されたログ出力が表示されます。

次の az acr run サンプル コマンドは、同じレジストリからプルされたコンテナーを実行するタスクを手動でトリガーします。

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

ストリーム配信されたログ:

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

保存されたログを表示する

Azure Container Registry では、すべてのタスクの実行ログが保存されます。 保存されている実行ログは、Azure portal で表示できます。 または az acr task logs コマンドを使用して、選択したログを表示します。 既定では、ログは 30 日間保持されます。

たとえばソースコードの更新でタスクが自動的にトリガーされる場合、保存されているログへのアクセスが、実行ログを表示する唯一の方法になります。 自動タスク トリガーには、ソース コードのコミットまたは pull request、基本イメージの更新、およびタイマー トリガーが含まれます。

ポータル内の実行ログを表示するには:

  1. お使いのコンテナー レジストリに移動します。
  2. [サービス] で、 [タスク]>[実行] を選択します。
  3. 実行状態と実行ログを表示するには、 [実行 ID] を選択します。 ログには、ストリーム配信されたログが生成された場合は、これと同じ情報が含まれます。

タスク実行ログイン ポータルを表示する

Azure CLI を使用してログを表示するには、az acr task logs を実行して、実行 ID、タスク名、またはビルド タスクで作成された特定のイメージを指定します。 タスク名が指定されている場合、コマンドは最後に作成された実行のログを表示します。

次の例では、ID cf4 の実行のログを出力します。

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

代替ログ ストレージ

タスク実行ログをローカル ファイル システムに保存することも、Azure Storage などの代替アーカイブ ソリューションを使用することもできます。

たとえば、ローカルの tasklogs ディレクトリを作成し、az acr task logs の出力をローカル ファイルにリダイレクトします。

mkdir ~/tasklogs

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

ローカル ログ ファイルを Azure Storage に保存することもできます。 たとえば、Azure CLI、Azure portal、またはその他の方法を使用して、ファイルをストレージ アカウントにアップロードします。

次のステップ