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ừ GitLab CI/CD

Job GitLab CI/CD đọ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

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.

2. Liên kết kho mã

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

  • Project path: đường dẫn đầy đủ của project, gồm cả các group lồng nhau: acme/mobile/app.
  • Namespace path, optional: group chứa project: acme/mobile. Nếu bỏ trống, giá trị được đọc từ đường dẫn project.
  • Pipeline configuration file, optional: cấu hình được phép xuất bản: .gitlab-ci.yml.
  • Environment name, optional: environment: của một job, chẳng hạn production. Khi đó, các protected environment kiểm soát mọi lần trao đổi.
  • Ref pattern, optional: một branch hoặc một tag: 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 GitLab CI/CD được chọn và acme/mobile/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
# .gitlab-ci.yml: publish on a version tag
publish:
  image: dart:stable
  rules:
    - if: $CI_COMMIT_TAG =~ /^v/
  environment: production   # optional: bind the environment too
  id_tokens:
    DARTASTIC_ID_TOKEN:
      aud: https://dartastic.io
  variables:
    DARTASTIC_ORG_ID: "<your organization id>"
  script:
    - apt-get update -qq && apt-get install -y -qq jq
    - |
      RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
        -H "Authorization: Bearer $DARTASTIC_ID_TOKEN" -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
    - dart pub get
    - dart pub publish --force
  • id_tokens: cấp cho job token của nó trong biến bạn đặt tên, ở đây là DARTASTIC_ID_TOKEN, với aud: https://dartastic.io.
  • Đánh dấu các tag hoặc branch dùng để xuất bản là protected trong GitLab, để chỉ maintainer mới bắt đầu được một lần chạy có trao đổi token.
[TODO: ảnh chụp màn hình một job pipeline GitLab 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 GitLab CI/CD về token của họ có trong tài liệu của họ.