Comando CI

npx intlayer ci <command...>

El comando CI está diseñado para automatización y pipelines CI/CD. Inyecta automáticamente credenciales desde la variable de entorno INTLAYER_PROJECT_CREDENTIALS y puede ejecutar comandos Intlayer en múltiples proyectos en un monorepo.

Cómo funciona

El comando CI opera en dos modos:

1. Modo de proyecto único: Si el directorio de trabajo actual coincide con una de las rutas de proyecto en INTLAYER_PROJECT_CREDENTIALS, ejecuta el comando solo para ese proyecto específico.

2. Modo de iteración: Si no se detecta un contexto de proyecto específico, itera sobre todos los proyectos configurados y ejecuta el comando para cada uno.

Variable de entorno

El comando requiere que se establezca la variable de entorno INTLAYER_PROJECT_CREDENTIALS. Esta variable debe contener un objeto JSON que mapee las rutas de proyecto a sus credenciales:

{  "packages/app": {    "clientId": "your-client-id-1",    "clientSecret": "your-client-secret-1"  },  "packages/admin": {    "clientId": "your-client-id-2",    "clientSecret": "your-client-secret-2"  }}

Detección del gestor de paquetes

El comando CI detecta automáticamente qué gestor de paquetes se está usando (npm, yarn, pnpm o bun) basándose en la variable de entorno npm_config_user_agent y usa el comando apropiado para ejecutar Intlayer.

Argumentos

• <command...>: El comando Intlayer a ejecutar (por ejemplo, fill, push, build). Puedes pasar cualquier comando Intlayer y sus argumentos.

  Ejemplo: npx intlayer ci fill --verbose

  Ejemplo: npx intlayer ci push

  Ejemplo: npx intlayer ci build

Ejemplos

Ejecutar un comando en modo de proyecto único

Si estás en un directorio de proyecto que coincide con una de las rutas en INTLAYER_PROJECT_CREDENTIALS:

cd packages/appnpx intlayer ci fill

Esto ejecutará el comando fill con las credenciales inyectadas automáticamente para el proyecto packages/app.

Ejecutar un comando en todos los proyectos

Si estás en un directorio que no coincide con ninguna ruta de proyecto, el comando iterará sobre todos los proyectos configurados:

cd /path/to/monoreponpx intlayer ci push

Esto ejecutará el comando push para cada proyecto configurado en INTLAYER_PROJECT_CREDENTIALS.

Pasar banderas adicionales

Puedes pasar cualquier bandera al comando Intlayer subyacente:

npx intlayer ci fill --verbose --mode complete

Usar en pipelines CI/CD

En tu configuración CI/CD (por ejemplo, GitHub Actions, GitLab CI), establece INTLAYER_PROJECT_CREDENTIALS como secreto:

# Ejemplo de GitHub Actionsenv:  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}steps:  - name: Llenar diccionarios    run: npx intlayer ci fill

Manejo de errores

• Si INTLAYER_PROJECT_CREDENTIALS no está establecida, el comando saldrá con un error.
• Si INTLAYER_PROJECT_CREDENTIALS no es un JSON válido, el comando saldrá con un error.
• Si una ruta de proyecto no existe, se omitirá con una advertencia.
• Si algún proyecto falla, el comando saldrá con un código de estado distinto de cero.

Casos de uso

• Automatización de monorepo: Ejecutar comandos Intlayer en múltiples proyectos en un monorepo
• Pipelines CI/CD: Automatizar la gestión de diccionarios en flujos de trabajo de integración continua
• Operaciones masivas: Realizar la misma operación en múltiples proyectos Intlayer a la vez
• Gestión de secretos: Gestionar de forma segura las credenciales para múltiples proyectos usando variables de entorno

Mejores prácticas de seguridad

• Almacena INTLAYER_PROJECT_CREDENTIALS como secretos cifrados en tu plataforma CI/CD
• Nunca comprometas las credenciales en el control de versiones
• Usa credenciales específicas del entorno para diferentes entornos de despliegue
• Rota las credenciales regularmente