En integración continua
En la integración continua, la CLI se usa sobre todo para dos cosas: subir los mapas de código fuente de cada build y comprobar que el DSN funciona. Ninguna de las dos necesita collector login.
Las credenciales
| Para | Usa | Variable |
|---|---|---|
collector upload | Una credencial de subida | COLLECTOR_UPLOAD_TOKEN (solo se lee de ahí, nunca de una opción ni de un archivo) |
collector test, y dónde está Collector | El DSN del proyecto | COLLECTOR_DSN |
| Cualquier otro comando | Una credencial de acceso, mejor de solo lectura y limitada a una organización | COLLECTOR_TOKEN |
Guarda las tres en los secretos de tu integración continua. Para un Collector que no sea app.clt.chrom.ar, agrega COLLECTOR_URL.
Un ejemplo con GitHub Actions
- name: Instalar collector
run: curl -fsSL https://packages.chrom.ar/collector/install.sh | sh
- name: Construir
run: npm run build
env:
GIT_SHA: ${{ github.sha }}
- name: Subir los mapas de código fuente
run: collector upload ./dist --release "$GITHUB_SHA" --delete
env:
COLLECTOR_UPLOAD_TOKEN: ${{ secrets.COLLECTOR_UPLOAD_TOKEN }}
COLLECTOR_DSN: ${{ secrets.COLLECTOR_DSN }}
Sube antes de desplegar: los eventos de una versión sin mapas quedan minificados. La versión de --release tiene que ser exactamente la que reporta tu aplicación. Ver Mapas de código fuente.
Los códigos de salida
upload y test terminan con 0 si salió bien, 1 si Collector rechazó o no respondió, y 2 si el comando se usó mal. Un paso de la integración continua falla solo cuando algo salió mal de verdad. Los demás comandos suman el 3 para los problemas de credencial; ver Códigos de salida.