template Module と .j2 ファイル
レンダリングしたファイルをホストに配置します。
「template Module と .j2 ファイル」はCoddyKit上の無料DevOps Bootcampレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはDevOps Bootcamp学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 DevOps Bootcampコースには全4レッスンが含まれています。
静的ファイルだけでは不十分
copyモジュールはファイルを変更せずに配置します。しかし設定ファイルでは、サーバーごとにポートやホスト名が異なることが多く、静的なコピーだけでは対応できません。🤔
templateモジュールを使う
templateモジュールは、まずJinja2を通してファイルをレンダリングし、変数を埋め込んでから、結果をホストにコピーします。
- name: Deploy config
template:
src: nginx.conf.j2
dest: /etc/nginx/nginx.conf.j2の慣例
テンプレートのソースファイルは、Jinja2であることを示すために.j2で終わらせます。これは必須の規則ではなく慣例ですが、誰もがこれに従っています。
srcとdest
srcはコントロールノード上の.j2ファイルを指し、destは管理対象ホスト上の最終的なパスを指定します。
template:
src: app.conf.j2
dest: /etc/app/app.confテンプレートの配置場所
Ansibleはデフォルトで、playbookの隣またはrole内にあるtemplatesディレクトリからテンプレートを探します。パスの接頭辞は必要ありません。
templates/
nginx.conf.j2
site.yml最小限のテンプレート
.j2ファイル内では、通常のテキストはそのまま残り、{{ }}マーカーが置き換えられます。ここでは、ポート変数が実際の数値になります。
listen {{ http_port }};
server_name {{ domain }};ファイル権限を設定する
copyと同様に、templateではowner、group、modeを指定できるため、レンダリングされたファイルを正しい所有者と権限で配置できます。
template:
src: app.conf.j2
dest: /etc/app.conf
mode: "0644"書き込む前に検証する
validateオプションを使うと、インストールする前にレンダリング済みファイルに対して検証コマンドを実行できます。そのため、壊れた設定が配置されることはありません。
template:
src: sshd.j2
dest: /etc/ssh/sshd_config
validate: "sshd -t -f %s"テンプレートは冪等です
レンダリング結果がホスト上の既存ファイルと一致する場合、templateはokを報告し、何も変更しません。何度でも安全に実行できます。
変更時にhandlerへnotifyする
templateとnotifyを組み合わせると、設定ファイルが実際に変更された場合にのみサービスを再起動できます。最適な組み合わせです。
template:
src: nginx.conf.j2
dest: /etc/nginx/nginx.conf
notify: restart nginxtemplateとcopyの違い
どの場所でもファイルが同じ場合はcopyを使い、ホストごとに内容の一部を変える必要がある場合はtemplateを使います。
クイックチェック
サーバーごとにポートが異なる設定ファイルが必要です。どのモジュールが適していますか。
まとめ
templateモジュールについて学びました。Jinja2で.j2ファイルをレンダリングし、destに配置して権限を設定し、冪等性も保ちます。✨
よくある質問
「template Module と .j2 ファイル」レッスンは無料ですか?
はい。「template Module と .j2 ファイル」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、DevOps Bootcampコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 DevOps Bootcampコースには全4レッスンが含まれています。
「template Module と .j2 ファイル」で何を学びますか?
レンダリングしたファイルをホストに配置します。 ブラウザで直接実行するハンズオンコードでDevOps Bootcampを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
DevOps Bootcampを始めるのに経験は必要ですか?
事前経験は必要ありません。CoddyKitのDevOps Bootcampは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「template Module と .j2 ファイル」レッスンにはどのくらい時間がかかりますか?
ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このDevOps Bootcampレッスンでコードを書いて実行できますか?
はい。すべてのDevOps Bootcampレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- template Module と .j2 ファイル
- Jinja2 の変数と式
- テンプレート内のループと if ブロック
- フィルター:default、join、upper