Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bodsch/ansible-collection-systemd
A collection of Ansible roles to manage systemd configurations.
https://github.com/bodsch/ansible-collection-systemd
ansible ansible-collection ansible-roles automation systemd
Last synced: 1 day ago
JSON representation
A collection of Ansible roles to manage systemd configurations.
- Host: GitHub
- URL: https://github.com/bodsch/ansible-collection-systemd
- Owner: bodsch
- License: apache-2.0
- Created: 2023-08-09T11:01:15.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-06T03:55:44.000Z (21 days ago)
- Last Synced: 2024-09-20T10:36:22.372Z (6 days ago)
- Topics: ansible, ansible-collection, ansible-roles, automation, systemd
- Language: Python
- Homepage:
- Size: 146 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Collection - bodsch.systemd
Documentation for the collection.
## Roles
| Role | | Description |
| :---- | :---- | :---- |
| [bodsch.systemd.coredump](./roles/coredump/README.md) | [][coredump] | configure systemd-coredump |
| [bodsch.systemd.homed](./roles/homed/README.md) | [][homed] | configure systemd-homed |
| [bodsch.systemd.journald](./roles/journald/README.md) | [][journald] | configure systemd-journald |
| [bodsch.systemd.oomd](./roles/oomd/README.md) | [][oomd] | configure systemd-oomd |
| [bodsch.systemd.logind](./roles/logind/README.md) | [][logind] | configure systemd-logind |
| [bodsch.systemd.networkd](./roles/networkd/README.md) | [][networkd] | configure systemd-networkd |
| [bodsch.systemd.resolved](./roles/resolved/README.md) | [][resolved] | configure systemd-resolved |
| [bodsch.systemd.system](./roles/system/README.md) | [][system] | configure systemd-system |
| [bodsch.systemd.timesyncd](./roles/timesyncd/README.md) | [][timesyncd] | configure systemd-timesyncd |
| [bodsch.systemd.user](./roles/user/README.md) | [][user] | configure systemd-user |
[coredump]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/coredump.vml
[homed]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/homed.vml
[journald]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/journald.vml
[oomd]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/oomd.vml
[logind]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/logind.vml
[networkd]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/networkd.vml
[resolved]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/resolved.vml
[system]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/system.vml
[timesyncd]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/timesyncd.vml
[user]: https://github.com/bodsch/ansible-collection-systemd/actions/workflows/user.vml
## Included content
### Modules
| Name | Description |
|:--------------------------|:----|
| [journalctl](./plugins/modules/journalctl.py) | Query the systemd journal with a very limited number of possible parameters |
| [unit_file](./plugins/modules/unit_file.py) | This can be used to create a systemd unit file. The `service`, `timer` and `socket` types are supported. |
## Installing this collection
You can install the memsource collection with the Ansible Galaxy CLI:
```sh
#> ansible-galaxy collection install bodsch.systemd
```
To install directly from GitHub:
```sh
#> ansible-galaxy collection install [email protected]:bodsch/ansible-collection-systemd.git
```
You can also include it in a `requirements.yml` file and install it with `ansible-galaxy collection install -r requirements.yml`, using the format:
```yaml
---
collections:
- name: bodsch.systemd
```
The python module dependencies are not installed by `ansible-galaxy`. They can
be manually installed using pip:
```sh
#> pip install -r requirements.txt
```
## Using this collection
You can either call modules by their Fully Qualified Collection Name (FQCN), such as `bodsch.systemd.remove_ansible_backups`,
or you can call modules by their short name if you list the `bodsch.systemd` collection in the playbook's `collections` keyword:
```yaml
---
- name: remove older ansible backup files
bodsch.systemd.remove_ansible_backups:
path: /etc
holds: 4
```
## Contribution
Please read [Contribution](CONTRIBUTING.md)
## Development, Branches (Git Tags)
The `master` Branch is my *Working Horse* includes the "latest, hot shit" and can be complete broken!
If you want to use something stable, please use a [Tagged Version](https://github.com/bodsch/ansible-collection-systemd/tags)!
## Author
- Bodo Schulz
## License
[Apache](LICENSE)
**FREE SOFTWARE, HELL YEAH!**