29.3. systemd RHEL システムロールを使用した systemd ユニットのデプロイ

手順

1. カスタム systemd ユニットファイルの内容を使用して Jinja2 テンプレートを作成します。たとえば、次のように、サービスの内容を含む ~/example.service.j2 ファイルを作成します。

   {{ ansible_managed | comment }}
   [Unit]
   Description=Example systemd service unit file
   
   [Service]
   ExecStart=/bin/true

   ファイル名には、<name>.<unit_type>.j2 という命名規則を使用します。たとえば、example.service ユニットを作成するには、ファイルに example.service.j2 という名前を付ける必要があります。このファイルを Playbook と同じディレクトリーに配置します。

2. 次の内容を含む Playbook ファイル (例: ~/playbook.yml) を作成します。

   ---
   - name: Managing systemd services
     hosts: managed-node-01.example.com
     tasks:
       - name: Deploy, enable, and start a custom systemd service
         ansible.builtin.include_role:
           name: rhel-system-roles.systemd
         vars:
            systemd_unit_file_templates:
              - example.service.j2
            systemd_enabled_units:
              - example.service
            systemd_started_units:
              - example.service

   Playbook で使用されるすべての変数の詳細は、コントロールノードの /usr/share/ansible/roles/rhel-system-roles.systemd/README.md ファイルを参照してください。

3. Playbook の構文を検証します。

   $ ansible-playbook --syntax-check ~/playbook.yml

   このコマンドは構文を検証するだけであり、有効だが不適切な設定から保護するものではないことに注意してください。

4. Playbook を実行します。

   $ ansible-playbook ~/playbook.yml