Diese Seiten zeigen die URLs von Cloud. Wenn Sie sich bei Dedicated anmelden, zeigen sie die Ihres Servers.

Pub aus GitLab CI/CD

Jobs in GitLab CI/CD lesen und veröffentlichen Ihre privaten Packages ohne gespeichertes Secret: Jeder Job tauscht sein eigenes Identitätstoken gegen ein Pub-Token, das 15 Minuten gilt. Wie das bei jedem Anbieter funktioniert, steht unter Pub aus der CI.

ENTWICKLUNGDARTASTIC-ARCHITEKTURNUTZERTokensTicketsPub-TokenPushCI-AustauschApps gehen an Nutzer: App-Stores, Web, ServerSymboleAbstürzeStacktracesQuellcodeTelemetrieEntwicklerrechnerflutter run · dart pub getCIGitHub Actions, GitLab, …Control RoomTokens erstellen · rollenbasierte ZugriffskontrolleControl PlaneOrganisationen · Rollen · TokensDartastic PubPackages · QuellcodeObservatorySitzungen · Traces · LogsSymbolizerAbstürze → QuellcodezeilenDartastic AIAntworten aus beidenIssue-TrackerGitHub · Jira · LinearMobile + Desktop-AppsSmartphones · Tablets · Desktopssendet mit einem OTLP-TokenWeb-Appsim Browsersendet mit einem Browser-OTLP-TokenDart-ServerBackends · Dienstesendet mit einem OTLP-Token

1. Dem Aussteller vertrauen

GitLab.com ist bereits vertrauenswürdig. Für ein selbstverwaltetes GitLab fügt ein Inhaber dessen Adresse https://<your host> als eigenen Aussteller dieser Organisation hinzu.

2. Das Repository binden

Öffnen Sie im Control Room Organization, dann CI access, Bind a repository, und wählen Sie GitLab CI/CD. Das Formular fragt nach:

  • Project path: der vollständige Pfad des Projekts, einschließlich verschachtelter Gruppen: acme/mobile/app.
  • Namespace path, optional: die Gruppe, in der das Projekt liegt: acme/mobile. Fehlt die Angabe, wird sie aus dem Projektpfad gelesen.
  • Pipeline configuration file, optional: die Konfiguration, die veröffentlichen darf: .gitlab-ci.yml.
  • Environment name, optional: das environment: eines Jobs, etwa production. Geschützte Environments gelten dann für jeden Austausch.
  • Ref pattern, optional: ein Branch oder ein Tag: refs/tags/v* oder refs/heads/main.

Erteilen Sie der Bindung dann über ihre Schaltfläche Packages ihre Packages: Lesen oder Lesen und Veröffentlichen.

[TODO: Screenshot von der Dialog „Bind a repository“ mit ausgewähltem GitLab CI/CD und eingetragenem acme/mobile/app]

3. Im Job austauschen

Tragen Sie die ID Ihrer Organisation aus derselben Ansicht „Organization“ in DARTASTIC_ORG_ID ein. Dieser Job veröffentlicht; für einen, der nur liest, lassen Sie dart pub publish weg und erteilen der Bindung nur Lesezugriff.

yaml
# .gitlab-ci.yml: publish on a version tag
publish:
  image: dart:stable
  rules:
    - if: $CI_COMMIT_TAG =~ /^v/
  environment: production   # optional: bind the environment too
  id_tokens:
    DARTASTIC_ID_TOKEN:
      aud: https://dartastic.io
  variables:
    DARTASTIC_ORG_ID: "<your organization id>"
  script:
    - apt-get update -qq && apt-get install -y -qq jq
    - |
      RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
        -H "Authorization: Bearer $DARTASTIC_ID_TOKEN" -H "Content-Type: application/json" \
        -d "{\"orgId\":\"$DARTASTIC_ORG_ID\"}") || { echo "$RESP" >&2; exit 1; }
      export PUB_TOKEN=$(echo "$RESP" | jq -er .token)
      dart pub token add https://pub.dartastic.io --env-var PUB_TOKEN
    - dart pub get
    - dart pub publish --force
  • id_tokens: gibt dem Job sein Token in der Variablen, die Sie benennen, hier DARTASTIC_ID_TOKEN, mit aud: https://dartastic.io.
  • Markieren Sie die Tags oder Branches, aus denen veröffentlicht wird, in GitLab als geschützt, damit nur Maintainer einen Lauf starten können, der einen Austausch vornimmt.
[TODO: Screenshot von ein Job einer GitLab-Pipeline, dessen Austausch erfolgreich war, danach dart pub publish]

Wenn er abgelehnt wird

Das Log des Jobs zeigt zuerst den Grund, etwa TRUSTED PUBLISHER REF MISMATCH. Alle Gründe und was zu tun ist, stehen unter Pub aus der CI. Die eigene Anleitung von GitLab CI/CD zu seinen Tokens finden Sie in der Dokumentation des Anbieters.