Estas páginas mostram as URLs do Cloud. Faça login no Dedicated e elas passam a mostrar as do seu servidor.

Pub no GitLab CI/CD

Os jobs do GitLab CI/CD leem e publicam seus packages privados sem nenhum segredo armazenado: cada job troca o próprio token de identidade por um token do Pub que dura 15 minutos. Como isso funciona em todos os provedores está em Pub na CI.

BUILDARQUITETURA DARTASTICUSUÁRIOStokensissuestoken do Pubpushtroca na CIos apps chegam aos usuários: lojas de apps, a web, servidoressímboloscrashesstack tracescódigo-fontetelemetriaComputador do desenvolvedorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcriação de tokens · controle de acesso por papéisPlano de controleorganizações · papéis · tokensDartastic Pubpackages · código-fonteObservatorysessões · traces · logsSymbolizercrashes → linhas do código-fonteDartastic AIrespostas a partir dos doisIssue trackerGitHub · Jira · LinearApps mobile e desktopcelulares · tablets · desktopsenvia com um token OTLPApps webem navegadoresenvia com um token Browser OTLPServidores Dartbackends · serviçosenvia com um token OTLP

1. Confie no emissor

O GitLab.com já é confiável. Para um GitLab autogerenciado, um proprietário adiciona o endereço dele, https://<your host>, como emissor próprio desta organização.

2. Vincule o repositório

No Control Room, abra Organization, depois CI access, Bind a repository, e escolha GitLab CI/CD. O formulário pede:

  • Project path: o caminho completo do projeto, incluindo grupos aninhados: acme/mobile/app.
  • Namespace path, optional: o grupo em que o projeto está: acme/mobile. Se ficar em branco, é lido do caminho do projeto.
  • Pipeline configuration file, optional: a configuração com permissão para publicar: .gitlab-ci.yml.
  • Environment name, optional: o environment: de um job, como production. Os environments protegidos passam a controlar cada troca.
  • Ref pattern, optional: uma branch ou uma tag: refs/tags/v* ou refs/heads/main.

Depois, conceda packages ao vínculo com o botão Packages dele: leitura, ou leitura e publicação.

[TODO: captura de tela de a janela “Bind a repository” com GitLab CI/CD escolhido e acme/mobile/app preenchido]

3. Faça a troca no job

Coloque o id da sua organização, da mesma tela Organization, em DARTASTIC_ORG_ID. Este job publica; para um que só lê, remova dart pub publish e conceda ao vínculo só leitura.

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: dá ao job o token dele na variável que você nomear, aqui DARTASTIC_ID_TOKEN, com aud: https://dartastic.io.
  • Marque as tags ou branches de publicação como protegidas no GitLab, para que só maintainers possam iniciar uma execução que faz a troca.
[TODO: captura de tela de um job de pipeline do GitLab cuja troca deu certo, seguido de dart pub publish]

Quando é recusado

O log do job mostra o motivo primeiro, como TRUSTED PUBLISHER REF MISMATCH. Todos os motivos e o que fazer estão em Pub na CI. O guia do próprio GitLab CI/CD sobre seus tokens está na documentação dele.