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.
Como funciona
- 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.
- 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.
- Faça a troca no job. O job solicita seu token de identidade para o público (audience)
https://dartastic.ioe o envia para a troca com o id da sua organização, que está na mesma tela Organization. - Use o token do Pub.
dart pub token addo entrega paradart pub getedart pub publish(flutter pubfunciona do mesmo jeito).
Seu provedor de CI
| Provedor | Antes de vincular |
|---|---|
| GitHub Actions | O 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/CD | 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. |
| Bitbucket Pipelines | 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. |
| CircleCI | 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. |
A troca
O job envia seu token de identidade como bearer token e o id da sua organização como corpo:
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:
{
"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á:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Motivo | O que fazer |
|---|---|
CI EXCHANGE ORG MISSING | A requisição não indicou nenhuma organização. Envie {"orgId": "<your organization id>"} como corpo. |
CI OIDC TOKEN MISSING | A requisição não trouxe nenhum token de CI. Envie-o como Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | O token foi solicitado para outra audiência. Solicite-o para https://dartastic.io, como faz o exemplo. |
CI OIDC ISSUER NOT TRUSTED | O 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 EXPIRED | O token expirou antes de ser trocado. Faça a troca assim que o job solicitar o token. |
CI OIDC TOKEN REPLAYED | Este token já foi trocado. Cada token é trocado uma única vez: faça uma troca por job. |
TRUSTED PUBLISHER NOT BOUND | Nenhum 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 MISMATCH | O vínculo indica outro repositório ou projeto. Os UUIDs e ids precisam ser os do próprio job. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | O job rodou a partir de um arquivo de workflow ou de pipeline diferente do que o vínculo permite. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | O job não rodou no environment do vínculo (ou, no CircleCI, não usou o context dele). |
TRUSTED PUBLISHER REF MISMATCH | O job rodou em uma branch ou tag que o ref pattern do vínculo não aceita. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | O 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 AMBIGUOUS | Mais de um vínculo corresponde ao job. Restrinja os vínculos (workflow, environment ou ref) para que exatamente um corresponda. |
CI OIDC CLAIM MISSING | Falta 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 RERUN | Um job do CircleCI executado novamente com SSH. Execute-o de novo sem SSH. |
CI EXCHANGE RATE LIMITED | Trocas demais para este repositório ou organização em pouco tempo. Faça uma troca por job, aguarde e tente novamente. |
BOX STATE PUSH FAILED | O repositório Pub não recebeu o novo token. Execute o job novamente. |