Halaman ini menampilkan URL Cloud. Masuk di Dedicated, lalu halaman ini menampilkan URL server Anda.

Pub dari GitHub Actions

Job GitHub Actions membaca dan memublikasikan package pribadi Anda tanpa secret yang disimpan: setiap job menukar token identitasnya sendiri dengan token Pub yang berlaku selama 15 menit. Cara kerjanya di setiap penyedia dijelaskan di Pub dari CI.

BUILDARSITEKTUR DARTASTICPENGGUNAtokentikettoken Pubpushpertukaran CIaplikasi sampai ke pengguna: toko aplikasi, web, serversimbolcrashstack tracekode sumbertelemetriKomputer developerflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roombuat token · kontrol akses berbasis peranControl Planeorganisasi · peran · tokenDartastic Pubpackage · kode sumberObservatorysesi · trace · logSymbolizercrash → baris kode sumberDartastic AIjawaban dari keduanyaIssue trackerGitHub · Jira · LinearAplikasi seluler + desktopponsel · tablet · desktopmengirim dengan token OTLPAplikasi webdi browsermengirim dengan token Browser OTLPServer Dartbackend · layananmengirim dengan token OTLP

1. Percayai issuer

GitHub.com sudah dipercaya. Untuk GitHub Enterprise Server, pemilik organisasi menambahkan issuer-nya, https://<your host>/_services/token, sebagai issuer milik organisasi ini.

2. Ikat repositori

Di Control Room, buka Organization, lalu CI access, Bind a repository, dan pilih GitHub Actions. Formulirnya meminta:

  • Repository: owner/name, seperti di URL repositori: acme/app.
  • Owner: pengguna atau organisasi pemilik repositori: acme.
  • Workflow file, optional: workflow yang diizinkan memublikasikan: .github/workflows/release.yml. Workflow yang dapat digunakan ulang di repositori lain ditulis owner/repo/.github/workflows/<file>.yml.
  • Environment name, optional: environment GitHub tempat job berjalan, seperti release. Aturan proteksinya kemudian menyaring setiap pertukaran.
  • Ref pattern, optional: ref branch, tag, atau pull request: refs/tags/v* atau refs/heads/main.

Lalu beri pengikatan itu package-nya dengan tombol Packages: baca, atau baca dan publikasikan.

[TODO: screenshot jendela “Bind a repository” dengan GitHub Actions dipilih dan acme/app terisi]

3. Lakukan pertukaran di dalam job

Masukkan ID organisasi Anda, dari layar “Organization” yang sama, ke DARTASTIC_ORG_ID. Job ini memublikasikan; untuk job yang hanya membaca, hapus dart pub publish dan beri pengikatan akses baca saja.

yaml
# .github/workflows/publish.yml: publish on a version tag
on:
  push:
    tags: ['v*']
permissions:
  contents: read
  id-token: write          # lets the job request its OIDC token
jobs:
  publish:
    runs-on: ubuntu-latest
    environment: release   # optional: bind the environment too, so its reviewers gate publishing
    env:
      DARTASTIC_ORG_ID: <your organization id>
    steps:
      - uses: actions/checkout@v4
      - uses: dart-lang/setup-dart@v1
      - name: Exchange this job's identity for a 15-minute Pub token
        run: |
          set -euo pipefail
          OIDC=$(curl -sS --fail-with-body \
            -H "Authorization: Bearer $ACTIONS_ID_TOKEN_REQUEST_TOKEN" \
            "$ACTIONS_ID_TOKEN_REQUEST_URL&audience=https://dartastic.io" | jq -er .value)
          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 "::add-mask::$PUB_TOKEN"
          echo "PUB_TOKEN=$PUB_TOKEN" >> "$GITHUB_ENV"
      - run: dart pub get
      - run: dart pub publish --force
  • Workflow membutuhkan permissions: id-token: write, atau GitHub tidak memberi job token untuk ditukar.
  • Minta token dengan audience https://dartastic.io: panggilan ACTIONS_ID_TOKEN_REQUEST_URL dalam cuplikan kode melakukannya.
  • ::add-mask:: menjaga token Pub agar tidak muncul di log job.
[TODO: screenshot run GitHub Actions yang langkah pertukarannya berhasil, lalu dart pub publish]

Saat ditolak

Log job menampilkan alasannya lebih dulu, misalnya TRUSTED PUBLISHER REF MISMATCH. Setiap alasan dan yang perlu dilakukan ada di Pub dari CI. Panduan GitHub Actions sendiri tentang tokennya ada di dokumentasinya.