Pub desde CI
Su CI lee y publica sus paquetes privados sin ningún secreto guardado. Cada job demuestra qué repositorio es con el token de identidad de su propio proveedor de CI y obtiene un token de Pub que dura 15 minutos.
Cómo funciona
- Vincule el repositorio. En el Control Room, abra Organization y busque CI access. Bind a repository indica qué ejecuciones de CI de qué repositorio actúan para su organización y, opcionalmente, solo desde un workflow, entorno o rama. La vinculación la hace un propietario o un administrador.
- Otórguele paquetes. Cada vinculación es un miembro de CI de su organización. Su botón Packages le otorga paquetes para leer, o para leer y publicar, igual que a un compañero de equipo. Sin ningún permiso otorgado, lee los paquetes globales y el motor de su organización, si tiene uno, y no publica nada. Al quitar la vinculación se quitan el miembro y todo lo que se le otorgó.
- Haga el intercambio en el job. El job solicita su token de identidad para la audiencia
https://dartastic.ioy lo envía al intercambio con el id de su organización, que está en la misma pantalla “Organization”. - Use el token de Pub.
dart pub token addse lo pasa adart pub gety adart pub publish(flutter pubfunciona igual).
Su proveedor de CI
| Proveedor | Antes de vincular |
|---|---|
| GitHub Actions | GitHub.com ya es de confianza. Para GitHub Enterprise Server, un propietario agrega su emisor, https://<your host>/_services/token, como emisor propio de esta organización. |
| GitLab CI/CD | GitLab.com ya es de confianza. Para un GitLab autogestionado, un propietario agrega su dirección, https://<your host>, como emisor propio de esta organización. |
| Bitbucket Pipelines | Cada espacio de trabajo de Bitbucket tiene su propio emisor, así que un propietario lo agrega primero: en “CI access”, bajo “This organization's own CI issuers”, elija Bitbucket Pipelines y escriba el nombre de URL del espacio de trabajo. |
| CircleCI | Cada organización de CircleCI tiene su propio emisor, así que un propietario lo agrega primero: en “CI access”, bajo “This organization's own CI issuers”, elija CircleCI y escriba el ID de la organización. |
El intercambio
El job envía su token de identidad como token bearer y el id de su organización como cuerpo:
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>"}'Responde con el token de Pub y lo que puede hacer:
{
"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 identidad se intercambia una sola vez. Haga un intercambio por job, al inicio, y conserve el token de Pub para los pasos posteriores del job.
- El token de Pub lee los paquetes globales, el motor de su organización si tiene uno y cada paquete otorgado al miembro de CI, y publica los que tienen permiso de publicación. No puede hacer nada más.
- Cada intercambio queda en el “Audit Log” de su organización, con el repositorio, la ejecución y el commit.
Cuando el intercambio se rechaza
Un rechazo indica primero su motivo, de modo que el log del job lo muestra tal cual:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Motivo | Qué hacer |
|---|---|
CI EXCHANGE ORG MISSING | La solicitud no nombró ninguna organización. Envíe {"orgId": "<your organization id>"} como cuerpo. |
CI OIDC TOKEN MISSING | La solicitud no llevaba ningún token de CI. Envíelo como Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | El token se solicitó para otra audiencia. Solicítelo para https://dartastic.io, como hace el fragmento. |
CI OIDC ISSUER NOT TRUSTED | El emisor del token no es de confianza para esta organización. Para Bitbucket, CircleCI, GitHub Enterprise Server o un GitLab autogestionado, un propietario agrega primero el emisor. |
CI OIDC EXPIRED | El token expiró antes de intercambiarse. Intercámbielo en cuanto el job lo solicite. |
CI OIDC TOKEN REPLAYED | Este token ya se intercambió. Cada token se intercambia una sola vez: haga un intercambio por job. |
TRUSTED PUBLISHER NOT BOUND | Ninguna vinculación de esta organización nombra el repositorio del job. Vincúlelo en “CI access” y revise el orgId del workflow. |
TRUSTED PUBLISHER REPOSITORY MISMATCH | La vinculación nombra otro repositorio u otro proyecto. Los UUID y los ID deben ser los del propio job. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | El job se ejecutó desde un archivo de workflow o de pipeline distinto del que permite la vinculación. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | El job no se ejecutó en el entorno de la vinculación (o, en CircleCI, no usó su contexto). |
TRUSTED PUBLISHER REF MISMATCH | El job se ejecutó en una rama o etiqueta que no coincide con el patrón de ref de la vinculación. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | El repositorio se eliminó y se volvió a crear con el mismo nombre. Quite la vinculación y vincule el nuevo repositorio. |
TRUSTED PUBLISHER AMBIGUOUS | Más de una vinculación coincide con el job. Acótelas (workflow, entorno o ref) para que coincida exactamente una. |
CI OIDC CLAIM MISSING | Al token le falta un claim que el proveedor siempre envía. Compruebe que el token sea el propio token de CI del proveedor, solicitado como hace el fragmento. |
CI OIDC SSH RERUN | Un job de CircleCI se volvió a ejecutar con SSH. Vuelva a ejecutarlo sin SSH. |
CI EXCHANGE RATE LIMITED | Demasiados intercambios para este repositorio u organización en poco tiempo. Haga un intercambio por job, espere y vuelva a intentarlo. |
BOX STATE PUSH FAILED | El repositorio de paquetes no recibió el nuevo token. Vuelva a ejecutar el job. |