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

Pub na CI

Sua CI lê e publica seus packages privados sem nenhum segredo armazenado. Cada job prova de qual repositório vem com o próprio token de identidade do provedor de CI e recebe um token do Pub que dura 15 minutos.

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

Como funciona

  1. Vincule o repositório. No Control Room, abra Organization e encontre CI access. Bind a repository define quais execuções de CI de qual repositório agem pela sua organização e, opcionalmente, só a partir de um workflow, ambiente ou branch. Quem vincula é um proprietário ou um administrador.
  2. Conceda packages a ele. Cada vínculo é um membro de CI da sua organização. O botão Packages dele concede packages para leitura, ou para leitura e publicação, exatamente como para um colega. Sem nenhuma concessão, ele lê os packages globais e o motor da sua organização, se ela tiver um, e não publica nada. Remover o vínculo remove o membro e tudo o que foi concedido a ele.
  3. Faça a troca no job. O job solicita seu token de identidade para o público (audience) https://dartastic.io e o envia para a troca com o id da sua organização, que está na mesma tela Organization.
  4. Use o token do Pub. dart pub token add o entrega para dart pub get e dart pub publish (flutter pub funciona do mesmo jeito).

Seu provedor de CI

ProvedorAntes de vincular
GitHub ActionsO GitHub.com já é confiável. Para o GitHub Enterprise Server, um proprietário adiciona o emissor dele, https://<your host>/_services/token, como emissor próprio desta organização.
GitLab CI/CDO 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.
Bitbucket PipelinesCada 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.
CircleCICada 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.

A troca

O job envia seu token de identidade como bearer token e o id da sua organização como corpo:

shell
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>"}'

Ela responde com o token do Pub e o que ele pode fazer:

json
{
  "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
}
  • Cada token de identidade é trocado uma única vez. Faça a troca uma vez por job, no início, e guarde o token do Pub para as etapas seguintes do job.
  • O token do Pub lê os packages globais, o motor da sua organização, se ela tiver um, e todos os packages concedidos ao membro de CI, e publica os que têm concessão de publicação. Ele não pode fazer mais nada.
  • Cada troca fica no “Audit Log” da sua organização, com o repositório, a execução e o commit.

Quando a troca é recusada

Uma recusa traz o motivo primeiro, para que o log do job o mostre como está:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
MotivoO que fazer
CI EXCHANGE ORG MISSINGA requisição não indicou nenhuma organização. Envie {"orgId": "<your organization id>"} como corpo.
CI OIDC TOKEN MISSINGA requisição não trouxe nenhum token de CI. Envie-o como Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDO token foi solicitado para outra audiência. Solicite-o para https://dartastic.io, como faz o exemplo.
CI OIDC ISSUER NOT TRUSTEDO emissor do token não é confiável para esta organização. Para Bitbucket, CircleCI, GitHub Enterprise Server ou um GitLab autogerenciado, um proprietário adiciona o emissor primeiro.
CI OIDC EXPIREDO token expirou antes de ser trocado. Faça a troca assim que o job solicitar o token.
CI OIDC TOKEN REPLAYEDEste token já foi trocado. Cada token é trocado uma única vez: faça uma troca por job.
TRUSTED PUBLISHER NOT BOUNDNenhum vínculo desta organização indica o repositório do job. Vincule-o em “CI access” e confira o orgId no workflow.
TRUSTED PUBLISHER REPOSITORY MISMATCHO vínculo indica outro repositório ou projeto. Os UUIDs e ids precisam ser os do próprio job.
TRUSTED PUBLISHER WORKFLOW MISMATCHO job rodou a partir de um arquivo de workflow ou de pipeline diferente do que o vínculo permite.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHO job não rodou no environment do vínculo (ou, no CircleCI, não usou o context dele).
TRUSTED PUBLISHER REF MISMATCHO job rodou em uma branch ou tag que o ref pattern do vínculo não aceita.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHO repositório foi excluído e criado de novo com o mesmo nome. Remova o vínculo e vincule o novo repositório.
TRUSTED PUBLISHER AMBIGUOUSMais de um vínculo corresponde ao job. Restrinja os vínculos (workflow, environment ou ref) para que exatamente um corresponda.
CI OIDC CLAIM MISSINGFalta ao token uma declaração (claim) que o provedor sempre envia. Confira se o token é o próprio token de CI do provedor, solicitado como faz o exemplo.
CI OIDC SSH RERUNUm job do CircleCI executado novamente com SSH. Execute-o de novo sem SSH.
CI EXCHANGE RATE LIMITEDTrocas demais para este repositório ou organização em pouco tempo. Faça uma troca por job, aguarde e tente novamente.
BOX STATE PUSH FAILEDO repositório Pub não recebeu o novo token. Execute o job novamente.