# blue-ci-cd.yml Het bestand ligt in de root van de commit die de pipeline start. De vorm lijkt op GitLab CI: stages, jobs, needs en rules. Elke job draait in het image dat erbij staat. ```yaml stages: [test, build] variables: CGO_ENABLED: "0" image: alpine:3.20 jobs: test: stage: test image: golang:1.22 script: - go test ./... rules: - if: $CI_COMMIT_BRANCH == "master" - if: $CI_COMMIT_BRANCH =~ /^release\/.*/ build: stage: build needs: [test] script: - go build -o bluegit ./cmd/bluegit artifacts: paths: [bluegit] expire_in: 14d allow_failure: false ``` ## Velden | Veld | Betekenis | | --- | --- | | `stages` | Volgorde. Weggelaten: de stages in de volgorde waarin de jobs ze noemen. Een job zonder stage valt in `test`. | | `image` | Standaardimage. Een job zonder eigen image gebruikt die. | | `variables` | Omgevingsvariabelen voor elke job. Een job kan ze overschrijven. | | `jobs..script` | Niet-lege lijst. Ze draaien na elkaar in `sh`, met `set -e`. | | `needs` | Jobs die eerst geslaagd of overgeslagen moeten zijn. `needs: []` start meteen. Weggelaten: wacht op alle eerdere stages. | | `rules` | De job draait als minstens één `if` klopt. Zonder rules draait ze altijd. | | `artifacts.paths` | Relatieve paden, geen `..`. Na succes bewaard, en in een volgende job gezet die deze job nodig heeft. | | `artifacts.expire_in` | `30m`, `12h`, `14d`, `2w` of `never`. | | `allow_failure` | Een mislukking houdt de rest niet tegen. | Een `if` is één van: ```text $NAAM == "waarde" $NAAM != "waarde" $NAAM =~ /reguliere-expressie/ ``` Beschikbaar in rules en in de container: `CI_COMMIT_SHA`, `CI_COMMIT_BRANCH`, `CI_COMMIT_REF`, `CI_PROJECT_PATH`, `CI_PIPELINE_ID`, `CI_JOB_ID`, `CI_JOB_NAME`, `CI_JOB_TOKEN`, `CI_API_URL`. ## Geheimen Repositorygeheimen komen als omgevingsvariabele mee. Bij een groepsrepository eerst de groep, daarna de repository; dezelfde naam laat de repository winnen. Een geheim dat als beschermd is gemarkeerd, komt alleen mee als de branch op een beschermd patroon past. ## Release vanuit een job ```shell curl -fsS -X POST "$CI_API_URL/repos/$CI_PROJECT_PATH/releases" \ -H "Authorization: Bearer $CI_JOB_TOKEN" \ -H "Content-Type: application/json" \ -d '{"tag":"v1.2.3","commit":"'"$CI_COMMIT_SHA"'","name":"1.2.3","assets":[{"job":"build","path":"bluegit","name":"bluegit"}]}' ``` Het commit moet in de repository bestaan. Het asset moet een artifact zijn van een geslaagde job in dezelfde pipeline. Een beheerder kan met een persoonlijk token een release zonder assets maken. Een tag is `A-Za-z0-9._-`, tot 80 tekens, en wordt ook een annotated git-tag. ## Wanneer een job start `Gate` in `internal/ci` geeft `ready`, `wait` of `skip`. `skip` volgt op een mislukte voorganger zonder `allow_failure`. De runner verwerkt pipelines elke twee seconden, met `ci.concurrency` tegelijk (standaard 1, passend bij de mini-PC). Ontbreekt Docker, dan faalt de job met een regel in het log. De time-out is `ci.timeout_seconds` (standaard 1800).