Bu sayfalar Cloud'un URL'lerini gösterir. Dedicated'da giriş yapın, sayfalar sunucunuzun URL'lerini göstersin.

GitHub Actions'ta Pub

GitHub Actions işleri, özel paketlerinizi saklanmış bir secret olmadan okur ve yayımlar: her iş kendi kimlik token'ını 15 dakika geçerli bir Pub token'ıyla değiştirir. Her sağlayıcıda nasıl çalıştığı CI'da Pub sayfasında anlatılır.

GELİŞTİRMEDARTASTIC MİMARİSİKULLANICILARtoken'larissue'larPub token'ıpushCI token değişimiuygulamalar kullanıcılara ulaşır: uygulama mağazaları, web, sunucularsembollerçökmelerstack trace'lerkaynak kodtelemetriGeliştirici bilgisayarıflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtoken oluşturma · rol tabanlı erişim denetimiControl Planekuruluşlar · roller · token'larDartastic Pubpaketler · kaynak kodObservatoryoturumlar · trace'ler · loglarSymbolizerçökmeler → kaynak kod satırlarıDartastic AIikisinden de beslenen yanıtlarIssue takip aracıGitHub · Jira · LinearMobil ve masaüstü uygulamalartelefonlar · tabletler · masaüstleriOTLP token'ı ile gönderirWeb uygulamalarıtarayıcılardaBrowser OTLP token'ı ile gönderirDart sunucularıbackend'ler · servislerOTLP token'ı ile gönderir

1. Token verene (issuer) güvenin

GitHub.com zaten güvenilir kabul edilir. GitHub Enterprise Server için bir kuruluş sahibi, sunucunun veren (issuer) adresini, https://<your host>/_services/token, bu kuruluşun kendi vereni olarak ekler.

2. Depoyu bağlayın

Control Room'da Organization ekranını, ardından CI access ve Bind a repository seçeneklerini açın ve sağlayıcı olarak GitHub Actions seçin. Form şunları ister:

  • Repository: owner/name, deponun URL'sindeki gibi: acme/app.
  • Owner: depoya sahip olan kullanıcı veya kuruluş: acme.
  • Workflow file, optional: yayımlamasına izin verilen workflow: .github/workflows/release.yml. Başka bir depodaki yeniden kullanılabilir bir workflow şöyle yazılır: owner/repo/.github/workflows/<file>.yml.
  • Environment name, optional: job'ın çalıştığı bir GitHub environment'ı, örneğin release. Bu durumda her takası onun koruma kuralları denetler.
  • Ref pattern, optional: bir branch, tag veya pull request ref'i: refs/tags/v* ya da refs/heads/main.

Ardından bağlamaya Packages düğmesiyle paket erişimi verin: okuma ya da okuma ve yayımlama.

[TODO: GitHub Actions seçili ve acme/app girilmiş hâliyle “Bind a repository” penceresi ekran görüntüsü]

3. Token değişimini işte yapın

Aynı “Organization” ekranındaki kuruluş ID'nizi DARTASTIC_ORG_ID değişkenine yazın. Bu iş yayımlama yapar; yalnızca okuyan bir iş için dart pub publish adımını çıkarın ve bağlamaya yalnızca okuma erişimi verin.

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'un permissions: id-token: write iznine ihtiyacı vardır; yoksa GitHub job'a takas edilecek bir token vermez.
  • Token'ı https://dartastic.io audience değeriyle isteyin: Örnekteki ACTIONS_ID_TOKEN_REQUEST_URL çağrısı bunu yapar.
  • ::add-mask::, Pub token'ını job'ın logunun dışında tutar.
[TODO: takas adımı başarılı olan, ardından dart pub publish çalıştıran bir GitHub Actions çalıştırması ekran görüntüsü]

Reddedildiğinde

İşin logu önce nedeni gösterir, örneğin TRUSTED PUBLISHER REF MISMATCH. Tüm nedenler ve ne yapılacağı CI'da Pub sayfasında. GitHub Actions sağlayıcısının token'larıyla ilgili kendi rehberi kendi dokümantasyonunda bulunur.