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.
Cách hoạt động
- 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.
- 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.
- Trao đổi trong job. Job yêu cầu token danh tính cho audience
https://dartastic.iovà 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”. - Dùng token Pub.
dart pub token addchuyển token chodart pub getvàdart pub publish(vớiflutter pubcũng vậy).
Nhà cung cấp CI của bạn
| Nhà cung cấp | Trước khi liên kết |
|---|---|
| GitHub Actions | 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. |
| GitLab CI/CD | GitLab.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 Pipelines | Mỗ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. |
| CircleCI | Mỗ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:
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:
{
"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:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Lý do | Cách xử lý |
|---|---|
CI EXCHANGE ORG MISSING | Request không nêu tổ chức nào. Gửi {"orgId": "<your organization id>"} làm body. |
CI OIDC TOKEN MISSING | Request không mang token CI nào. Gửi token dưới dạng Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | Token đượ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 TRUSTED | Bê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 EXPIRED | Token đã hết hạn trước khi được trao đổi. Trao đổi token ngay khi job yêu cầu nó. |
CI OIDC TOKEN REPLAYED | Token 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 BOUND | Khô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 MISMATCH | Liê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 MISMATCH | Job 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 MISMATCH | Job 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 MISMATCH | Job 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 MISMATCH | Repository đã 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 AMBIGUOUS | Có 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 MISSING | Token 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 RERUN | Mộ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 LIMITED | Quá 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 FAILED | Kho package không nhận được token mới. Chạy lại job. |