Ansible Collection - bodsch.scm

This collection aims to provide a set of small Ansible modules and helper functions.

supported operating systems

• Arch Linux
• Debian based
  • Debian 11 / 12 / 13
  • Ubuntu 22.04 / 24.04 / 26.04

Requirements & Dependencies

• python-dateutil

pip install python-dateutil

Contribution

Please read Contribution

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!

---

Roles

Role	Build State	Description
bodsch.scm.forgejo		Ansible role to install and configure forgejo.
bodsch.scm.forgejo_runner		Ansible role to install and configure forgejo-runner
bodsch.scm.opengist		Ansible role to install and configure opengist

Included content

Modules

Name	Description
bodsch.scm.github_checksum	Fetches a checksum of a GitHub project and returns it.
bodsch.scm.github_latest	Fetches the latest version of a GitHub project and returns it.
bodsch.scm.github_releases	Fetches the releases version of a GitHub project and returns the download urls.
bodsch.scm.forgejo_admin_user	Manage Forgejo admin users.
bodsch.scm.forgejo_auth	Manage Forgejo LDAP authentication entries.
bodsch.scm.forgejo_cli	Register Forgejo runners using the Forgejo CLI.
bodsch.scm.forgejo_migrate	Migrate a Forgejo database. deprecated
bodsch.scm.forgejo_runner	Register a Forgejo Runner on a Forgejo Server.
bodsch.scm.forgejo_users	Manage Forgejo users

Installing this collection

You can install the memsource collection with the Ansible Galaxy CLI:

#> ansible-galaxy collection install bodsch.scm

To install directly from GitHub:

#> ansible-galaxy collection install git@github.com:bodsch/ansible-collection-scm.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:

---
collections:
  - name: bodsch.scm

The python module dependencies are not installed by ansible-galaxy. They can be manually installed using pip:

#> pip install -r requirements.txt

Using this collection

You can either call modules by their Fully Qualified Collection Namespace (FQCN), such as bodsch.scm.github_latest, or you can call modules by their short name if you list the bodsch.scm collection in the playbook's collections keyword:

---
- name: get latest release
  delegate_to: localhost
  become: false
  run_once: true
  bodsch.scm.github_latest:
    project: scm
    repository: alertmanager
    user: "{{ lookup('env', 'GH_USER') | default(omit) }}"
    password: "{{ lookup('env', 'GH_TOKEN') | default(omit) }}"
  register: _latest_release

Contribution

Please read Contribution

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!

Author

• Bodo Schulz

License

Apache

FREE SOFTWARE, HELL YEAH!