Ansible Collection - bodsch.systemd

Documentation for the collection.

Roles

Role		Description
bodsch.systemd.coredump		configure systemd-coredump
bodsch.systemd.homed		configure systemd-homed
bodsch.systemd.journald		configure systemd-journald
bodsch.systemd.oomd		configure systemd-oomd
bodsch.systemd.logind		configure systemd-logind
bodsch.systemd.networkd		configure systemd-networkd
bodsch.systemd.resolved		configure systemd-resolved
bodsch.systemd.system		configure systemd-system
bodsch.systemd.timesyncd		configure systemd-timesyncd
bodsch.systemd.user		configure systemd-user

Included content

Modules

Name	Description
bodsch.systemd.journalctl	Query the systemd journal with a very limited number of possible parameters
bodsch.systemd.unit_file	This can be used to create a systemd unit file. The service, timer and socket types are supported.
bodsch.systemd.systemd_timer	This can be used to create a systemd timer file.

Installing this collection

You can install the memsource collection with the Ansible Galaxy CLI:

#> ansible-galaxy collection install bodsch.systemd

To install directly from GitHub:

#> ansible-galaxy collection install git@github.com:bodsch/ansible-collection-systemd.git

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: bodsch.systemd

The python module dependencies are not installed by ansible-galaxy. They can be manually installed using pip:

#> pip install -r requirements.txt

Using this collection

You can either call modules by their Fully Qualified Collection Name (FQCN), such as bodsch.systemd.coredump, or you can call modules by their short name if you list the bodsch.systemd collection in the playbook's collections keyword:

---
- name: configure systemd coredump
  bodsch.systemd.coredump:
    process_size_max: 32G
    external_size_max: 32G

Examples

bodsch.systemd.journalctl

- name: query the systemd journal
  bodsch.systemd.journalctl:
    identifier: chrony
    lines: 150
  register: journalctl
  when:
    - restarted is defined
    - restarted.failed
    - chrony_query_journald
    - ansible_service_mgr == 'systemd'
  notify:
    - journalctl output

- name: journalctl output
  ansible.builtin.debug:
    msg: "{{ journalctl.stdout }}"
  when:
    journalctl.stdout is defined

bodsch.systemd.systemd_timer

name: create systemd timer file
bodsch.systemd.systemd_timer:
  name: certbot-renew
  unit:
    Description: Run Certbot on specific weekdays
  timer:
    persistent: true
    randomized_delay_sec: "43200"
  schedule:
    weekday: "{{ certbot_cron.weekday | default(['Sat']) }}"
    hour: "{{ certbot_cron.hour | default('2') }}"
    minute: "{{ certbot_cron.minute | default('58') }}"
  install:
    wanted_by: timers.target
  path: "{{ systemd_lib_directory }}"
notify:
  - daemon reload

bodsch.systemd.unit_file

- name: create getty drop-ins
  bodsch.systemd.unit_file:
    name: "getty@tty1"
    state: "present"
    unit_type: "service"
    drop_ins:
      - name: autologin
        state: present
        service:
          ExecStart:
            - ""
            - "{% raw %}-/sbin/agetty -o '-p -f -- \\\\u' --noclear --autologin username %I $TERM{% endraw %}"
          Type: simple

      - name: noclear
        state: absent
        service:
          TTYVTDisallocate: false
  when:
    - ansible_facts.service_mgr == 'systemd'

- name: create nextcloud-cron systemd service
  bodsch.systemd.unit_file:
    name: "nextcloud-cron"
    state: "present"
    unit_type: "service"
    unit_file:
      unit:
        Description: Nextcloud cron.php job
      service:
        User: www-data
        ExecCondition: php -f /var/www/nextcloud/server/occ status --exit-code
        ExecStart: /usr/bin/php -f /var/www/nextcloud/server/cron.php
        KillMode: process
  when:
    - ansible_facts.service_mgr == 'systemd'

- name: create nextcloud-cron systemd timer
  bodsch.systemd.unit_file:
    name: "nextcloud-cron"
    state: "present"
    unit_type: "timer"
    unit_file:
      unit:
        Description: Run Nextcloud cron.php every 5 minutes
      timer:
        OnBootSec: 5min
        OnUnitActiveSec: 5min
        Unit: nextcloud-cron.service
      install:
        WantedBy: timers.target
  when:
    - ansible_facts.service_mgr == 'systemd'

- name: create systemd unit files
  bodsch.systemd.unit_file:
    name: "{{ item.name }}"
    state: "{{ item.state }}"
    unit_type: "{{ item.unit_type }}"
    overwrite: "{{ item.overwrite | default(omit) }}"
    drop_ins: "{{ item.drop_ins | default(omit) }}"
    unit_file: "{{ item.unit_file | default(omit) }}"
  loop:
    "{{ systemd_unit }}"
  loop_control:
    label: "{{ item.name }}"
  register: systemd_unit_file
  ignore_errors: true
  when:
    - systemd_unit | count > 0

Contribution

Please read Contribution

Development, Branches (Git Tags)

The master Branch is my Working Horse includes the "latest, hot shit" and can be complete broken!

If you want to use something stable, please use a Tagged Version!

Author

• Bodo Schulz

License

Apache

FREE SOFTWARE, HELL YEAH!