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

Pub aus CircleCI

Jobs in CircleCI 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

Jede CircleCI-Organisation 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 CircleCI und geben Sie die Organisations-ID ein.

[TODO: Screenshot von „This organization's own CI issuers“ mit ausgewähltem CircleCI und eingetragener Organisations-ID]

2. Das Repository binden

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

  • Project ID: in CircleCI unter „Project Settings“, „Overview“.
  • Organization ID, optional: „Organization Settings“, „Overview“. Fehlt die Angabe, wird sie aus dem Aussteller gelesen.
  • Context ID, optional: ein Context, den der Job verwenden muss („Organization Settings“, „Contexts“). Dessen Sicherheitsgruppen 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 CircleCI-Aussteller und eingetragener Projekt-ID]

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
# .circleci/config.yml: publish on a version tag
version: 2.1
jobs:
  publish:
    docker:
      - image: dart:stable
    environment:
      DARTASTIC_ORG_ID: <your organization id>
    steps:
      - checkout
      - run: apt-get update -qq && apt-get install -y -qq jq
      - run:
          name: Exchange this job's identity for a 15-minute Pub token
          command: |
            OIDC=$(circleci run oidc get --aud https://dartastic.io)
            RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
              -H "Authorization: Bearer $OIDC" -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
            echo "export PUB_TOKEN=$PUB_TOKEN" >> "$BASH_ENV"
      - run: dart pub get
      - run: dart pub publish --force
workflows:
  release:
    jobs:
      - publish:
          filters:
            tags: { only: /^v.*/ }
            branches: { ignore: /.*/ }
  • circleci run oidc get --aud https://dartastic.io gibt dem Job ein Token für diese Audience. Die Tokens, die CircleCI von sich aus setzt, tragen Ihre Organisations-ID als Audience und werden daher abgelehnt.
  • Ein mit SSH erneut ausgeführter Job wird abgelehnt: Eine Person an der Shell könnte sein Token abgreifen. Führen Sie ihn ohne SSH erneut aus.

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