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

Pub dari CircleCI

Job CircleCI 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 organisasi CircleCI memiliki issuer sendiri, jadi pemilik organisasi menambahkannya terlebih dahulu: di “CI access”, pada “This organization's own CI issuers”, pilih “CircleCI” dan masukkan ID organisasinya.

[TODO: screenshot “This organization's own CI issuers” dengan “CircleCI” dipilih dan ID organisasi dimasukkan]

2. Ikat repositori

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

  • Project ID: di CircleCI, “Project Settings”, “Overview”.
  • Organization ID, optional: “Organization Settings”, “Overview”. Jika dikosongkan, nilainya dibaca dari issuer.
  • Context ID, optional: context yang wajib dipakai job (“Organization Settings”, “Contexts”). Security group-nya kemudian menyaring setiap pertukaran.
  • Ref pattern, optional: branch atau tag: 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 issuer CircleCI dipilih dan ID proyek 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
# .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 memberi job token untuk audience ini. Token yang diatur CircleCI sendiri membawa ID organisasi Anda sebagai audience-nya, jadi token itu ditolak.
  • Job yang dijalankan ulang dengan SSH ditolak: seseorang di shell dapat memegang token-nya. Jalankan lagi tanpa SSH.

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