https://github.com/xebis/ansible-collection
This Ansible collection provides a set of roles designed for configuring Kubuntu desktop and Ubuntu server environments.
https://github.com/xebis/ansible-collection
ansible ansible-collection apt cac computer-config kubuntu kubuntu2404 pc ubuntu ubuntu2404
Last synced: 7 months ago
JSON representation
This Ansible collection provides a set of roles designed for configuring Kubuntu desktop and Ubuntu server environments.
- Host: GitHub
- URL: https://github.com/xebis/ansible-collection
- Owner: xebis
- License: mit
- Created: 2025-03-15T21:25:41.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-10T17:53:04.000Z (7 months ago)
- Last Synced: 2025-06-10T19:00:59.021Z (7 months ago)
- Topics: ansible, ansible-collection, apt, cac, computer-config, kubuntu, kubuntu2404, pc, ubuntu, ubuntu2404
- Language: Jinja
- Homepage:
- Size: 17.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Collection
This Ansible collection provides a set of roles designed for configuring Kubuntu desktop and Ubuntu server environments.
## Features
### Roles
| Role | Description | Dependencies |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------ |
| [xebis.ansible.apt](roles/apt/README.md) | Deb package updates and upgrades using the apt package manager. Can optionally clean up unused packages and reboot the system if required. | `xebis.ansible.system` |
| [xebis.ansible.nftables_firewall](roles/nftables_firewall/README.md) | nftables firewall | `xebis.ansible.apt` |
| `xebis.ansible.openssh_server` | Installs OpenSSH server and provides `Restart ssh` handler. | `xebis.ansible.apt` |
| [xebis.ansible.system](roles/system/README.md) | System-related tasks such as reboot handler or reboot when required handler. | |
| [`xebis.ansible.users`](roles/users/README.md) | Ansible role for managing system users. | `xebis.ansible.openssh_server` |
## Installation and Configuration
Add to `requirements.yaml`:
```yaml
---
collections:
- name: git+https://github.com/xebis/ansible-collection.git,main
```
Install dependencies:
```shell
ansible-galaxy collection install -r requirements.yaml
```
## Usage
Create an Ansible playbook:
```yaml
---
- hosts: all
roles:
- role: xebis.ansible.apt
vars:
autoclean: true
autoremove: true
cache_valid_time: 3600
purge: true
upgrade: "full"
```
Refer to the example playbook [test.yaml](test.yaml) for additional inspiration.
Run the Ansible playbook:
```shell
ansible-playbook -i localhost, playbook.yaml
```
## Contributing
### Development
```shell
GALAXY_BUILD_OUTPUT=$(ansible-galaxy collection build --force)
ansible-galaxy collection install --force "${GALAXY_BUILD_OUTPUT##* }"
ansible-playbook test.yaml -i localhost, -kK
```
## Credits and Acknowledgments
- Martin Bružina - Author
## Copyright and Licensing
- MIT License
Copyright © 2025 Martin Bružina