このヘルプにはCloudのURLが表示されています。Dedicatedでログインすると、お客様のサーバーのURLが表示されます。

CircleCIからPubを使う

CircleCIのジョブは、保存されたシークレットなしで、プライベートパッケージを読み取り、公開できます。各ジョブは自身のIDトークンを、有効期間15分のPubトークンと交換します。すべてのプロバイダーに共通の仕組みは、CIからPubを使うを参照してください。

ビルドDartasticアーキテクチャユーザートークンIssuePubトークンプッシュCIトークン交換アプリをユーザーへ配布:アプリストア、Web、サーバーシンボルクラッシュスタックトレースソーステレメトリー開発用コンピューターflutter run · dart pub getCIGitHub Actions、GitLab、…Control Roomトークン発行 · ロールベースのアクセス制御コントロールプレーン組織 · ロール · トークンDartastic Pubパッケージ · ソースObservatoryセッション · トレース · ログSymbolizerクラッシュ → ソースコードの行Dartastic AI両方のデータから回答IssueトラッカーGitHub · Jira · Linearモバイル・デスクトップアプリスマートフォン · タブレット · デスクトップOTLPトークンで送信Webアプリブラウザーで動作Browser OTLPトークンで送信Dartサーバーバックエンド · サービスOTLPトークンで送信

1. 発行者を信頼する

CircleCIの組織はそれぞれ独自の発行者を持つため、まずオーナーが追加します。「CI access」の「This organization's own CI issuers」で「CircleCI」を選び、組織IDを入力します。

[TODO:スクリーンショット(CircleCIを選び、組織IDを入力した「This organization's own CI issuers」)]

2. リポジトリをバインドする

Control Roomで「Organization」、「CI access」、「Bind a repository」の順に開き、CircleCIを選びます。フォームの入力項目:

  • Project ID: CircleCIの「Project Settings」の「Overview」。
  • Organization ID, optional: 「Organization Settings」の「Overview」。省略すると、発行者から読み取ります。
  • Context ID, optional: ジョブが使う必要のあるコンテキスト(「Organization Settings」の「Contexts」)。以後、そのセキュリティグループがすべての交換に適用されます。
  • Ref pattern, optional: ブランチまたはタグ:refs/tags/v*またはrefs/heads/main。

次に、バインディングの「Packages」ボタンでパッケージを付与します:読み取り、または読み取りと公開。

[TODO:スクリーンショット(CircleCIの発行者を選び、プロジェクトIDを入力した「Bind a repository」ダイアログ)]

3. ジョブ内で交換する

同じ「Organization」画面にある組織IDを、DARTASTIC_ORG_IDに設定します。このジョブは公開を行います。読み取りだけのジョブではdart pub publishを削除し、バインディングには読み取りだけを付与してください。

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で、このオーディエンス向けのトークンをジョブに渡します。CircleCIが自動で設定するトークンは、組織IDをオーディエンスとしているため拒否されます。
  • SSH付きで再実行したジョブは拒否されます。シェルにいる人がトークンを手にできるためです。SSHなしで再実行してください。

拒否された場合

ジョブのログには、TRUSTED PUBLISHER REF MISMATCHのように最初に理由が表示されます。すべての理由と対処方法はCIからPubを使うにあります。CircleCIのトークンについては、公式ドキュメントを参照してください。