Gitlab Pipeline

Dokumentacja techniczna

Pipeline CI/CD dla repozytorium flows/gitlab (tego repozytorium). Obsługuje walidację statyczną, testy jednostkowe szablonów CI za pomocą conftest i deployment pipeline’ów na środowiska GitLab.

Użycie

W projekcie dodaj do .gitlab-ci.yml:

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

variables:
  PROJECT_TYPE: gitlab-pipelines

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)
tests       → 🧪 unit-test
publish     → 📍 Publish Version    (needs: Set Version + unit-test, artifacts)

Przepływ CD (źródło: api/push/web)

.pre        → 🔧 Prepare Dynamic Deployment
deployment  → 🚀 Trigger Deployment  → child pipeline:
                                          💥 Deployment:<ENV_NAME>  (per środowisko)

Tabela jobów

Job	Nazwa emoji	Stage	CI	CD
versioning (Set Version)	`🕵 Set Version`	`.pre`	✅	✅
environment-deployment-prepare	`🔧 Prepare Dynamic Deployment`	`.pre`	❌	✅
conventional-commits	`🔍 Analyze Conventional Commits`	validate	✅	❌
yamllint	`🕵 yamllint`	validate	✅*	❌
shellcheck	`🐚 shellcheck`	validate	✅*	❌
dependency	`📦 dependency`	dependency	❌	❌
build	`🚀 build`	build	❌	❌
trigger-deployment	`🚀 Trigger Deployment`	deployment	❌	✅
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 ** uruchamia się w child pipeline (CI_PIPELINE_SOURCE == "parent_pipeline")

Joby dependency, build i publish mają when: never.

Pipeline-specyficzny job

`🧪 unit-test` (tests)

Testy jednostkowe szablonów GitLab CI przy użyciu conftest (Open Policy Agent):

# before_script
apt-get install -y shellcheck

# script
./tools/unit-test/unit-test.sh

Obraz: registry.gitlab.com/pl.rachuna-net/artifacts/containers/conftest:1.1.0

Zależności `📍 Publish Version`

Job	Wymagany
`🕵 Set Version`	✅ (artifacts)
`🧪 unit-test`	✅ (artifacts)