defaults と vars:上書き順序
Role 変数の明確なインターフェースを設計します。
「defaults と vars:上書き順序」はCoddyKit上の無料DevOps Bootcampレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはDevOps Bootcamp学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 DevOps Bootcampコースには全4レッスンが含まれています。
変数を定義する2つの場所
ロールでは、defaults/main.yml と vars/main.yml の2か所で変数を定義できます。見た目は似ていますが、動作は大きく異なります。
defaults は柔軟に上書きできる
defaults/main.yml の値は、優先順位が最も低い位置にあります。控えめな初期値なので、ほかのほとんどの設定で上書きできます。
# defaults/main.yml
http_port: 80
workers: 4vars は強く適用される
vars/main.yml の値は優先順位が高くなります。ロールが適用を求める固定的な設定であり、上書きは困難です。
# vars/main.yml
config_path: /etc/myappdefaults は公開 API
ユーザーが調整する可能性のあるものはすべて defaults に置きます。「自由に変更してください」という意図が伝わり、使いやすく再利用可能なロールを設計できます。
vars は内部定数
vars は、ロールの動作に必要で、ユーザーが変更すべきでない値に限定します。たとえば内部パスや固定のパッケージ名などです。
default は簡単に上書きできる
ユーザーは group_vars、host_vars、play、またはコマンドラインから default を上書きできます。最も単純な上書きがすぐに適用されます。
roles:
- role: web
vars:
http_port: 8080vars の値の上書きは難しい
ロールの vars は group_vars、host_vars、play vars よりも優先されます。それを上回るのはコマンドラインの extra-vars だけなので、vars は慎重に使います。
Extra Vars は常に優先される
コマンドラインで -e を使って渡す変数は、ロールの vars を含むほかのすべての変数ソースより優先されます。最終的な上書き手段です。
ansible-playbook site.yml -e http_port=9090優先順位のイメージ
優先順位の階段を覚えておきましょう。最下位が defaults、次にインベントリと play vars、その上にロールの vars、最上位が extra-vars です。
設計のヒント
ほとんどの場合は defaults を優先します。値を本当に固定する必要がある場合だけ vars を使いましょう。柔軟なロールはチームにとって扱いやすいものです。
defaults をドキュメント化する
defaults/main.yml の各値にコメントを付けます。ユーザーがこれらを調整するため、分かりやすい説明があれば、ロール自体が自動化のドキュメントになります。
クイックチェック
ユーザーが最も簡単に上書きできるのは、どのファイルか考えてみましょう。
まとめ
ユーザーが上書きする調整可能な値には defaults を使い、固定された内部定数には vars を使います。CLI の extra-vars はすべてに優先します。🎚️
よくある質問
「defaults と vars:上書き順序」レッスンは無料ですか?
はい。「defaults と vars:上書き順序」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、DevOps Bootcampコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 DevOps Bootcampコースには全4レッスンが含まれています。
「defaults と vars:上書き順序」で何を学びますか?
Role 変数の明確なインターフェースを設計します。 ブラウザで直接実行するハンズオンコードでDevOps Bootcampを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
DevOps Bootcampを始めるのに経験は必要ですか?
事前経験は必要ありません。CoddyKitのDevOps Bootcampは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。
「defaults と vars:上書き順序」レッスンにはどのくらい時間がかかりますか?
ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このDevOps Bootcampレッスンでコードを書いて実行できますか?
はい。すべてのDevOps Bootcampレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- meta/main.yml における Role の依存関係
- defaults と vars:上書き順序
- 実行時の include_role と import_role
- allow_duplicates と Role の冪等性