アプリケーションのデプロイ

Compose、コンテナパネル、およびアップデート管理

概要: Linux VPS上でマルチコンテナアプリケーションを管理する場合、散在するdocker runコマンドを使用していると、パラメータの失念、ネットワークトポロジの混乱、そして悲惨なアップグレードにつながりやすくなります。現代のコンテナデリバリーでは、イメージタグ、環境変数、永続ボリューム、ネットワーキング、リソース制限をコードとしてのインフラストラクチャ(Infrastructure as Code)としてDocker Composeで標準化します。

VPSMap 編集部 · 更新 2026-09-26 · 読了時間 20 分 · テキスト版

Linux VPS上でマルチコンテナアプリケーションを管理する場合、散在するdocker runコマンドを直接使用すると、パラメータの失念、ネットワークトポロジの混乱、そして悲惨なアップグレードを容易に引き起こす可能性があります。現代のコンテナデリバリーでは、Docker Composeを使用して、イメージタグ、環境変数、永続ボリューム、ネットワーキング、およびリソース制限をコードとしてのインフラストラクチャ(Infrastructure as Code)として定義します。

本記事では、本番運用における高可用性とデータセキュリティに焦点を当て、標準化されたComposeディレクトリ構成、内部ネットワークの分離、グラフィカル管理パネルの権限強化、そしてデータベース移行を考慮したスムーズな更新と緊急ロールバック手順について解説します。また、BandwagonHostやDMITといった主要クラウドプロバイダーのコンソール機能を活用し、低レイヤーのトラブルシューティングと運用上のディザスタリカバリに関するガイダンスを提供します。


1. アーキテクチャ標準: 単一アプリケーションディレクトリと分離された状態#

ポータビリティと数秒でのコールドマイグレーションを確保するため、ホストレベルのコンテナオーケストレーションはアプリケーションスタックごとに単一のディレクトリを割り当てる原則に従う必要があります。分離のためのルートパスとして/srv/stacks/<应用名>または/opt/stacks/<应用名>に標準化することをお勧めします。

テキスト
/opt/stacks/web-app/
├── compose.yaml          # 核心编排文件(Compose V2 规范)
├── .env                  # 敏感环境变量(权限 600,禁止提交至公开仓库)
├── config/               # 挂载至容器的应用专属静态配置文件
│   └── nginx.conf
└── data/                 # 宿主机绑定挂载的数据目录(非必要时优先使用命名卷)
    └── app-uploads/

ディレクトリおよび認証情報管理のガイドライン#

  1. 更新された命名規則: 最新のComposeプラグインは、デフォルトの設定ファイルとして一貫してcompose.yaml(またはcompose.yml)を使用します。古いトップレベルのversion: '3.8'宣言行。コマンドは、廃止されたスタンドアロンバイナリdocker-composeではなく、一貫してdocker compose(単語の間にスペースあり)となります。
  2. 環境認証情報の分離: データベースパスワードやAPIトークンなどの動的な設定値は、同じディレクトリの .env ファイルに抽出する必要があり、Composeが自動的に変数展開(${VARIABLE_NAME})。ホストを保護するため、このファイルの権限を厳重に制限する必要があります:
    bash
    chmod 600 /opt/stacks/web-app/.env
    chown -R root:root /opt/stacks/web-app
  3. バージョン管理の境界:Gitを使用して運用設定を追跡する場合は、リポジトリに.env.exampleテンプレートを含め、.gitignoreにおいて.envおよび実際のビジネス状態を含むすべてのdata/ディレクトリを厳格に除外してください。

2. 本番グレードのオーケストレーション標準とネットワーク分離#

すべてのコンテナポートをホストの0.0.0.0に直接マッピングすることは、重大なネットワークセキュリティリスクです。Dockerデーモンはシステムのiptablesルールを直接変更してDOCKERチェーンを挿入し、システムのUFWまたはfirewalld設定をバイパスします。データベースやキャッシュサービスが外部にマッピングされると、そのポートはパブリックインターネットに直接公開されてしまいます。

以下は、独立したアプリケーションネットワーク、ログローテーションの上限、リソース制限、およびリバースプロキシ用の設定を統合した標準的なcompose.yamlテンプレートです:

yaml
services:
  web:
    image: ghost:5-alpine
    container_name: production_blog_web
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      database__client: mysql
      database__connection__host: db
      database__connection__user: ghost
      database__connection__password: ${MYSQL_PASSWORD}
      database__connection__database: ghost_prod
      url: https://example.com
    volumes:
      - blog_content:/var/lib/ghost/content
    ports:
      # 严格限制仅监听宿主机本地环回接口,交由外部 Nginx 或 Caddy 处理 TLS 与反代
      - "127.0.0.1:2368:2368"
    networks:
      - frontend_net
      - backend_net
    deploy:
      resources:
        limits:
          cpus: '1.50'
          memory: 1024M
    logging:
      driver: json-file
      options:
        max-size: "20m"
        max-file: "3"

  db:
    image: mariadb:10.11
    container_name: production_blog_db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ghost_prod
      MYSQL_USER: ghost
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    # 绝不发布 ports,仅在内部网络被同栈应用发现
    networks:
      - backend_net
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "2"

volumes:
  blog_content:
    name: blog_app_content
  db_data:
    name: blog_app_db_data

networks:
  frontend_net:
    driver: bridge
  backend_net:
    driver: bridge

設計上の主要な考慮事項#

  • 二層ネットワーク分離:dbコンテナはbackend_netにのみ参加し、パブリックインターネットとの通信の可能性を完全に排除します。webコンテナはComposeの内蔵DNSとサービス名dbを使用して名前解決を行い、接続を確立します。
  • ディスク枯渇を防ぐ設計:Dockerのデフォルトのロギングドライバーでは、コンテナのstdout/stderrログが無制限に肥大化してしまいます。設定でmax-sizeおよびmax-fileを明示的に宣言することで、ログローテーションを強制し、低スペックなVPSインスタンスがディスクの逼迫によってダウンするのを防ぐことができます。
  • イメージバージョンの固定:本番環境で:latestを直接使用しないでください。予期しない再起動時に破壊的変更を含むビルドがプルされるのを防ぐため、明示的なメジャーバージョンまたは固定ビルドハッシュを持つ安定したイメージ(mariadb:10.11やalpineブランチなど)を使用してください。

3. デプロイ検証と一般的なコマンドワークフロー#

ディレクトリ構造を設定した後は、「構文チェック $\\to$ イメージのプル $\\to$ バックグラウンド構築 $\\to$ ステータス監査」という標準的な順序に従います:

bash
# 1. 验证配置文件合法性与变量解析状态(不显示敏感数据)
docker compose config --quiet

# 2. 预先抓取所有编排中的镜像,降低上线中断时长
docker compose pull

# 3. 后台守护模式创建并启动容器
docker compose up -d

# 4. 检查服务健康状态与端口监听
docker compose ps

# 5. 持续观测业务输出以排查初始化异常
docker compose logs -f --tail=100 web

トラブルシューティング時の注意点:docker compose configは.envすべての内部変数が完全に展開されます。チームやサポートチケットシステムとデバッグ情報を共有する際は、サニタイズされていない完全な設定を絶対に貼り付けないでください。


4. ビジュアルパネル(Portainer / 1Panel)の選定とアタックサーフェスの縮小#

共同作業や監視を簡素化するために、軽量なコンテナ管理パネルを追加するチームもあります。ただし、次の点を認識しておくことが不可欠です:Dockerに接続されたすべての管理パネルは、本質的に特権プロセスであるということです。

Dockerソケットのセキュリティ境界#

Portainerなどのほぼすべてのビジュアル管理パネルは、ホストのDocker通信ソケットをマウントする必要があります:-v /var/run/docker.sock:/var/run/docker.sock

このソケットをコンテナにマウントすると、ホストレベルのrootと同等の制御権限が付与されます。パネルのフロントエンドパスワードが漏洩したり、リモートコード実行の脆弱性が存在したりする場合、攻撃者はこのソケットを利用してホストのルートディレクトリをマウントする特権コンテナを作成し、システム全体を掌握する可能性があります。

パネルのセキュリティ強化ガイドライン#

  1. パブリックインターネットに公開しない:Portainerの9443や1Panelのポートなど、管理パネルのポートをパブリックインターネットに直接公開しないでください。本番環境では、ローカルのみでのリッスン(127.0.0.1)を義務付け、安全なSSHキーベースのトンネルを介したローカルポートフォワーディング経由でのみアクセスできるようにします:
    bash
    # 在本地工作电脑建立安全隧道,将远程端口转发至本地
    ssh -N -L 9443:127.0.0.1:9443 user@vps-ip -i ~/.ssh/id_ed25519
    その後、ローカルブラウザで開き https://127.0.0.1:9443 パネルにアクセスします。
  2. 双方向管理による構成ドリフトの回避:グラフィカルパネルとローカルのYAMLファイルの間で状態の不整合が容易に発生する可能性があります。ローカルのcompose.yamlが同期されていない状態でパネルのWebUIからコンテナのマッピングポートや環境変数を直接変更すると、次回ターミナルからdocker compose up -dを実行した際にパネル上で行った一時的な変更が完全に消去されてしまいます。ベストプラクティス:パネルは読み取り専用の監視またはログ監査ツールとしてのみ使用してください。すべての作成、読み取り、更新、削除の操作における信頼できる唯一の情報源(Single Source of Truth)として、バージョン管理リポジトリとターミナルスクリプトを維持してください。

5. グレースフルなイメージ更新、データ移行、およびロールバック制御#

多くの初心者は、コンテナの更新とは単に最新のイメージをプルして再起動するだけだと考えがちです。しかし、永続化を伴うビジネスアプリケーションの場合、これによりデータベースのスキーマ移行が中断されたり、データが破損したりする危険性が高くなります。

標準的な四段階ローリングアップデート手法#

テキスト
[1. 业务静态化与状态备份] ──> [2. 拉取新镜像] ──> [3. 差异化重建容器] ──> [4. 健康校验]

ステップ一:アプリケーションとデータベースのコールドバックアップを実行#

新しいイメージに切り替える前に、ホストディスクのスナップショットだけに頼るのではなく、データの論理ダンプを作成してください。

bash
# 进入部署目录
cd /opt/stacks/web-app

# 逻辑导出当前数据库数据并压缩
docker compose exec db mariadb-dump -u ghost -p"${MYSQL_PASSWORD}" ghost_prod | gzip > backup_$(date +%F_%H%M).sql.gz

# 备份持久化配置与上传目录
tar -czvf app_data_$(date +%F).tar.gz config/ data/

ステップ二:イメージの更新とコンテナの置き換え#

compose.yaml内の対象サービス(webなど)のバージョンタグを変更し、差分リビルドを実行します:

bash
# 仅拉取更新的镜像层
docker compose pull web

# 触发依赖项计算,仅重新创建发生了配置或镜像变更的容器
docker compose up -d web

# 清理不再使用的孤儿容器与旧版本镜像
docker compose ps
docker image prune -f

docker compose up -dを使用すると、正常に稼働し続けている個別のデータベースサービスを中断することなく、スタックをインプレースで更新できます。

致命的なロールバックの誤解:スキーマの罠#

新しいサービスバージョンの起動に失敗して緊急のロールバックが必要になった際、多くの人は単純にcompose.yamlでイメージバージョンを以前のタグに戻してup -dを実行してしまいます。

重大な潜在的リスク:Nextcloud、WordPress、Ghostなどの多くのWebアプリケーションは、新バージョンの初回起動時に、カラムの削除、フィールド名の変更、文字セットの変換など、不可逆的なデータベーススキーマのマイグレーションを自動的に実行します。以前のバージョンのアプリケーションコードは、新しいバージョンによって変更されたテーブルを解釈できないため、たとえイメージのロールバックに成功したとしても、エラーやクラッシュが継続して発生します。

完全なロールバック手順:

  1. 直ちにアプリケーションコンテナを停止:docker compose stop web
  2. 以前にエクスポートしたバックアップを使用してデータベースをリセット:
    bash
    # 清空并恢复数据库
    gunzip < backup_YYYY-MM-DD.sql.gz | docker compose exec -T db mariadb -u ghost -p"${MYSQL_PASSWORD}" ghost_prod
  3. compose.yamlを変更して、以前のイメージタグとそれに対応する設定ファイルを復元します。
  4. 以前のコンテナバージョンを再構築:docker compose up -d web

警告:docker compose down -vの回避
docker compose downはコンテナとブリッジネットワークを停止して削除するだけですが、-v(または--volumes)パラメータが含まれている場合、Dockerはcompose.yamlで宣言された名前付きボリュームを直接消去します。環境を完全に破棄する意図がない限り、本番サーバーで以下のオプションを使用しないでください:-vコマンド。


6. 基盤クラウドネットワークの調整と緊急オペレーション#

コンテナオーケストレーションは基盤となるクラウドサーバー上で稼働します。ネットワークインターフェースの問題、ファイアウォールによる遮断、認証情報の喪失は、コンテナのライフサイクルを直接中断させる可能性があります。ホストのインフラ機能を効果的に活用することが、運用上の障害に対する最後の防衛線となります。

ファイアウォールおよび基盤接続障害のトラブルシューティング#

DockerはNATテーブルとブリッジ自体(docker0 / br-xxxx)を独自に管理するため、コンテナの再起動後にルーティングテーブルの競合が時折発生し、ホストのSSHデーモンにすら到達できなくなることがあります。

  • DMITの緊急アクセス: DMITのインスタンスコントロールパネルには専用のWeb Consoleエントリポイントが用意されています。Dockerコンテナがポートを占有している、あるいはネットワークポリシーによってブロックされているためにSSHにアクセスできない場合は、パネルのConsoleを使用してハードウェア割り込みを送信するか、直接ログインしてトラブルシューティングを行ってください。さらに、ブルートフォース攻撃を防ぐため、DMITはリモートでのrootパスワードログインを無効化し、SSHキーによるアクセスを強く推奨しています。パネルのAccessメニューから公開鍵を一括置換または挿入する必要がある場合は、操作後にパネルの指示に従ってインスタンスを再起動(Reboot)すると、基盤となるcloud-initおよび認証メカニズムが有効になります。
  • BandwagonHost KiwiVMの詳細なトラブルシューティング: BandwagonHostは各VPSに独立したKiwiVMパネルを割り当てます。KiwiVMパネルのパスワード、クライアントエリアのアカウントパスワード、システムの内部rootパスワードは完全に独立している点にご注意ください。ホストのネットワークに障害が発生した場合は、KiwiVMに組み込まれたInteractive Consoleを使用して通常のネットワークスタックをバイパスし、TTY端末に直接アクセスして、rootパスワードを入力することでサーバーの制御を取り戻せます。不適切なコンテナネットワーク設定によってネットワーク全体が無効化された場合でも、パネルからOSの再インストールやスナップショットの復元を開始することすら可能です。

自動更新とデータ保持の境界#

コンテナオーケストレーションによりアプリケーションを迅速に再構築できますが、永続データに対するノード間の災害復旧の代わりにはなりません。請求書の支払期限が過ぎたり、データセンターのポリシーが変更されたりした場合、ホスト上のすべてのデータボリュームが直接消去される可能性があります。

  • 請求と保持期間:
    • BandwagonHost: このプロバイダーは、利用者の関与なしに登録されたクレジットカードやPayPalアカウントへ自動請求することはありません。自動更新が有効な場合、期限切れの7日前に請求書が生成されます。前払いアカウントの残高が十分にあれば、システムが残高から引き落としてサービスを更新しますが、そうでない場合は管理者が手動で支払いを完了する必要があります。
    • DMIT: 月次更新の請求書も期限切れの7日前に生成されます。支払いの遅延により一時停止となった場合、データセンターが提供するデータの保持猶予期間は通常3日間のみです。この期間が過ぎると、自動化されたプロセスによってインスタンスおよびマウントされたDockerデータが完全に破棄され、復旧することはできません。
  • データセンター間移行の制限: BandwagonHostは便利なリージョン間データセンター移行を提供していますが、禁止された送信アクティビティや不正利用によってインスタンスのIPがブラックリストに登録された場合、システムは基盤パネルでの移行を厳格に制限します。誤って設定されたコンテナが侵害され、外部ネットワークのスキャンに悪用された場合、IPのブロックやサービスの中断から、移行および復旧の権限喪失に至るまでの事態を招く可能性があります。
  • オフサイト災害復旧の最小要件: 基盤となるプロバイダーに関係なく、永続ディレクトリ(Volumes)およびデータベースのDumpバックアップは暗号化し、AWS S3、R2、Backblaze B2などのオブジェクトストレージクライアントを使用して、日次スケジュールでホストの外部にアップロードする必要があります。一つのインスタンスの仮想ディスクだけにすべてのデータを依存させるようなリスクは絶対に避けてください。

7. 本番引き渡しチェックリスト#

Docker Composeのデプロイやメジャーバージョンのアップデート後は、以下の手順に従って引き渡し監査を完了してください。

検証カテゴリ主要チェック項目検証方法/期待される動作
ネットワーク分離データベース/ミドルウェアのポートがパブリックインターネットに公開されていないことホスト上で実行 ss -tulpn | grep -E '3306|5432|6379' 外部リスナーが存在しないこと
権限の確認アプリケーションコンテナで特権モード(Privileged Mode)を使用していないことcompose.yaml が含まれていないこと privileged: true、不要なホストマウントが存在しないこと
リソース制限メモリおよびCPUのハードリミットが設定され有効であること起動後、以下を使用: docker stats --no-stream コンテナのメモリ制限が有効になっていることを検証
ログローテーションログによってホストのディスクがいっぱいにならないことすべてのサービスで以下が宣言されていることを確認: max-size および max-file 制限事項
停電後の自動起動ホスト再起動後の自動復旧サービス設定 restart: unless-stopped、再起動後に docker ps が表示されること
オフラインバックアップオフサイトバックアップ戦略とバックアップの検証自動化されたSQLバックアップファイルが空でなく、テスト環境にインポートできることを確認
緊急アクセスチャネル常時利用可能な運用コンソールネットワーク障害時にも低レベルのトラブルシューティングアクセスを確保できるよう、プロバイダーのコンソールログイン認証情報を事前に確認