こんにちは、AI Labの川口あいです。
前回の記事では、Serverspecを仕様としてデータベース構成をAnsibleでIaC化し、「利用可能なDB基盤」を再現性高く構築する方法をご紹介しました。 今回はその続きとして、これまで作成してきたAnsibleの構成を実際の複数環境(Docker / AWS / さくらのクラウド)で検証可能な形に仕上げるフェーズについて解説します。
単なる構成管理の実装にとどまらず、どの環境でもREADMEを読めば同じ検証ができる状態を整備することをゴールとしています。
目次
プロジェクトの目的
本プロジェクトの最終目標は、以下の状態を実現することです。
- 作成済みのAnsible playbookを”AWS / さくらのクラウド”の両環境で実行可能にする(冪等性も担保されている状態)
- Serverspecによるテストがすべての環境でパスすることを保証する
- READMEを読むことで、誰でも同じ手順で検証できる状態にする
これにより、単なるIaCではなく、
「再現可能な検証環境まで含めたIaC」
へと進化させることを目指しています。
検証環境の全体像
これまでの開発はDockerベースで進めてきましたが、今回からは実環境も含めて検証対象としています。
Docker環境は、これまでの環境と同様で以下の3つのコンテナから構成されています。
┌─────────────────────┐
│ ansible-controller │ Ansible実行環境
│ - Python 3.11 │
│ - Ansible 2.19 │
└──────────┬──────────┘
│
│ SSH (ed25519)
│
┌──────────▼──────────┐
│ almalinux-target │ テスト対象サーバー
│ - AlmaLinux 9 │
│ - SSHd │
└──────────▲──────────┘
│
│ SSH (ed25519)
│
┌──────────┴──────────┐
│ kondate-runner │ ServerSpec実行環境
│ - Ruby 3.3 │
│ - Kondate │
│ - ServerSpec │
└─────────────────────┘
実環境の場合は、テスト対象サーバーがAWS or さくらのクラウドで作成したサーバーとなります。
検証パターン
本プロジェクトでは、以下の2パターンで検証を行います。
| 環境 | 目的 |
|---|---|
| Docker | ローカルでの高速検証 |
| AWS / さくらのクラウド | 実運用に近い環境での検証 |
READMEでは、それぞれの手順を分離して記載することで、利用者が目的に応じて選択できる構成としました。
READMEの設計方針
本プロジェクトでは、Ansibleによる構成管理だけでなく、第三者がそのまま検証できる状態を担保することを重要視しています。
IaCはコード単体では不十分であり、以下の3点が揃って初めて実用的な価値を持ちます。
- 実行手順(どう動かすか)
- 環境構築方法(どこで動かすか)
- 検証方法(正しく構築されたかどうか)
これらをREADMEに明文化することで、
「誰が・どの環境で実行しても同じ結果になる」状態を保証するドキュメント
として機能させています。
また、単に情報を並べるのではなく、
「READMEを上から順に実行すれば検証が完了する」構成
になるよう設計しています。
READMEの構成
READMEは、利用シーンの違いを考慮して、環境ごとに手順を分離した構成としています。
1. Docker環境(ローカル検証用)
Dockerは「最短で動作確認するための環境」として位置付け、手順のブレを排除する設計としています。
- コンテナ構成を図と表で明示(controller / target / runner の役割を固定)
- 初期セットアップを共通化(鍵の準備など、最初にやることをまとめる)
- Ansible実行 → Serverspec実行を1本の流れにして、ローカルで再現しやすくする
2. AWS / さくらのクラウド(実環境検証用)
クラウド環境は、Dockerと同じ“操作感”で進められるように、変わる部分だけを差分として書く方針にしました。
- inventoryを切り替えるだけで同じansible-playbookを実行できる形に寄せる
- SSH鍵の準備・接続ユーザー・ホスト定義といった変わる部分だけをまとめて記載
Dockerで確認した手順をそのままAWSやさくらのクラウド環境でも適用できる構造にすることで、環境ごとの違いに悩まずに検証を進められるようにしています。
3. 共通事項(環境差分の吸収)
複数環境に対応すると、つまずきポイントが「環境差分」に集中します。そのためREADMEでは、この差分を事前に言語化して提示する設計としています。
鍵の扱いの違い
- Dockerは検証用に鍵を用意
- クラウドは既存鍵を使うケースがある
→ ここをREADMEに明記し、作業者が「どの鍵をどこに置くか」で迷わないようにしています
設定ファイルの例を提示
以下のような設定ファイルは、文章だけでは理解しづらいため、
- .env
- inventory
- SSH設定
については具体例をそのまま掲載しています。
設計上のポイント
今回のREADME設計で意識したのは以下の点です。
- 手順を上から順に実行すれば動く構成
- 前提条件を明確にする
- 環境ごとの分岐を明示する
- コマンドベースで具体的に記載する
これにより、
「読むドキュメント」ではなく「そのまま実行できるドキュメント」
として機能するREADMEを実現しました
冪等性の担保
ここでは、実際にAnsibleを複数回実行した際に冪等性が担保されていなかった問題に対して、ホスト名(hostname)とFQDNに関する情報を「常に最新の状態で参照できる」ように整備した内容を説明します。
特に、MonitorixやPostfixの設定がホスト名に依存しているため、ホスト名変更後の情報が古いままだと設定値が意図せずズレる問題がありました。
課題
- play開始時に取得されるAnsibleのfacts(例:
ansible_hostname/ansible_fqdn)は、play途中にhostnamectlなどでホスト名を変更しても自動では更新されない - その結果、Monitorixの設定ファイル内の
hostname = {{ ansible_hostname }}が再度実行するとずれてしまう
対応方法
- ホスト名(FQDN)を設定するロール(os-base)で、ホスト名変更処理の直後にfactsを再取得し、
ansible_hostname/ansible_fqdnを最新化する - MonitorixやPostfixは、この更新済みfactsを参照する前提に揃えた(Postfixはコマンド実行で都度取得する方式から、ansible_fqdn参照に統一)
効果
- Monitorixの設定に書き込まれるhostnameが、常に最新のホスト名に揃う
- Postfixのmydomainが、常に最新のFQDNに揃う
- playの再実行や実行順序の違いによって設定値がブレる要因を減らし、「何度実行しても同じ状態に収束する」という冪等性を強化できる
OSロールの再設計
従来のOSロールは責務が大きく、1つのロール内に以下が混在していました。
- OS初期設定(ホスト名・sysctl・swap など)
- 定期実行基盤(cron)
- 証明書更新(dehydrated)
- 監視スクリプト配備(town-monitor)
- アクセス制御(hosts.allow)
この状態だと次の問題が起きます。
- 変更の影響範囲が読みづらい(OS設定を触っただけのつもりが証明書や監視にも影響する)
- 実行順序の依存が見えづらい(cronが必要なロールが、どこでcronを用意しているか分からない)
- 再利用しづらい(OS初期設定だけ適用したい、監視だけ更新したい、がやりづらい)
再設計方法
そこで以下のように改善しました。
- OS関連処理を細分化
- 新規ロールとして分割
- OSロールはそれらをまとめる「ラッパー」として再定義
roles/
└── os/
└── tasks/main.yml (他ロールをimport)
└── os-base/
└── ...
└── cron-base/
└── ...
└── dehydrated/
└── ...
└── town-monitor/
└── ...
└── hosts-allow/
└── ...
分割したロールの役割
1. os-base(OSの基本設定)
【役割】
- sudoの導入・設定
- ホスト名(FQDN)設定
- sysctl(カーネルパラメータ)設定
- swap設定
【分割した理由】
- これらはミドルウェア導入前に必要になりやすい「土台」設定であり、他機能(監視や証明書)と変更頻度・責務が異なる
2. cron-base(cronの共通基盤)
【役割】
- cron実行環境のインストール
- cronサービスの起動・自動起動設定
【分割した理由】
- cronは複数機能(証明書更新・監視)で共通に必要
- 以前は特定ロール(証明書更新側)にcron導入が含まれており、依存関係が分かりづらかったため「共通基盤」として切り出した
3. dehydrated(証明書更新)
【役割】
- dehydrated本体の配置・設定
- 証明書更新を定期実行するためのcronジョブ登録
【分割した理由】
- 証明書更新はOS初期設定とは目的が異なる
- 証明書更新や対象ドメインなど、運用上の変更点が集中するため、独立ロール化した方が保守しやすい
4. town-monitor(内部監視)
【役割】
- 監視用スクリプトの配備
- 監視スクリプトを定期実行するためのcronジョブ登録
【分割した理由】
- 監視は運用機能であり、OS初期設定とは責務が異なる
- 監視項目の追加・変更をOS設定と分離して行えるようにする
5. hosts-allow(アクセス制御)
【役割】
- hosts.allowをテンプレートから生成し、許可ルールを適用
【分割した理由】
- アクセス制御は誤ると接続断に直結するため、変更点を分離する
- OS初期設定や監視と混在させず、責務を明確にする
運用面のポイント
依存関係が明確になる:cron-baseが「定期実行の前提」を提供し、dehydrated/town-monitorは「ジョブ登録」に集中できる
変更の影響範囲が限定される:OS基本設定の変更が証明書更新や監視ロジックに直接混ざらない
部分適用・差分確認がしやすい:目的別にロールを実行でき、レビューもしやすい
Dockerfileの改善
ここでは、Ansibleの実行環境(ansible-controller)とServerspec実行環境(kondate-runner)のDockerfile/コンテナ構成を見直し、「SSH鍵をイメージにコピーしない」方針へ変更した内容をまとめます。
今回発生した問題点
もともとDocker環境では、検証用にplaybook/docker/ssh/配下に鍵を生成し、コンテナ間SSH(controller → target)を成立させる設計でした。一方でAWS/さくらのクラウドでは、ホストOS側の既存鍵(例:~/.ssh/*.pem)をそのまま使う運用が一般的です。
この結果、Dockerfileが鍵のコピーを前提としており、環境によって不要な手順が発生していました。例えば、AWS/さくらでは本来不要な「Docker用鍵の生成」や「コピー前提の設定」が残り、手順が分かりづらかったです。
方針(今回採用した設計)
結論として、秘密鍵はイメージに含めず、ホスト側で管理してコンテナにマウントする方式に統一しました。これにより、Docker/AWS/さくらのクラウドで「鍵の置き場所」と「参照方法」を揃えられます。
ポイントは次の通りです。
秘密鍵はDockerfileでCOPYしない:秘密鍵はホスト側に置き、docker-compose.ymlのvolumesで読み取りマウントする
Ansibleが使う鍵のパスを環境変数で明示する:
ANSIBLE_PRIVATE_KEY_FILEを設定し、Ansible側が「どの鍵を使うか」で迷わない状態にするkondate-runnerは鍵と設定ファイル(ssh config)を分離してマウントする :
/root/.sshを丸ごとマウントせず、鍵は/root/.ssh/keys、設定ファイルは/root/.ssh/configのように分ける例外:Docker検証用の接続先(almalinux-target)だけは公開鍵をauthorized_keysへ配置する
効果
この改善により、鍵の扱いが「ホストで管理し、コンテナは参照する」という構造に統一されました。
その結果、Docker/AWS/さくらのクラウドのどの環境でも設定の考え方が揃い、--private-keyの付け忘れやパス不一致による接続エラーを減らせます。
また、秘密鍵をイメージに含めないため、運用上のリスク(イメージの持ち回りやキャッシュ)も抑えられます。
まとめ・今後の展望
本記事では、これまで作成してきたAnsibleの構成を、Docker / AWS / さくらのクラウドといった複数環境で検証可能な形に仕上げるための設計と改善について紹介しました。
今回の取り組みのポイントは、大きく以下の通りです。
- READMEを整備し、「誰でも同じ手順で検証できる状態」を実現した
- Dockerとクラウド環境で操作感を揃え、環境差分を意識しやすい構造にした
- ホスト名とfactsの扱いを見直し、冪等性のブレを解消した
- OSロールを責務ごとに分割し、依存関係と変更影響を明確化した
- SSH鍵の扱いを統一し、環境ごとの差異と運用リスクを低減した
これらにより、
「構成管理が動く」だけでなく「どの環境でも同じ結果を再現できる」状態
を実現できています。
特に今回のフェーズでは、Ansibleの実装そのものよりも、
- 環境差分をどう扱うか
- 再現性をどう担保するか
- 第三者がどう使うか
といった、実運用を見据えた設計に重点を置いています。
今後は、今回整備した基盤を前提として、より上位レイヤの構成管理へと対象を広げていく予定です。



