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

Bitbucket PipelinesからPubを使う

Bitbucket Pipelinesのジョブは、保存されたシークレットなしで、プライベートパッケージを読み取り、公開できます。各ジョブは自身の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. 発行者を信頼する

Bitbucketのワークスペースはそれぞれ独自の発行者を持つため、まずオーナーが追加します。「CI access」の「This organization's own CI issuers」で「Bitbucket Pipelines」を選び、ワークスペースのURL名を入力します。

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

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

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

  • Repository UUID: Bitbucketの「Repository settings」の「OpenID Connect」にある、リポジトリのUUID(波かっこを含む)。
  • Workspace UUID: 同じページにある、ワークスペースのUUID。
  • Deployment environment UUID, optional: 同じページにあります。deployment:を指定したステップ用です。以後、そのデプロイ権限がすべての交換に適用されます。
  • Ref pattern, optional: ブランチ:refs/heads/main。Bitbucketのトークンが示すのはブランチだけで、タグは示しません。

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

[TODO:スクリーンショット(リポジトリとワークスペースのUUIDが表示された、Bitbucketの「Repository settings」の「OpenID Connect」ページ)]
[TODO:スクリーンショット(Bitbucketの発行者を選び、UUIDを入力した「Bind a repository」ダイアログ)]

3. ジョブ内で交換する

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

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を指定すると$BITBUCKET_STEP_OIDC_TOKENが渡されます。oidc:のaudiencesリストで、そのオーディエンスがhttps://dartastic.ioに設定されます。
  • BitbucketのトークンはリポジトリをUUIDでしか示さないため、バインディングにはUUIDを指定します。

拒否された場合

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