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

Pub no Bitbucket Pipelines

Os jobs do Bitbucket Pipelines 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 workspace do Bitbucket tem seu próprio emissor, então um proprietário o adiciona primeiro: em “CI access”, sob “This organization's own CI issuers”, escolha “Bitbucket Pipelines” e informe o nome do workspace na URL.

[TODO: captura de tela de “This organization's own CI issuers” com “Bitbucket Pipelines” escolhido e um workspace informado]

2. Vincule o repositório

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

  • Repository UUID: no Bitbucket, em “Repository settings”, “OpenID Connect”: o UUID do repositório, com as chaves.
  • Workspace UUID: na mesma página: o UUID do workspace.
  • Deployment environment UUID, optional: na mesma página, para uma etapa com deployment:. As permissões de deployment dele passam a controlar cada troca.
  • Ref pattern, optional: uma branch: refs/heads/main. O token do Bitbucket indica apenas uma branch, nunca uma tag.

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

[TODO: captura de tela de a página “Repository settings”, “OpenID Connect” do Bitbucket, mostrando os UUIDs do repositório e do workspace]
[TODO: captura de tela de a janela “Bind a repository” com o emissor do Bitbucket escolhido e os UUIDs preenchidos]

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
# bitbucket-pipelines.yml: publish from main
image: dart:stable
pipelines:
  branches:
    main:
      - step:
          name: Publish
          deployment: production   # optional: bind the environment too
          oidc: true
          script:
            - export DARTASTIC_ORG_ID="<your organization id>"
            - 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 $BITBUCKET_STEP_OIDC_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
options:
  oidc:
    audiences:
      - https://dartastic.io
  • oidc: true na etapa dá a ela $BITBUCKET_STEP_OIDC_TOKEN, e a lista de audiências sob oidc: define a audiência como https://dartastic.io.
  • O token do Bitbucket identifica o repositório apenas pelo UUID, e é por isso que o vínculo usa UUIDs.

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