README.md

Plumbing

---

Used for minimize duplicate the CI/CD Boilerplate-Code. Like Workflows (GitHub Actions) and GitHub App configurations.

Workflows

Workflow	description
reusable-ansible-galaxy-push.yaml	Using robertdebock/galaxy-action for publish a Ansible Role to Ansible Galxy.
reusable-ansible-molecule.yaml	Start a simple Molecule test run by using the gofrolist/molecule-action action.
reusable-automerge.yaml	Using pascalgn/automerge-action for better Merge Request handling.
reusable-mkdocs.yaml	Publish a mkdocs based Documentation as GitHub Page.
reusable-pre-commit.yaml	Call pre-commit for a minimal static tests set, like liter etc.
reusable-release-cd-refresh-master.yml	Refresh the current master branch, with the Revision from the Latest published Release, so the master/main branch will be present the latest Released version.
reusable-release-drafter.yml	Will be use release-drafter/release-drafter for updating the current "Draft" Release with a Changelog.
reusable-sphinx.yaml	Build and Publish a Sphinx Documentation as GitHub Page.
reusable-stale.yaml	Mark old or inactive issues and close then, used actions/stale for this work.
reusable-trivy.yaml	Scan the GitRepo by using aquasecurity/trivy-action.
reusable-tf-lint.yaml	Use terraform-linters/setup-tflint for Lint terraform sources.

Probot configuration

Collection of common Configurations for Project Management and CI/CD.
For Using in other GitHub Projects, having a reusable set of Probot Configuration Repository, more information at probot.github.io.

probot	git	description
boring-cyborg	kaxil/boring-cyborg	Different actions like, automatically label Pull Request
release-drafter	toolmantim/release-drafter	Creates a Human Readable Release Change Log ((deprecated), please use the Workflow Implementation).
renovate		Using renovate for keep dependencies in sync.
settings	probot/settings	Configure GitHub Projects by Source.

For More information take a look to the GH Page, gh-plumbing.

Development

Use the asdf package manager.

asdf install

Workflows

For local testing you can use nektos/act, run the GitHub Actions locally.

act push -j static -W .github/workflows/build-static-tests.yaml

Will be start the at your system.

Documentation

virtualenv ~/.vens/development

source ~/.vens/development/bin/activate
pip install -r requirements-dev.txt

mkdocs serve -a localhost:8001

Open localhost:8001 for take a look to the latest documentation, created with mkdocs.

Task

Use go-task/task as pre-configured command sets.

task -l  

task: Available tasks for this project:
* mkdocs:start:             mkdocs serve docs
* pre-commit:install:       install pre-commit into current project
* pre-commit:start:         run pre-commit with all files

shared tasks from nolte/taskfiles

Links

• nolte/cookiecutter-gh-project for templating.