La Suite Territoriale Ansible Collection

Install

To install the collection, add a galaxy_requirements.yml file to your ansible code containing :

collections:
  - name: https://github.com/suitenumerique/st-ansible.git
    type: git
    version: "1"

Then use ansible-galaxy install -r galaxy_requirements.yml.

Usage

Roles

The collection contains the following roles:

• suitenumerique.st.podman
• suitenumerique.st.messages
• suitenumerique.st.drive
• suitenumerique.st.keycloak
• suitenumerique.st.alloy
• suitenumerique.st.restic

Development

Dependencies

Create a virtualenv using:

python3 -m virtualenv ./venv

And activate it:

source ./venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Building locally

Before building, run:

make docs

to update the documentations and propagate the default values to roles//defaults from the argument_specs.yml files

Then build:

make build

This will output a line with the location of the built file: Created collection for suitenumerique.st at <path>/suitenumerique-st-<version>.tar.gz

Using the locally built collection

In your consumer repository's galaxy_requirements.yml, overwrite the collections key:

collections:
  - name: <path>/suitenumerique-st-<version>.tar.gz
    version: <version>
    type: file

and run

ansible-galaxy install -r galaxy_requirements.yml --force

to forcefully update the dependency. You can then repeat the make docs, make build and the previous update command to update the galaxy collection.

Licensing

This codebase is under MIT License.

See LICENSE for full text.