Core Ansible Roles and Playbooks
Find a file
2024-03-05 15:16:16 +01:00
collections Update requirements.yml 2024-01-06 17:47:21 +01:00
docs/img New Readme 2024-01-06 18:44:29 +01:00
meta Initial Commit 2024-01-06 15:33:26 +01:00
plugins Initial Commit 2024-01-06 15:33:26 +01:00
roles [a] add warning at top of file 2024-03-05 15:16:16 +01:00
ansible.cfg Initial Commit 2024-01-06 15:33:26 +01:00
galaxy.yml Initial Commit 2024-01-06 15:33:26 +01:00
LICENSE.md Initial Commit 2024-01-06 15:33:26 +01:00
README.md [c] Fix Contributions Error in README 2024-03-05 09:13:15 +01:00

Ansible Collection - Core

License - GPLv3

Table of Contents

Introduction

This collection includes core automation utilities that are used in the deployment of various Lunivity Circle Services.
Core utilities include any kinds of roles and playbooks that are responsible for installing dependencies for services, or other general automations.

Getting Started

Dependencies

Before you begin, ensure you have the following prerequisites:

  • Ansible installed on your ansible host.

Installation

Using Command Line Interface (CLI)

  • To install this Ansible collection using the CLI, follow these steps:
# install collection from source
$ ansible-galaxy collection install git+https://gitpot.dev/lunivity/ansible-core.git

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

Using a Requirements 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-core.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

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.core.<role>

Additional Documentation

For more detailed documentation, including advanced usage and customization options, please refer to the docs.

About

Author: Sangelo

Creation date: January 06, 2024

Contributions

You're welcome to contribute to this Ansible Collection 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.