wiki/content/docs/ansible/common/_index.md
2024-01-09 23:07:43 +01:00

2.5 KiB

+++ title = 'Ansible: Common' linkTitle = 'Common' date = 2024-01-09T19:49:13+01:00 next = "/docs/ansible/services" prev = "/docs/ansible/core" weight = 2 +++

{{< callout type="warning" >}} Note: The documentation for this collection may currently be incomplete or even out of date. This collection is still a WIP, expect bugs and other issues arising. {{< /callout >}}

Introduction

This collection includes common automation utilities that are used in the deployment of various Lunivity Circle Services.
Common utilities include any kinds of roles and playbooks that are responsible for the initial setup of a host.

Getting Started

Dependencies

Before you begin, ensure you have the following prerequisites:

  • Ansible installed on your ansible host.

Installation

{{< tabs items="CLI,requirements.yml" >}} {{< tab >}} Using Command Line Interface (CLI):

# install collection from source
$ ansible-galaxy collection install git+https://gitpot.dev/lunivity/ansible-common.git

# install collection from tagged release 1.0.0 (currently unavailable)
$ ansible-galaxy collection install git+https://gitpot.dev/lunivity/ansible-common.git,1.0.0

{{< /tab >}} {{< tab >}} Using a requirements.yml File:

  1. Create a file named requirements.yml in your workspace.
  2. Add the following content to your requirements.yml file:
 collections:
  - name: https://gitpot.dev/lunivity/ansible-common.git
    type: git
    version: latest
  • Install the collection by running the following command in your workspace:
ansible-galaxy collection install -r /path/to/requirements.yml

{{< /tab >}} {{< /tabs >}}

Usage

  • To use the collection in your Ansible playbooks, include it like this:
---
- name: Example Playbook
  hosts: localhost
  tasks:
    - name: Include role from Lunivity
      import_role:
        name: lunivity.common.<role>

Advanced Usage

There are multiple roles included in this collection. To view their advanced usage options, visit one of the cards below.

Repository

You can find this project's repository here.

Contributions

You're welcome to contribute to this website if you have a Lunivity account (see Gitpot's homepage for details if registrations aren't open yet).

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). Refer to the LICENSE file for more details.