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

GitLab CI/CDからPubを使う

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

GitLab.comは最初から信頼されています。セルフマネージドのGitLabの場合は、オーナーがそのアドレスhttps://<your host>を、この組織独自の発行者として追加します。

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

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

  • Project path: ネストされたグループを含む、プロジェクトのフルパス:acme/mobile/app。
  • Namespace path, optional: プロジェクトが属するグループ:acme/mobile。省略すると、プロジェクトパスから読み取ります。
  • Pipeline configuration file, optional: 公開を許可する設定ファイル:.gitlab-ci.yml。
  • Environment name, optional: ジョブのenvironment:(例:production)。以後、保護環境の設定がすべての交換に適用されます。
  • Ref pattern, optional: ブランチまたはタグ:refs/tags/v*またはrefs/heads/main。

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

[TODO:スクリーンショット(GitLab CI/CDを選び、acme/mobile/appを入力した「Bind a repository」ダイアログ)]

3. ジョブ内で交換する

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

yaml
# .gitlab-ci.yml: publish on a version tag
publish:
  image: dart:stable
  rules:
    - if: $CI_COMMIT_TAG =~ /^v/
  environment: production   # optional: bind the environment too
  id_tokens:
    DARTASTIC_ID_TOKEN:
      aud: https://dartastic.io
  variables:
    DARTASTIC_ORG_ID: "<your organization id>"
  script:
    - 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 $DARTASTIC_ID_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
  • id_tokens:は、指定した変数(ここではDARTASTIC_ID_TOKEN)に、aud: https://dartastic.ioを持つトークンを入れてジョブに渡します。
  • 公開に使うタグやブランチをGitLabで保護対象に設定し、交換を行う実行をメンテナーだけが開始できるようにしてください。
[TODO:スクリーンショット(交換が成功し、続いてdart pub publishを実行したGitLabパイプラインのジョブ)]

拒否された場合

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