Saltar al contenido principal

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​

ParaUsaVariable
collector uploadUna credencial de subidaCOLLECTOR_UPLOAD_TOKEN (solo se lee de ahí, nunca de una opción ni de un archivo)
collector test, y dónde está CollectorEl DSN del proyectoCOLLECTOR_DSN
Cualquier otro comandoUna credencial de acceso, mejor de solo lectura y limitada a una organizaciónCOLLECTOR_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.