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

Pub no CircleCI

Os jobs do CircleCI 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

Cada organização do CircleCI tem seu próprio emissor, então um proprietário o adiciona primeiro: em “CI access”, sob “This organization's own CI issuers”, escolha “CircleCI” e informe o ID da organização.

[TODO: captura de tela de “This organization's own CI issuers” com “CircleCI” escolhido e um ID de organização informado]

2. Vincule o repositório

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

  • Project ID: no CircleCI, em “Project Settings”, “Overview”.
  • Organization ID, optional: “Organization Settings”, “Overview”. Se ficar em branco, é lido do emissor.
  • Context ID, optional: um context que o job precisa usar (“Organization Settings”, “Contexts”). Os grupos de segurança dele 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 o emissor do CircleCI escolhido e um ID de projeto 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
# .circleci/config.yml: publish on a version tag
version: 2.1
jobs:
  publish:
    docker:
      - image: dart:stable
    environment:
      DARTASTIC_ORG_ID: <your organization id>
    steps:
      - checkout
      - run: apt-get update -qq && apt-get install -y -qq jq
      - run:
          name: Exchange this job's identity for a 15-minute Pub token
          command: |
            OIDC=$(circleci run oidc get --aud https://dartastic.io)
            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 "export PUB_TOKEN=$PUB_TOKEN" >> "$BASH_ENV"
      - run: dart pub get
      - run: dart pub publish --force
workflows:
  release:
    jobs:
      - publish:
          filters:
            tags: { only: /^v.*/ }
            branches: { ignore: /.*/ }
  • circleci run oidc get --aud https://dartastic.io dá ao job um token para esta audiência. Os tokens que o CircleCI define por conta própria têm o ID da sua organização como audiência, então são recusados.
  • Um job executado novamente com SSH é recusado: uma pessoa no shell poderia obter o token dele. Execute-o de novo sem SSH.

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 CircleCI sobre seus tokens está na documentação dele.