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ừ CI

CI của bạn đọc và xuất bản package riêng tư mà không cần lưu secret nào. Mỗi job chứng minh nó thuộc kho mã nào bằng token danh tính của chính nhà cung cấp CI, và nhận một token Pub có hiệu lực 15 phút.

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

Cách hoạt động

  1. Liên kết kho mã. Trong Control Room, mở “Organization” và tìm “CI access”. “Bind a repository” xác định CI của kho mã nào được hành động thay cho tổ chức của bạn, và có thể giới hạn ở một workflow, environment hoặc branch. Chủ sở hữu hoặc quản trị viên thực hiện liên kết.
  2. Cấp package cho liên kết. Mỗi liên kết là một thành viên CI của tổ chức. Nút “Packages” của liên kết cấp cho nó package để đọc, hoặc để đọc và xuất bản, giống hệt như với một đồng đội. Khi chưa được cấp gì, liên kết đọc được các package toàn cục và engine của tổ chức (nếu có), và không xuất bản gì. Xóa liên kết là xóa thành viên đó cùng mọi quyền đã cấp.
  3. Trao đổi trong job. Job yêu cầu token danh tính cho audience https://dartastic.io và gửi token đó đến điểm trao đổi cùng ID tổ chức của bạn, có trên cùng màn hình “Organization”.
  4. Dùng token Pub. dart pub token add chuyển token cho dart pub get và dart pub publish (với flutter pub cũng vậy).

Nhà cung cấp CI của bạn

Nhà cung cấpTrước khi liên kết
GitHub ActionsGitHub.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.
GitLab CI/CDGitLab.com đã được tin cậy sẵn. Với GitLab tự quản lý, một chủ sở hữu thêm địa chỉ của nó, https://<your host>, làm bên phát hành riêng của tổ chức này.
Bitbucket PipelinesMỗi workspace Bitbucket có bên phát hành riêng, nên một chủ sở hữu thêm nó trước: trong “CI access”, tại “This organization's own CI issuers”, chọn Bitbucket Pipelines và nhập tên URL của workspace.
CircleCIMỗi tổ chức CircleCI có bên phát hành riêng, nên một chủ sở hữu thêm nó trước: trong “CI access”, tại “This organization's own CI issuers”, chọn CircleCI và nhập organization ID.

Bước trao đổi

Job gửi token danh tính dưới dạng bearer token và ID tổ chức của bạn trong phần body:

shell
curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
  -H "Authorization: Bearer $CI_TOKEN" -H "Content-Type: application/json" \
  -d '{"orgId":"<your organization id>"}'

Kết quả trả về là token Pub và những gì token được phép làm:

json
{
  "token": "dtc_…",                 // the Pub token, valid for 15 minutes
  "keyId": "…",
  "organizationId": "<your organization id>",
  "packages": ["my_package"],       // what it may publish ([] when it only reads)
  "packageAccess": { … },           // what it may read
  "expiresAt": 1767225600           // seconds since 1970
}
  • Mỗi token danh tính chỉ trao đổi được một lần. Trao đổi một lần cho mỗi job, ngay từ đầu, rồi giữ token Pub cho các bước sau của job.
  • Token Pub đọc được các package toàn cục, engine của tổ chức (nếu có) và mọi package đã cấp cho thành viên CI, và xuất bản được những package đã cấp quyền xuất bản. Token không làm được gì khác.
  • Mỗi lần trao đổi đều có trong “Audit Log” của tổ chức, kèm kho mã, lượt chạy và commit.

Khi bước trao đổi bị từ chối

Lời từ chối nêu lý do trước tiên, nên log của job hiển thị nguyên văn:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
Lý doCách xử lý
CI EXCHANGE ORG MISSINGRequest không nêu tổ chức nào. Gửi {"orgId": "<your organization id>"} làm body.
CI OIDC TOKEN MISSINGRequest không mang token CI nào. Gửi token dưới dạng Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDToken được yêu cầu cho một audience khác. Yêu cầu nó cho https://dartastic.io, như đoạn mã đã làm.
CI OIDC ISSUER NOT TRUSTEDBên phát hành của token không được tin cậy cho tổ chức này. Với Bitbucket, CircleCI, GitHub Enterprise Server hoặc GitLab tự quản lý, một chủ sở hữu phải thêm bên phát hành trước.
CI OIDC EXPIREDToken đã hết hạn trước khi được trao đổi. Trao đổi token ngay khi job yêu cầu nó.
CI OIDC TOKEN REPLAYEDToken này đã được trao đổi. Mỗi token chỉ được trao đổi một lần: trao đổi một lần cho mỗi job.
TRUSTED PUBLISHER NOT BOUNDKhông có liên kết nào của tổ chức này nêu repository của job. Liên kết nó trong “CI access”, và kiểm tra orgId trong workflow.
TRUSTED PUBLISHER REPOSITORY MISMATCHLiên kết nêu một repository hoặc project khác. Các UUID và id phải là của chính job.
TRUSTED PUBLISHER WORKFLOW MISMATCHJob chạy từ một tệp workflow hoặc pipeline khác với tệp mà liên kết cho phép.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHJob không chạy trong environment của liên kết (hoặc, trên CircleCI, không dùng context của liên kết).
TRUSTED PUBLISHER REF MISMATCHJob chạy trên một branch hoặc tag không khớp với ref pattern của liên kết.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHRepository đã bị xóa và được tạo lại với cùng tên. Xóa liên kết và liên kết repository mới.
TRUSTED PUBLISHER AMBIGUOUSCó hơn một liên kết khớp với job. Thu hẹp chúng (workflow, environment hoặc ref) để chỉ đúng một liên kết khớp.
CI OIDC CLAIM MISSINGToken thiếu một claim mà nhà cung cấp luôn gửi. Kiểm tra rằng token là token CI của chính nhà cung cấp, được yêu cầu như đoạn mã đã làm.
CI OIDC SSH RERUNMột job CircleCI chạy lại với SSH. Hãy chạy lại mà không dùng SSH.
CI EXCHANGE RATE LIMITEDQuá nhiều lần trao đổi cho repository hoặc tổ chức này trong thời gian ngắn. Trao đổi một lần cho mỗi job, rồi chờ và thử lại.
BOX STATE PUSH FAILEDKho package không nhận được token mới. Chạy lại job.