【入門編】DockerコンテナをAnsibleで管理・プロビジョニングする開発環境構築の裏技 – インフラ構成管理（IaC）活用バイブル

こんにちは。インフラエンジニアの最前線で、数多のシステムをコードで支配してきた経験から、今日は君に「なぜ優秀なエンジニアは、Docker環境の構築にAnsibleを使うのか」という秘密を伝授しよう。

「Dockerがあるなら、Dockerfileだけでいいじゃないか？」そう思ったなら、それはまだ入り口に立ったばかりだ。Dockerfileは「コンテナの設計図」だが、Ansibleは「環境そのものを定義し、統治するプロトコル」だ。

今日は、開発環境を「何度でも完全に再現可能」にする、Ansibleを用いたDockerプロビジョニングの極意を解説する。

—

Dockerで環境を構築すると、`Dockerfile`が肥大化しがちだ。ビルドのたびに重い処理が走り、キャッシュの管理に頭を悩ませる。

Ansibleを組み合わせるメリットは以下の3点だ。

—

まずはAnsibleをインストールしよう。Python環境さえあれば一瞬だ。

仮想環境を作ってインストールするのがプロの流儀
python3 -m venv venv
source venv/bin/activate
pip install ansible docker molecule molecule-docker

—

手始めに、Ansibleを使ってNginxコンテナを起動するプレイブック（`site.yml`）を書いてみよう。

—

hosts: localhost
connection: local
tasks:

docker_container:
name: my-web-server
image: nginx:latest
state: started
ports:

# このタスクは何度実行しても、既に起動していれば何もしない（これが冪等性だ）

これを実行するだけで、君のPC上にNginxが立ち上がる。
`ansible-playbook site.yml`

—

ここからが本題だ。開発環境を構築する際、「構築スクリプトが本当に正しく動くか」をどうやって確認する？

Moleculeを使えば、以下のフローを自動化できる。
1. コンテナを立ち上げる（Docker）
2. Ansibleで構成を適用する
3. `testinfra`などのツールで「ポートは開いているか？」「設定ファイルはあるか？」を検証する
4. コンテナを破壊する

これが「インフラのTDD（テスト駆動開発）」だ。

molecule init scenario –driver-name docker

このコマンドで生成される`molecule/default/verify.yml`に、テストを記述する。

molecule/default/verify.yml

hosts: all
tasks:

wait_for:
port: 80
timeout: 5

これにより、環境構築コードを書き換えるたびに、君の書いたインフラが「壊れていないか」を瞬時に担保できるようになる。

—

初心者が陥りやすい罠は、「コンテナの中で何でもやろうとすること」だ。

コンテナはプロセスを動かす場所: コンテナの中身はできるだけシンプルに保ち、Ansibleで設定を流し込む。
ステートレスを意識: 設定ファイルやログは外部ボリュームにマウントし、コンテナが消えてもデータが残るように設計する。
コードのモジュール化: `roles/`ディレクトリを使ってタスクを整理しよう。`web_server`ロール、`database`ロールのように分けるだけで、可読性が劇的に変わる。

—

AnsibleとDockerを組み合わせることは、単なる自動化ではない。それは、「自分のPCの中身を、コードという言語で定義する」というエンジニアとしての強力な武器を手に入れることだ。

一度このフローをマスターすれば、新しいプロジェクトに参加した瞬間、コマンド一つで「完璧に設定された開発環境」が立ち上がる世界が待っている。

さあ、次は君自身のプロジェクトで、この「冪等性」を体験してみてほしい。分からないことがあれば、いつでもまた聞きに来るといい。エンジニアとしての旅路を応援しているよ。