# Amazon ECS の Docker デーモンからの詳細な出力の設定
<a name="docker-debug-mode"></a>

Docker コンテナまたはイメージに問題がある場合は、Docker デーモンに対してデバッグモードをオフにすることができます。デバッグを使用すると、デーモンからより詳細な出力が得られます。これを使用して、Amazon ECR などのコンテナレジストリから送信されるエラーメッセージを取得できます。

**重要**  
この手順は、Amazon ECS 最適化 Amazon Linux AMI 用に書かれています。他のオペレーティングシステムについては、Docker ドキュメントの「[デバッグの有効化](https://docs.docker.com/engine/admin/#enable-debugging)」と「[systemd による Docker の制御と設定]()」を参照してください。

**Amazon ECS に最適化された Amazon Linux AMI で Docker デーモンのデバッグモードを使用するには**

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

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

1. 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"
   ```

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

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

   ```
   sudo service docker restart
   ```

   出力は次のとおりです。

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

1. 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\"}}"
```