---
createdAt: 2026-01-06
updatedAt: 2026-01-06
title: Comando CI
description: Aprenda como usar o comando Intlayer CI para executar comandos Intlayer com credenciais auto-injetadas em pipelines CI/CD e monorepos.
keywords:
  - CI
  - CI/CD
  - Automação
  - Monorepo
  - Credenciais
  - CLI
  - Intlayer
slugs:
  - doc
  - concept
  - cli
  - ci
history:
  - version: 7.5.11
    date: 2026-01-06
    changes: Adicionar comando CI
---

# Comando CI

```bash
npx intlayer ci <command...>
```

O comando CI é projetado para automação e pipelines CI/CD. Ele injeta automaticamente credenciais da variável de ambiente `INTLAYER_PROJECT_CREDENTIALS` e pode executar comandos Intlayer em vários projetos em um monorepo.

## Como funciona

O comando CI opera em dois modos:

1. **Modo de projeto único**: Se o diretório de trabalho atual corresponder a um dos caminhos do projeto em `INTLAYER_PROJECT_CREDENTIALS`, ele executa o comando apenas para esse projeto específico.

2. **Modo de iteração**: Se nenhum contexto de projeto específico for detectado, ele itera sobre todos os projetos configurados e executa o comando para cada um.

## Variável de ambiente

O comando requer que a variável de ambiente `INTLAYER_PROJECT_CREDENTIALS` seja definida. Esta variável deve conter um objeto JSON mapeando caminhos de projeto para suas credenciais:

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

## Detecção do gerenciador de pacotes

O comando CI detecta automaticamente qual gerenciador de pacotes está sendo usado (npm, yarn, pnpm ou bun) com base na variável de ambiente `npm_config_user_agent` e usa o comando apropriado para executar Intlayer.

## Argumentos

- **`<command...>`**: O comando Intlayer a ser executado (por exemplo, `fill`, `push`, `build`). Você pode passar qualquer comando Intlayer e seus argumentos.

  > Exemplo: `npx intlayer ci fill --verbose`
  >
  > Exemplo: `npx intlayer ci push`
  >
  > Exemplo: `npx intlayer ci build`

## Exemplos

### Executar um comando no modo de projeto único

Se você estiver em um diretório de projeto que corresponde a um dos caminhos em `INTLAYER_PROJECT_CREDENTIALS`:

```bash
cd packages/app
npx intlayer ci fill
```

Isso executará o comando `fill` com credenciais automaticamente injetadas para o projeto `packages/app`.

### Executar um comando em todos os projetos

Se você estiver em um diretório que não corresponde a nenhum caminho de projeto, o comando iterará sobre todos os projetos configurados:

```bash
cd /path/to/monorepo
npx intlayer ci push
```

Isso executará o comando `push` para cada projeto configurado em `INTLAYER_PROJECT_CREDENTIALS`.

### Passar flags adicionais

Você pode passar quaisquer flags para o comando Intlayer subjacente:

```bash
npx intlayer ci fill --verbose --mode complete
```

### Usar em pipelines CI/CD

Em sua configuração CI/CD (por exemplo, GitHub Actions, GitLab CI), defina `INTLAYER_PROJECT_CREDENTIALS` como um segredo:

```yaml
# Exemplo GitHub Actions
env:
  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}

steps:
  - name: Preencher dicionários
    run: npx intlayer ci fill
```

## Tratamento de erros

- Se `INTLAYER_PROJECT_CREDENTIALS` não estiver definida, o comando sairá com um erro.
- Se `INTLAYER_PROJECT_CREDENTIALS` não for um JSON válido, o comando sairá com um erro.
- Se um caminho de projeto não existir, ele será ignorado com um aviso.
- Se algum projeto falhar, o comando sairá com um código de status diferente de zero.

## Casos de uso

- **Automação de monorepo**: Executar comandos Intlayer em vários projetos em um monorepo
- **Pipelines CI/CD**: Automatizar o gerenciamento de dicionários em fluxos de trabalho de integração contínua
- **Operações em massa**: Realizar a mesma operação em vários projetos Intlayer de uma vez
- **Gerenciamento de segredos**: Gerenciar com segurança credenciais para vários projetos usando variáveis de ambiente

## Melhores práticas de segurança

- Armazene `INTLAYER_PROJECT_CREDENTIALS` como segredos criptografados em sua plataforma CI/CD
- Nunca faça commit de credenciais no controle de versão
- Use credenciais específicas do ambiente para diferentes ambientes de implantação
- Rotacione credenciais regularmente
