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

Pub dari Bitbucket Pipelines

Job Bitbucket Pipelines 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

Setiap workspace Bitbucket memiliki issuer sendiri, jadi pemilik organisasi menambahkannya terlebih dahulu: di “CI access”, pada “This organization's own CI issuers”, pilih “Bitbucket Pipelines” dan masukkan nama URL workspace.

[TODO: screenshot “This organization's own CI issuers” dengan “Bitbucket Pipelines” dipilih dan sebuah workspace dimasukkan]

2. Ikat repositori

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

  • Repository UUID: di Bitbucket, “Repository settings”, “OpenID Connect”: UUID repositori, termasuk kurung kurawalnya.
  • Workspace UUID: di halaman yang sama: UUID workspace.
  • Deployment environment UUID, optional: di halaman yang sama, untuk step dengan deployment:. Izin deployment-nya kemudian menyaring setiap pertukaran.
  • Ref pattern, optional: branch: refs/heads/main. Token Bitbucket hanya menyebut branch, tidak pernah tag.

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

[TODO: screenshot halaman “Repository settings”, “OpenID Connect” di Bitbucket, yang menampilkan UUID repositori dan workspace]
[TODO: screenshot jendela “Bind a repository” dengan issuer Bitbucket dipilih dan UUID 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
# 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 pada step memberinya $BITBUCKET_STEP_OIDC_TOKEN, dan daftar audience di bawah oidc: mengatur audience-nya ke https://dartastic.io.
  • Token Bitbucket hanya menyebut repositori dengan UUID-nya, itulah sebabnya pengikatan memakai UUID.

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 Bitbucket Pipelines sendiri tentang tokennya ada di dokumentasinya.