推奨ディレクトリ構成
Playbook、インベントリ、varsの配置場所を学びます
「推奨ディレクトリ構成」はCoddyKit上の無料Ansible Academyレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはAnsible Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Ansible Academyコースには全4レッスンが含まれています。
構成が重要な理由
プロジェクトが大きくなると、ファイルが分散して管理が難しくなります。標準的なディレクトリ構成があれば、すべてのファイルがどこにあるかをチーム全員が把握できます。📁
site.ymlがエントリーポイントになります
慣例として、site.ymlはインフラ全体をまとめ、ほかのファイルを組み込む最上位のplaybookです。
# site.yml
- import_playbook: webservers.yml
- import_playbook: dbservers.ymlルートにinventoryを置きます
inventoryファイル（またはディレクトリ）は最上位付近に置きます。これにより、隣にあるplaybookが管理対象のホストを常に把握できます。
myproject/
inventory
site.yml機能ごとにplaybookを分けます
大きなplayをwebservers.ymlやdbservers.ymlのような目的別のファイルに分割し、それらをsite.ymlからまとめて組み込みます。
group_varsディレクトリ
group_varsディレクトリには、ホストグループ全体に適用する変数を置きます。グループ名に基づいて自動的に読み込まれます。
group_vars/
webservers.yml
dbservers.ymlhost_varsディレクトリ
host_varsディレクトリは個々のマシンに対して同じ役割を果たします。各ホストの名前を付けたファイルを1つずつ用意します。
host_vars/
web01.example.com.ymlrolesディレクトリ
再利用可能な自動化処理はrolesディレクトリの下に置きます。playで名前を指定してroleを参照すると、Ansibleはまずここを探します。
roles/
common/
nginx/カスタムlibraryとプラグイン
libraryフォルダーにはカスタムモジュールを置き、module_utilsやfilter_pluginsには共有ヘルパーコードを置きます。Ansibleはこれらを自動的に検出します。
ansible.cfgを近くに置きます
プロジェクトのルートにansible.cfgを配置します。Ansibleは現在のディレクトリから設定を読み込むため、設定をプロジェクト単位で管理できます。
# ansible.cfg
[defaults]
inventory = ./inventory
roles_path = ./roles1つのリポジトリで全体を把握できます
この構成なら、git cloneを1回行うだけで、playbook、inventory、変数、roleをすべて一貫した構成でチームメンバーに渡せます。🎯
全体の基本構成
公式ドキュメントが推奨する基本構成を示します。すべてのファイルを暗記するのではなく、構成の形を覚えてください。
myproject/
ansible.cfg
inventory
site.yml
group_vars/
host_vars/
roles/簡単な確認
プロジェクト全体に対する、慣例的な最上位のエントリーポイントはどのファイルですか。
まとめ
標準的な構成を学びました。1つのリポジトリに、site.ymlとinventory、group_vars、host_vars、rolesをまとめます。予測しやすい構成はチームとともに拡張できます。✅
よくある質問
「推奨ディレクトリ構成」レッスンは無料ですか？
はい。「推奨ディレクトリ構成」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Ansible Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Ansible Academyコースには全4レッスンが含まれています。
「推奨ディレクトリ構成」で何を学びますか？
Playbook、インベントリ、varsの配置場所を学びます ブラウザで直接実行するハンズオンコードでAnsible Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Ansible Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのAnsible Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「推奨ディレクトリ構成」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このAnsible Academyレッスンでコードを書いて実行できますか？
はい。すべてのAnsible Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。