lmn-client/doc/updater.md
2026-07-08 12:12:35 +02:00

1.7 KiB

Updater

Description / Use Cases

The updater service allows clients to be updated automatically. Changes in the Ansible playbook or inventory are applied automatically to all configured clients.

Requirements

  • The Ansible playbook must be available via a public Git repository.
  • Hosts in the inventory must be specified by their hostname, not by their IP address.

Activation / Default

To install the updater service on clients, set the variable misc_updater_repository to a valid Git repository URL. If not set (default: false), the service will not be installed.

To enable the updater service on clients, set the variable misc_updater_autostart to true.

Configuration / Variables

  • misc_updater_inventory
    Name of the Ansible inventory file.
    Type: String

  • misc_updater_inventory_password
    Password for the inventory file if it is protected or encrypted via Ansible Vault.
    Type: String

  • misc_updater_repository
    URL of the public Git repository.
    Type: String

  • misc_updater_branch
    Name of the Git branch.
    Type: String

  • misc_updater_autostart
    Flag to enable the updater service. The updater starts 5 minutes after boot.
    Type: Boolean
    Values:

    • false — default
    • true

Example

All computers receive the updater service. Automatic updates are installed on all computers except those in the teacherlaptops group.

inventory.yml
all:
  vars:
    misc_updater_inventory: inventory-myschool.yml
    misc_updater_inventory_password: top-secret
    misc_updater_repository: https://git.example.com/it-team/lmn-client.git
    misc_updater_branch: myschool
    misc_updater_autostart: true

teacherlaptops:
  vars:
    misc_updater_autostart: false