Docker デバッグ出力の使用

Docker コンテナまたはイメージに問題がある場合は、Docker デーモンでデバッグモードを有効にできます。デバッグを有効にすると、 デーモンからより詳細な出力が得られます。この情報を使用して、コンテナやイメージに問題がある理由の詳細を確認できます。

Docker デバッグモードを有効にすると、Amazon ECR などのコンテナレジストリから送信されたエラーメッセージを取得するために特に役立ちます。多くの状況において、これらのエラーメッセージを表示するには、デバッグモードを有効にする以外に方法はありません。

重要

この手順は、Amazon ECS 最適化 Amazon Linux AMI 用に書かれています。その他のオペレーティングシステムについては、Docker ドキュメントの「デバッグと制御Dockersystemdを有効にして で設定する」を参照してください。

Amazon ECS 最適化 Amazon Linux AMI で Docker デーモンのデバッグモードを有効にするには

1. コンテナインスタンスに接続します。

2. Docker options ファイルを vi などのテキストエディタで開きます。Amazon ECS 最適化 Amazon Linux AMI の場合、Docker options ファイルは/etc/sysconfig/dockerにあります。

3. Docker options ステートメントを見つけ、引用符の中の文字列に -D オプションを追加します。

   注記

   Docker options ステートメントが # で始まっている場合、その文字を削除してそのステートメントをコメント解除し、オプションを有効にします。

   Amazon ECS 最適化 Amazon Linux AMI では、Docker options ステートメントを OPTIONS と呼びます。例:

   # Additional startup options for the Docker daemon, for example:
   # OPTIONS="--ip-forward=true --iptables=true"
   # By default we limit the number of open files per container
   OPTIONS="-D --default-ulimit nofile=1024:4096"

4. ファイルを保存し、テキストエディタを終了します。

5. Docker デーモンを再び開始します。

   sudo service docker restart

   出力は次のとおりです。

   Stopping docker:                                          [  OK  ]
   Starting docker:	.                                  [  OK  ]

6. Amazon ECS エージェントを再び開始します。

   sudo service ecs restart

これで、Docker ログにはより詳細な出力が表示されます。

time="2015-12-30T21:48:21.907640838Z" level=debug msg="Unexpected response from server: \"{\\\"errors\\\":[{\\\"code\\\":\\\"DENIED\\\",\\\"message\\\":\\\"User: arn:aws:sts::1111:assumed-role/ecrReadOnly/i-abcdefg is not authorized to perform: ecr:InitiateLayerUpload on resource: arn:aws:ecr:us-east-1:1111:repository/nginx_test\\\"}]}\\n\" http.Header{\"Connection\":[]string{\"keep-alive\"}, \"Content-Type\":[]string{\"application/json; charset=utf-8\"}, \"Date\":[]string{\"Wed, 30 Dec 2015 21:48:21 GMT\"}, \"Docker-Distribution-Api-Version\":[]string{\"registry/2.0\"}, \"Content-Length\":[]string{\"235\"}}"