Dockerデーモンをdaemon.jsonで設定する方法｜ログ設定・insecure-registries・live-restoreの実践手順

この記事のポイント

・daemon.jsonは/etc/docker/daemon.jsonに置き、JSON形式でDockerデーモン全体の挙動を制御する
・"log-driver"と"log-opts"でコンテナのデフォルトログサイズ・ファイル数を一括制限できる
・insecure-registriesでHTTP接続のプライベートレジストリを許可する
・dockerd --validateで構文エラーを事前確認してからsystemctl restart dockerで反映する

# /etc/docker/ ディレクトリの確認（Ubuntu 24.04 / RHEL 9.4 共通）
$ ls -la /etc/docker/
total 16
drwx--x--x  2 root root   29 Aug 10 09:03 .
drwxr-xr-x 84 root root 8192 Aug 10 09:03 ..
-rw-------  1 root root  244 Aug 10 09:03 key.json

# daemon.json が存在しない場合は新規作成する
$ sudo touch /etc/docker/daemon.json

# エディタで編集する（viまたはnano）
$ sudo vi /etc/docker/daemon.json

# /etc/docker/daemon.json（ログローテーション設定例）
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}

# daemon.json の構文チェック（エラーがなければ何も出力されない）
$ sudo dockerd --validate --config-file /etc/docker/daemon.json

# JSON構文エラーがある場合の出力例（末尾のカンマを付け忘れた場合）
$ sudo dockerd --validate --config-file /etc/docker/daemon.json
invalid character '}' looking for beginning of object key string

# エラー例2: キーのダブルクォートが抜けた場合
$ sudo dockerd --validate --config-file /etc/docker/daemon.json
invalid character 'l' looking for beginning of object key string

# Dockerデーモンを再起動する
# 注意: live-restoreなしでは稼働中コンテナが停止する
$ sudo systemctl restart docker

# 設定が反映されたかdocker infoで確認する
$ docker info | grep -A 5 "Logging Driver"
Logging Driver: json-file
 Cgroup Driver: systemd
 Cgroup Version: 2
 Plugins:
  Volume: local

# ログオプションの設定値を確認する
$ docker info | grep "max-"
  max-file: 3, max-size: 100m

# /etc/docker/daemon.json（本番環境向けログ設定）
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "5",
    "compress": "true"
  }
}

# /etc/docker/daemon.json（HTTPレジストリを許可する設定）
{
  "insecure-registries": [
    "192.168.10.100:5000",
    "registry.internal.example.com:5000"
  ]
}

# 設定反映後、HTTPレジストリからpullできるか確認する
$ docker pull 192.168.10.100:5000/myapp:latest
latest: Pulling from myapp
a3d5091abb3a: Pull complete
Digest: sha256:8f1a3bcd...
Status: Downloaded newer image for 192.168.10.100:5000/myapp:latest

# docker infoで登録内容を確認する
$ docker info | grep -A 3 "Insecure Registries"
 Insecure Registries:
  192.168.10.100:5000
  127.0.0.0/8

# /etc/docker/daemon.json（live-restore設定）
{
  "live-restore": true
}

# live-restore動作確認: コンテナ起動中にDockerをrestartする
$ docker run -d --name test-nginx nginx:alpine
a1b2c3d4e5f6...

# Dockerデーモンを再起動する
$ sudo systemctl restart docker

# コンテナが継続稼働しているか確認する（STATUSがUpのまま）
$ docker ps
CONTAINER ID  IMAGE         COMMAND                CREATED        STATUS
a1b2c3d4e5f6  nginx:alpine  "/docker-entrypoint.…"  5 minutes ago  Up 5 minutes

# live-restoreが有効か確認する
$ docker info | grep "Live Restore"
 Live Restore Enabled: true

# /etc/docker/daemon.json（data-root変更例）
{
  "data-root": "/mnt/docker-data"
}

# 1. Dockerデーモンを停止する（コンテナも停止する）
$ sudo systemctl stop docker

# 2. 新しいディレクトリを作成する
$ sudo mkdir -p /mnt/docker-data

# 3. 既存データをrsyncでコピーする（-a: アーカイブモード・-H: ハードリンク保持）
$ sudo rsync -aH /var/lib/docker/ /mnt/docker-data/

# 4. daemon.jsonを更新してDockerを起動する
$ sudo systemctl start docker

# 5. 移行後のデータ保存先を確認する
$ docker info | grep "Docker Root Dir"
 Docker Root Dir: /mnt/docker-data

# 6. 問題がなければ旧データをバックアップとして保管する
$ sudo mv /var/lib/docker /var/lib/docker.bak

# Dockerサービスのエラーログを確認する
$ sudo journalctl -xeu docker.service | tail -30

# よくあるエラー例1: JSONの末尾カンマ（trailing comma）
Aug 13 12:00:01 web01.internal dockerd[1234]: invalid character '}' looking for beginning of object key string

# よくあるエラー例2: 存在しないdata-rootを指定した
Aug 13 12:00:01 web01.internal dockerd[1234]: failed to start daemon: Error processing daemon configuration file: mkdir /mnt/nonexistent: no such file or directory

# 構文エラーの原因を特定するにはJSONフォーマッターを使う
$ python3 -m json.tool /etc/docker/daemon.json
Expecting ',' delimiter: line 5 column 3 (char 87)