Ansible Role ansible_init¶

ansible-init (CLI binary ansinv) is a Linuxfabrik tool that bootstraps and refreshes a working Ansible environment on a workstation: it pulls LFOps and any number of inventory repositories from Git, optionally clones additional roles next to LFOps, and installs the Ansible collections recommended by LFOps.

This role keeps ansinv itself, LFOps, the configured inventories / extra roles and the recommended collections up-to-date. Specifically, it:

Updates ansible_init (ansinv) itself
Updates LFOps
Loads the list of Git repositories containing Ansible inventories
Clones the inventories
Optionally clones the roles to ../roles/
Installs recommended Ansible collections (from LFOps requirements.txt)

Available since LFOps 2.0.0.

Tags¶

ansible_init

Update ansible_init (ansinv) itself.
Update ../lfops.
Load repo list.
Clone the inventories.
Install ansible collections.
Triggers: none.

ansible_init:collections

Install ansible collections.
Triggers: none.

ansible_init:command

Load repo list.
Triggers: none.

Mandatory Role Variables¶

ansible_init__url

URL of the ansinv repo.
Type: String.
Default: none

Example:

# mandatory
ansible_init__url: 'git@example.com:my-ansinv.git'

Optional Role Variables¶

ansible_init__ansible_collections

List of dictionaries of Ansible collections to install.
Subkeys:
- name:
  - Mandatory. Name of the collection.
  - Type: String.
- type:
  - Optional. One of collection, role, or both.
  - Type: String.
  - Default: 'collection'
Type: List of dictionaries.
Default: []

ansible_init__inventories

List of dictionaries of inventories to clone.
Subkeys:
- name:
  - Mandatory. Name of the inventory. Will be used as the folder name.
  - Type: String.
- url:
  - Mandatory. Git, SSH, or HTTP(S) protocol address of the repository.
  - Type: String.
- version:
  - Optional. Git version to checkout.
  - Type: String.
  - Default: 'main'
Type: List of dictionaries.
Default: []

ansible_init__lfops_url

URL of the LFOps repo. Either 'git@github.com:Linuxfabrik/lfops.git' for development purposes, or 'https://github.com/Linuxfabrik/lfops.git' for general access.
Type: String.
Default: 'https://github.com/Linuxfabrik/lfops.git'

ansible_init__roles

List of dictionaries of roles to clone.
Subkeys:
- name:
  - Mandatory. Name of the role. Will be used as the folder name.
  - Type: String.
- url:
  - Mandatory. Git, SSH, or HTTP(S) protocol address of the repository.
  - Type: String.
- version:
  - Optional. Git version to checkout.
  - Type: String.
  - Default: 'main'
Type: List of dictionaries.
Default: []

ansible_init__version

Git version of the ansinv repo to checkout.
Type: String.
Default: 'main'

Example:

# optional
ansible_init__ansible_collections:
  - name: 'community.mysql'
  - name: 'ngine_io.cloudstack'
ansible_init__inventories: []
ansible_init__lfops_url: 'git@github.com:Linuxfabrik/lfops.git'
ansible_init__roles: []
ansible_init__version: 'main'

License¶

The Unlicense

Author Information¶

Linuxfabrik GmbH, Zurich