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.
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.
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.
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.
# .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.