Instalação

O bdot CLI é a interface de linha de comando oficial desenvolvida em Go para gerenciar o ciclo de vida e a orquestração do ecossistema local do bdot por meio do Docker Compose. Seu uso na versão Community é essencial para a operação do produto, gerenciamento de segredos e garantia de conformidade em atualizações futuras.

Instalação via Script Automático (Recomendado)

O método recomendado para ambientes de desenvolvimento e testes realiza o download do binário pré-compilado, valida as dependências do sistema e estrutura o workspace no caminho padrão (~/.bdot/).

Execute o comando abaixo no seu terminal:

curl -fsSL https://cli.bdot.com.br/install.sh | bash

O que o script de instalação faz automaticamente:

Validação do Ambiente

Detecta o sistema operacional e a arquitetura para baixar a versão correta do binário e dos arquivos de orquestração.
Provisionamento do Workspace

Cria o diretório global ~/.bdot/ contendo a estrutura inicial, dependências do Compose e arquivos de configuração.
Exportação do Executável no PATH

Adiciona o launcher ao PATH da sua sessão configurando symlinks em /usr/local/bin ou inserindo o export nos arquivos de perfil (~/.bashrc ou ~/.zshrc).
Inicialização do Assistente

Dispara automaticamente o assistente interativo (bdot setup) para você configurar o fuso horário, portas e variáveis operacionais.

Estrutura do Workspace da Plataforma

Após a conclusão da instalação, a CLI gerencia a aplicação através do diretório global em ~/.bdot/:

~/.bdot/
├── .env                  # Arquivo central com variáveis de ambiente (BDOT_CFG_*)
├── .bdot_secrets/        # Segredos gerados automaticamente (senhas DB, SSO e Server ID)
├── state.json            # Estado interno e hashes de auditoria de segredos
├── resources/            # Arquivos docker-compose por módulo (core, ext)
└── certs/                # Certificados TLS autoassinados e configs do Traefik (gerados na 1ª execução)

Verificação da Instalação

Após finalizar o script, recarregue as configurações da sua sessão de terminal para garantir a leitura do PATH atualizado:

Bash
Zsh

source ~/.bashrc

source ~/.zshrc

Confirme o funcionamento executando o comando de versão:

bdot version