Ansible Collection - vladgh.system

Ansible collection that holds roles, that can be used to configure common system services.

Using this collection

Installing the Collection from Ansible Galaxy

Install it with the Ansible Galaxy CLI:

ansible-galaxy collection install vladgh.system  --upgrade

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

---
collections:
  - name: vladgh.system

Using the GitHub repository and branch

collections:
  - name: https://github.com/vladgh/ansible-collection-vladgh-system
    version: main
    type: git

Install the requirements for playbooks

ansible-galaxy install --verbose --force --role-file ~/.ansible/collections/ansible_collections/vladgh/system/requirements.yml

Roles

---
- name: Common
  hosts: all
  become: true
  tasks:
    - name: Include common role
      ansible.builtin.include_role:
        name: vladgh.system.common

Playbooks

Before using the playbooks, install the required external roles and collections (modify to your own collections installation path)

ansible-galaxy install --verbose --force --role-file ~/.ansible/collections/ansible_collections/vladgh/system/collection-requirements.yml`

Import playbooks

---
- import_playbook: vladgh.system.ansible

See Ansible using collections in a playbook for more details.

Changelog & Releases

This repository keeps a change log using GitHub's releases functionality.

Releases are based on Semantic Versioning, and use the format of MAJOR.MINOR.PATCH. The version will be incremented based on the following:

• MAJOR: Incompatible or major changes
• MINOR: Backwards-compatible new features and enhancements
• PATCH: Backwards-compatible bugfixes and package updates

Contribute

Contributions are always welcome! Please read the contribution guidelines and the code of conduct.

License

Licensed under the Apache License, Version 2.0. See LICENSE file.