Alembic · Visual Course

Verificando sua configuração com alembic doctor

Sonde a toolchain local e serviços externos antes de executar comandos caros.

Read the plain version, or open the technical layer on any section.

Por que sondar primeiro

Muitos comandos do Alembic dependem de Node, pnpm, git, o CLI Higgsfield e um gateway LLM local. Em vez de descobrir uma ferramenta faltando no meio de uma execução longa, o doctor expõe problemas antecipadamente.

Cada check retorna ok, warn ou fail. Um aviso significa que o comando ainda pode rodar em modo offline ou degradado; um falha significa que algo obrigatório está faltando.

Pense assim… o painel de instrumentos de um carro: luzes verdes são reconfortantes, amarelas pedem atenção, vermelhas significam pare.

Under the hood

runDoctor verifica process.version, executa pnpm --version, git --version e which higgsfield. Ele verifica se o diretório de dados é acessível e sonda http://127.0.0.1:8317/v1/models quando não forçado offline. O token bearer é lido de ALEMBIC_CLIPROXY_TOKEN quando presente. Os resultados são retornados como um DoctorReport tipado.

In one picture

Checks verdes passam, amarelos são avisos, vermelhos bloqueiam o fluxo relacionado.

In the code

# relatório legível por humanos
alembic doctor

# relatório JSON para CI
alembic doctor --json

# sonda o gateway mesmo com ALEMBIC_OFFLINE definido
alembic doctor --force

Implementation notes

A flag --force é útil em CI: ela faz a sonda do gateway executar mesmo se ALEMBIC_OFFLINE normalmente a ignorasse. O formato JSON é estável e pode ser consumido por dashboards ou alertas.

Try it

Execute alembic doctor na sua máquina. Se algum check estiver vermelho ou amarelo, leia a mensagem e corrija a dependência. Execute novamente até ficar satisfeito com a linha de resumo.

Ideia de integração: Adicione alembic doctor --json como uma etapa de CI e falhe o job quando fail > 0.