An open API service indexing awesome lists of open source software.

https://github.com/roles-ansible/ansible_collection_linux

Ansible Collection l3d.linux
https://github.com/roles-ansible/ansible_collection_linux

ansible collection

Last synced: 6 months ago
JSON representation

Ansible Collection l3d.linux

Awesome Lists containing this project

README

          

[![collection l3d.linux](https://ansible.l3d.space/svg/l3d.linux_ansible-collection_collection.svg)](https://galaxy.ansible.com/ui/repo/published/l3d/linux/)
[![Maintainance](https://ansible.l3d.space/svg/l3d.linux_maintainance_collection.svg)](https://ansible.l3d.space/#l3d.linux)
[![License](https://ansible.l3d.space/svg/l3d.linux_license_collection.svg)](LICENSE)

Ansible Collection - l3d.linux
============================

This is the Ansible Collection ``l3d.linux``. A collection to to common linux tasks like installing linux packages.

## Ansible Roles in l3d.linux
- [![l3d.linux.packages](https://ansible.l3d.space/svg/l3d.linux.packages_ansible-role.svg)](https://github.com/roles-ansible/ansible_role_packages.git) - Ansible role to install some base packages on your linux systems
- [![l3d.linux.resolvconf](https://ansible.l3d.space/svg/l3d.linux.resolvconf_ansible-role.svg)](https://github.com/roles-ansible/ansible_role_resolvconf.git) - Ansible role to manage the ``/etc/resolv.conf`` file.
- [![l3d.linux.librewolf](https://ansible.l3d.space/svg/l3d.linux.librewolf_ansible-role.svg)](https://github.com/roles-ansible/ansible_role_resolvconf.git) - Ansible role to install librewolf.

## Ansible Modules in l3d.linux
- [l3d.linux.extrepo](https://github.com/roles-ansible/ansible_collection_linux/blob/main/plugins/modules/EXTREPO.md) - Wrapper for extrepo

## Using this Collection
You can install the collection using ansible-galaxy by running:
```bash
ansible-galaxy collection install l3d.linux:1.2.5
```

Remember you can to Upgrade to the latest version of the l3d.linux collection using the ``--upgrade`` parameter:
```bash
ansible-galaxy collection install l3d.linux --upgrade
```

Or you could clone this collection in your local ansible project for example to ``collections/ansible_collections/l3d.linux/``. Make sure you checkout [git submodules](https://git-scm.com/docs/git-submodule) too. Example:
```
# Clone git Repo with submodules to specified path
git clone --recursive https://github.com/roles-ansible/ansible_collection_linux.git collections/ansible_collections/l3d/linux/

# change directory
cd collections/ansible_collections/l3d.linux/

# optionally init git submodules
git submodule update --init --recursive

# optionally install all requirements
ansible-galaxy collection install -r requirements.yml --upgrade
```

You can also list a collection in ``requirements.yml``:
```yaml
---
collections:
- name: l3d.linux
version: ">=1.2.5"
```

## Include roles in your playbook
Example Playbook using the l3d.linux.packages and l3d.linux.resolvconf role:
```yaml
---
- name: "Install NTP and librewolf from collection l3d.linux and configure resolve.conf"
hosts: desktop.example.com
roles:
- {role: l3d.linux.packages, tags: pakages}
- {role: l3d.linux.resolvconf, tags: resolvconf}
- {role: l3d.linux.librewolf, tags: librewolf}
vars:
packages__install_advanced: true
packages__install_python: true
packages__install_cli: true
packages__install_desktop: true
submodules_versioncheck: true
```

## Requirements
The roles in this collection using the ``community.general`` ansible Collections.