Tatiane Corrêa da Costa e Silva
03/19/2026, 5:50 PMkapa.ai
03/19/2026, 5:50 PMTatiane Corrêa da Costa e Silva
03/19/2026, 5:51 PMkapa.ai
03/19/2026, 5:51 PMTatiane Corrêa da Costa e Silva
03/19/2026, 6:01 PMkapa.ai
03/19/2026, 6:01 PMoctavia import connection <connection name>
> Nota: Use o nome da connection, não o ID. [forum post]
2. Importar tudo de uma vez (sources, destinations e connections)
octavia import all
Isso gera arquivos YAML para todas as suas resources, com a seguinte estrutura: [version control tutorial]
.
├── connections
│ └── postgres_to_bigquery
│ ├── configuration.yaml
│ └── state_819c7684-....yaml
├── destinations
│ └── bigquery
│ └── configuration.yaml
└── sources
└── postgres
└── configuration.yaml
Pontos importantes
• Segredos (senhas, tokens) são substituídos por '**********' nos arquivos exportados — você precisará preenchê-los manualmente antes de aplicar em outra instância. [version control tutorial]
• Há relatos de bugs com octavia import connection em versões mais recentes do Airbyte (ex: 0.42.0), onde o comando pode falhar com erros relacionados a campos como non_breaking_changes_preference. [forum post]
• Como mencionado anteriormente, o Octavia CLI está em modo alpha e sem manutenção ativa, então problemas de compatibilidade com versões mais novas do Airbyte são esperados. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Tatiane Corrêa da Costa e Silva
03/19/2026, 6:02 PMkapa.ai
03/19/2026, 6:02 PMcurl -s -o- https://raw.githubusercontent.com/airbytehq/airbyte/master/octavia-cli/install.sh | bash
Após a instalação, rode source ~/.bashrc para ativar o alias. [version control tutorial]
2. Configurar a conexão com a instância
Você tem duas formas de indicar onde sua instância Airbyte está rodando:
Opção A: Usar a flag --airbyte-url diretamente nos comandos:
octavia --airbyte-url http://localhost:8000 import all
Opção B: Definir no arquivo ~/.octavia (recomendado):
OCTAVIA_ENABLE_TELEMETRY=True
AIRBYTE_USERNAME=airbyte
AIRBYTE_PASSWORD=password
> Se você usa Airbyte v0.40.16 ou superior (que tem Basic Authentication), é obrigatório adicionar AIRBYTE_USERNAME e AIRBYTE_PASSWORD no arquivo .octavia. [version control tutorial]
3. Inicializar o projeto
Crie uma pasta e inicialize o projeto Octavia:
mkdir airbyte-configs && cd airbyte-configs
octavia init
Isso cria automaticamente as pastas sources/, destinations/ e connections/, além do arquivo api_http_headers.yaml. [version control tutorial]
4. Verificar a conexão
Ao rodar qualquer comando (como octavia import all), o Octavia exibe a instância e o workspace que está sendo usado:
🐙 - Octavia is targetting your Airbyte instance running at http://localhost:8000 on workspace 36ddb450-...
> Importante: O Octavia CLI só funciona com instâncias self-hosted — não é compatível com o Airbyte Cloud. [] 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.