Gitlab Profile

Dokumentacja techniczna

Minimalny pipeline CI/CD dla projektów GitLab Profile (strona profilowa GitLab). Obsługuje walidację statyczną, deployment na środowiska GitLab oraz wersjonowanie.

Użycie

W projekcie dodaj do .gitlab-ci.yml:

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

variables:
  PROJECT_TYPE: gitlab-profile

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)
publish     → 📍 Publish Version    (needs: Set Version)

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, unit-test i publish mają when: never.

Zależności 📍 Publish Version

Job	Wymagany
🕵 Set Version	✅ (artifacts)