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

Pub aus Bitbucket Pipelines

Jobs in Bitbucket Pipelines 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

Jeder Bitbucket-Workspace hat einen eigenen Aussteller, daher fügt ein Inhaber ihn zuerst hinzu: Wählen Sie unter „CI access“ im Abschnitt „This organization's own CI issuers“ den Eintrag Bitbucket Pipelines und geben Sie den URL-Namen des Workspace ein.

[TODO: Screenshot von „This organization's own CI issuers“ mit ausgewähltem Bitbucket Pipelines und eingetragenem Workspace]

2. Das Repository binden

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

  • Repository UUID: in Bitbucket unter „Repository settings“, „OpenID Connect“: die UUID des Repositorys, einschließlich der geschweiften Klammern.
  • Workspace UUID: auf derselben Seite: die UUID des Workspace.
  • Deployment environment UUID, optional: auf derselben Seite, für einen Step mit deployment:. Dessen Deployment-Berechtigungen gelten dann für jeden Austausch.
  • Ref pattern, optional: ein Branch: refs/heads/main. Das Token von Bitbucket nennt nur einen Branch, nie einen Tag.

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

[TODO: Screenshot von die Bitbucket-Seite „Repository settings“, „OpenID Connect“ mit den UUIDs von Repository und Workspace]
[TODO: Screenshot von der Dialog „Bind a repository“ mit ausgewähltem Bitbucket-Aussteller und eingetragenen UUIDs]

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
# bitbucket-pipelines.yml: publish from main
image: dart:stable
pipelines:
  branches:
    main:
      - step:
          name: Publish
          deployment: production   # optional: bind the environment too
          oidc: true
          script:
            - export DARTASTIC_ORG_ID="<your organization id>"
            - 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 $BITBUCKET_STEP_OIDC_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
options:
  oidc:
    audiences:
      - https://dartastic.io
  • oidc: true am Step gibt ihm $BITBUCKET_STEP_OIDC_TOKEN, und die Liste der Audiences unter oidc: setzt seine Audience auf https://dartastic.io.
  • Das Token von Bitbucket nennt das Repository nur über seine UUID, deshalb verlangt die Bindung UUIDs.

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 Bitbucket Pipelines zu seinen Tokens finden Sie in der Dokumentation des Anbieters.