Ansible Role

Dokumentacja techniczna

Pipeline CI dla projektów Ansible Role. Skupiony wyłącznie na walidacji statycznej — uruchamia lint, składnię YAML i shellcheck, a następnie wersjonuje projekt.

Użycie

W projekcie dodaj do .gitlab-ci.yml:

include:
  - project: pl.rachuna-net/flows/gitlab
    file: pipelines/ansible-role/.gitlab-ci.yml
    ref: main

variables:
  PROJECT_TYPE: ansible-role

Joby i stagi

Przepływ CI (branch != main)

.pre        → 🕵 Set Version
validate    → 🔍 Analyze Conventional Commits
            → 🕵 yamllint           (tylko gdy zmienił się *.yml/*.yaml)
            → 🐚 shellcheck         (tylko gdy zmienił się *.sh/*.sh.yml)
            → 🧩 ansible-lint
publish     → 📍 Publish Version    (needs: ansible-lint + Set Version + validate joby)

Tabela jobów

Job	Nazwa emoji	Stage	CI	CD
versioning (Set Version)	🕵 Set Version	.pre	✅	❌
conventional-commits	🔍 Analyze Conventional Commits	validate	✅	❌
yamllint	🕵 yamllint	validate	✅*	❌
shellcheck	🐚 shellcheck	validate	✅*	❌
ansible-lint	🧩 ansible-lint	validate	✅	❌
dependency	📦 dependency	dependency	❌	❌
build	🚀 build	build	❌	❌
deployment	💥 deployment	deployment	❌	❌
unit-test	🧪 unit-test	tests	❌	❌
publish	🌐 publish	publish	❌	❌
versioning (Publish Version)	📍 Publish Version	publish	✅	❌

* tylko gdy zmienił się odpowiedni typ pliku względem main

Pipeline nie obsługuje CD — environment-deployment-prepare, trigger-deployment, dependency, deployment, build, unit-test i publish mają when: never.

Ansible-specyficzny job

🧩 ansible-lint (validate)

Statyczna analiza kodu Ansible. Uruchamia ansible-lint --force-color . na całym repozytorium.

Zmienne:

Zmienna	Wartość	Opis
ANSIBLE_HOST_KEY_CHECKING	false	Wyłączenie sprawdzania host key
ANSIBLE_FORCE_COLOR	true	Kolorowy output

Zależności 📍 Publish Version

Job	Wymagany
🧩 ansible-lint	✅ (required)
🕵 Set Version	✅ (artifacts)
🔍 Analyze Conventional Commits	optional
🕵 yamllint	optional
🐚 shellcheck	optional