DokumentationAutomatisierung
GitLab CI
Befunde zu den Screenshots als Code-Quality- und Testberichte im Merge Request zeigen, die Bilder als Artefakte aufbewahren und aus einem manuellen Job hochladen.
Das Container-Image bringt alles mit, was ein GitLab-Job braucht, ein
Installationsschritt entfällt: vitrine, git, jq und eine POSIX-sh.
Wie du das Kommandozeilenwerkzeug auf anderen Runnern installierst und was es
für CI allgemein bietet: Automatisierung.
Prüfen und exportieren im Merge Request
vitrine-validate:
image: ghcr.io/vitrinestudio-app/vitrine-cli:1.0.0
script:
- vitrine --project store-screens validate --format gitlab -o gl-code-quality-report.json
artifacts:
when: always
reports:
codequality: gl-code-quality-report.json
vitrine-export:
image: ghcr.io/vitrinestudio-app/vitrine-cli:1.0.0
script:
- vitrine --project store-screens export --out vitrine-export --no-gallery
artifacts:
paths: [vitrine-export/]
- Code-Quality-Befunde erscheinen im Merge Request. Mit
-ogeht der Bericht in die Datei und der lesbare Bericht ins Job-Log. - Für den Reiter Tests der Pipeline nimmst du
--format junit -o vitrine-junit.xmlmitreports: junit: vitrine-junit.xml. - Ohne das Image (z. B. auf einem macOS-Runner) installierst du das Archiv
in
before_script– siehe Installation in der CI.
Die geplanten CI/CD-Komponenten
Die CI/CD-Catalog-Komponenten im gitlab.com-Projekt
vitrinestudio/vitrine-gitlab-ci
fassen diese beiden Jobs zusammen (validate mit Code Quality + JUnit,
export) und nutzen dasselbe Image:
include:
- component: $CI_SERVER_FQDN/vitrinestudio/vitrine-gitlab-ci/validate@1
inputs:
project: store-screens
Hochladen aus einem manuellen Job
Leg die Schlüssel als maskierte CI/CD-Variablen ab, am besten auf geschützte
Branches oder Tags beschränkt (alle Variablen:
Hochladen aus der CI). Eine Variable vom Typ File
namens VITRINE_ASC_KEY_PATH mit dem Text der .p8-Datei funktioniert
direkt: GitLab legt den Text in einer Datei ab, und die Variable enthält
ihren Pfad. Ein manueller Job bedeutet, dass ein Mensch jeden Upload startet:
vitrine-upload:
image: ghcr.io/vitrinestudio-app/vitrine-cli:1.0.0
rules:
- if: $CI_COMMIT_TAG
when: manual
script:
- vitrine --project store-screens upload plan --store apple --remote --format json > plan.json
- vitrine --project store-screens upload execute --confirm "$(jq -r .confirm_token plan.json)" --yes
artifacts:
when: always
paths: [plan.json]
Ist der Plan blockiert, endet der Plan-Schritt mit Exit-Code 1, und es wird
nichts hochgeladen. Für Google Play setzt du VITRINE_PLAY_SERVICE_ACCOUNT
(oder eine File-Variable VITRINE_PLAY_SERVICE_ACCOUNT_PATH) und nimmst
--store google.
Geräterahmen
Der Runner hat keine eigenen Apple-Bezels. Speichere die, die dein Projekt verwendet, im Repository (nur private Repositories), oder nimm die eingebauten Rahmen – siehe Geräterahmen in der CI.