61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
# 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
|
|
```
|