Những trang này hiển thị URL của Cloud. Đăng nhập trên Dedicated để các trang hiển thị URL máy chủ của bạn.

Pub từ GitHub Actions

Job GitHub Actions đọc và xuất bản package riêng tư mà không cần lưu secret: mỗi job trao đổi token danh tính của chính nó lấy một token Pub có hiệu lực 15 phút. Cách hoạt động trên mọi nhà cung cấp có trong Pub từ CI.

XÂY DỰNGKIẾN TRÚC DARTASTICNGƯỜI DÙNGtokentickettoken Pubpushtrao đổi từ CIứng dụng đến tay người dùng: kho ứng dụng, web, máy chủsymbolcrashstack tracemã nguồntelemetryMáy tính nhà phát triểnflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtạo token · phân quyền theo vai tròControl Planetổ chức · vai trò · tokenDartastic Pubpackage · mã nguồnObservatoryphiên · trace · logSymbolizercrash → dòng mã nguồnDartastic AItrả lời từ cả haiHệ thống quản lý ticketGitHub · Jira · LinearỨng dụng di động + desktopđiện thoại · máy tính bảng · máy tínhgửi bằng token OTLPỨng dụng webtrong trình duyệtgửi bằng token Browser OTLPMáy chủ Dartbackend · dịch vụgửi bằng token OTLP

1. Tin cậy bên phát hành

GitHub.com đã được tin cậy sẵn. Với GitHub Enterprise Server, một chủ sở hữu thêm bên phát hành của nó, https://<your host>/_services/token, làm bên phát hành riêng của tổ chức này.

2. Liên kết kho mã

Trong Control Room, mở “Organization”, rồi “CI access”, “Bind a repository”, và chọn GitHub Actions. Biểu mẫu yêu cầu:

  • Repository: owner/name, như trong URL của repository: acme/app.
  • Owner: người dùng hoặc tổ chức sở hữu repository: acme.
  • Workflow file, optional: workflow được phép xuất bản: .github/workflows/release.yml. Một workflow tái sử dụng trong repository khác là owner/repo/.github/workflows/<file>.yml.
  • Environment name, optional: một environment GitHub mà job chạy trong đó, chẳng hạn release. Khi đó, các quy tắc bảo vệ của environment kiểm soát mọi lần trao đổi.
  • Ref pattern, optional: một ref của branch, tag hoặc pull request: refs/tags/v* hoặc refs/heads/main.

Sau đó cấp package cho liên kết bằng nút “Packages”: đọc, hoặc đọc và xuất bản.

[TODO: ảnh chụp màn hình cửa sổ “Bind a repository” với GitHub Actions được chọn và acme/app đã được điền]

3. Trao đổi trong job

Đặt ID tổ chức của bạn, lấy từ cùng màn hình “Organization”, vào DARTASTIC_ORG_ID. Job này xuất bản; với job chỉ đọc, bỏ dart pub publish và chỉ cấp quyền đọc cho liên kết.

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 cần permissions: id-token: write, nếu không GitHub không cấp cho job token nào để trao đổi.
  • Yêu cầu token với audience https://dartastic.io: lệnh gọi ACTIONS_ID_TOKEN_REQUEST_URL trong đoạn mã làm việc đó.
  • ::add-mask:: giữ token Pub ngoài log của job.
[TODO: ảnh chụp màn hình một lần chạy GitHub Actions có bước trao đổi thành công, rồi đến dart pub publish]

Khi bị từ chối

Log của job hiển thị lý do trước tiên, chẳng hạn TRUSTED PUBLISHER REF MISMATCH. Mọi lý do và cách xử lý có trong Pub từ CI. Hướng dẫn riêng của GitHub Actions về token của họ có trong tài liệu của họ.