Estas páginas muestran las URL de Cloud. Inicie sesión en Dedicated y muestran las de su servidor.

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.

DESARROLLOARQUITECTURA DE DARTASTICUSUARIOStokensticketstoken de Pubpushintercambio de CIlas apps llegan a los usuarios: tiendas de apps, la web, servidoressímboloscrashespilas de llamadascódigo fuentetelemetríaEquipo del desarrolladorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcrear tokens · control de acceso por rolesPlano de controlorganizaciones · roles · tokensDartastic Pubpaquetes · código fuenteObservatorysesiones · trazas · logsSymbolizercrashes → líneas de códigoDartastic AIrespuestas a partir de ambosGestor de ticketsGitHub · Jira · LinearApps móviles y de escritorioteléfonos · tabletas · equiposenvía con un token OTLPApps weben navegadoresenvía con un token Browser OTLPServidores Dartbackends · serviciosenvía con un token OTLP

Cómo funciona

  1. 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.
  2. 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ó.
  3. Haga el intercambio en el job. El job solicita su token de identidad para la audiencia https://dartastic.io y lo envía al intercambio con el id de su organización, que está en la misma pantalla “Organization”.
  4. Use el token de Pub. dart pub token add se lo pasa a dart pub get y a dart pub publish (flutter pub funciona igual).

Su proveedor de CI

ProveedorAntes de vincular
GitHub ActionsGitHub.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/CDGitLab.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 PipelinesCada 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.
CircleCICada 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:

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

Responde con el token de Pub y lo que puede hacer:

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 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:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
MotivoQué hacer
CI EXCHANGE ORG MISSINGLa solicitud no nombró ninguna organización. Envíe {"orgId": "<your organization id>"} como cuerpo.
CI OIDC TOKEN MISSINGLa solicitud no llevaba ningún token de CI. Envíelo como Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDEl token se solicitó para otra audiencia. Solicítelo para https://dartastic.io, como hace el fragmento.
CI OIDC ISSUER NOT TRUSTEDEl 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 EXPIREDEl token expiró antes de intercambiarse. Intercámbielo en cuanto el job lo solicite.
CI OIDC TOKEN REPLAYEDEste token ya se intercambió. Cada token se intercambia una sola vez: haga un intercambio por job.
TRUSTED PUBLISHER NOT BOUNDNinguna 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 MISMATCHLa vinculación nombra otro repositorio u otro proyecto. Los UUID y los ID deben ser los del propio job.
TRUSTED PUBLISHER WORKFLOW MISMATCHEl job se ejecutó desde un archivo de workflow o de pipeline distinto del que permite la vinculación.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHEl job no se ejecutó en el entorno de la vinculación (o, en CircleCI, no usó su contexto).
TRUSTED PUBLISHER REF MISMATCHEl 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 MISMATCHEl repositorio se eliminó y se volvió a crear con el mismo nombre. Quite la vinculación y vincule el nuevo repositorio.
TRUSTED PUBLISHER AMBIGUOUSMás de una vinculación coincide con el job. Acótelas (workflow, entorno o ref) para que coincida exactamente una.
CI OIDC CLAIM MISSINGAl 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 RERUNUn job de CircleCI se volvió a ejecutar con SSH. Vuelva a ejecutarlo sin SSH.
CI EXCHANGE RATE LIMITEDDemasiados intercambios para este repositorio u organización en poco tiempo. Haga un intercambio por job, espere y vuelva a intentarlo.
BOX STATE PUSH FAILEDEl repositorio de paquetes no recibió el nuevo token. Vuelva a ejecutar el job.