HAD Deploy CLI

Crie, publique e acompanhe aplicações no HAD Deploy diretamente pelo terminal — sem expor o provider de infraestrutura.

O que você pode fazer

• Gerenciar projetos: listar, criar, editar e excluir.
• Criar, editar e excluir aplicações Git, Docker, Dockerfile e templates aprovados.
• Listar templates públicos e serviços provisionados.
• Publicar aplicações, iniciar/parar/reiniciar serviços e acompanhar execuções.
• Consultar status e logs de deploys de aplicações e de templates.
• Usar tokens com escopo mínimo, inclusive por projeto, em estações locais ou CI/CD.

Instalação

npm install -g @hadcloud/deploy-cli

Confira se a instalação está disponível:

had config

Começo rápido

1. No painel HAD Deploy, abra CLI & MCP e gere um token do tipo CLI.

2. Para acesso completo da CLI, selecione os escopos recomendados:

   • projects:read, projects:write
   • apps:read, apps:write
   • deployments:read, deployments:create
   • logs:read
   • env:write somente se precisar editar variáveis de templates

3. Faça login:

had login --api-url https://api.seu-dominio.com

O token é solicitado sem aparecer no terminal e fica armazenado no cofre do sistema operacional. No Windows, a CLI usa Windows DPAPI.

4. Confira os projetos disponíveis:

had projects list

Atualizar token

Não é preciso executar logout para trocar um token expirado ou criar um token com novos escopos:

had token update

A URL de API já configurada é mantida. Você também pode executar had login novamente para substituir o token.

Para automação sem prompt:

echo "$HAD_DEPLOY_TOKEN" | had token update --token-stdin

No PowerShell, use: $env:NOVO_TOKEN | had token update --token-stdin.

Projetos

# Listar
had projects list

# Criar
had projects create "Plataforma de produção" --description "Serviços do cliente"

# Editar
had projects edit prj_... --name "Produção"

# Excluir — requer confirmação explícita
had projects delete prj_... --yes

Aplicações

Aplicação de um template aprovado

# Ver templates disponíveis
had templates list

# Provisionar n8n em um projeto
had apps create prj_... --template n8n --region BR-SP-01

# Forma equivalente
had templates create prj_... n8n --region BR-SP-01

O comando mostra o ID do serviço (tpl_...) e, quando o provider já o registrou, o ID da execução. Para acompanhar um deploy de template:

had templates services prj_...
had templates deployments prj_... tpl_...
had templates status prj_... tpl_... <deployment-id>
had templates logs prj_... tpl_... <deployment-id> 300

Aplicação de repositório GitHub

Primeiro conecte sua conta GitHub no painel HAD Deploy. A CLI recebe apenas o identificador da conexão segura já cadastrada — nunca token, senha ou URL Git com credenciais.

had apps create prj_... \
  --name minha-api \
  --source github \
  --git-connection git_... \
  --repository https://github.com/minha-org/minha-api.git \
  --branch main \
  --build-type railpack

Fontes aceitas: github, git, docker e dockerfile.

# Listar aplicações de um projeto
had apps list prj_...

# Alterar configurações suportadas
had apps edit prj_... app_... --branch release --build-type dockerfile

# Solicitar deploy de uma aplicação
had deploy prj_... app_...

# Consultar o deploy interno da aplicação
had status dep_...
had logs dep_... 200

# Excluir a aplicação
had apps delete prj_... app_... --yes

Gerenciar um serviço de template

# Reexecutar um deploy
had templates deploy prj_... tpl_...

# Atualizar variáveis pelo arquivo local
had templates edit prj_... tpl_... --env-file .env.production

# Excluir o serviço
had templates delete prj_... tpl_... --yes

Os IDs de deploy de template pertencem ao provider e não são dep_.... Por isso, use had templates status e had templates logs para eles; had status e had logs são destinados a aplicações que utilizam a fila interna do HAD Deploy.

Uso em CI/CD

Prefira variáveis protegidas do provedor de CI. Não grave tokens em .env versionado, código-fonte ou logs.

export HAD_DEPLOY_API_URL="https://api.seu-dominio.com"
export HAD_DEPLOY_TOKEN="hd_cli_..."

had projects list
had deploy prj_... app_...

Quando HAD_DEPLOY_TOKEN e HAD_DEPLOY_API_URL estão definidos, a CLI não precisa de login interativo nem persiste credenciais locais.

Segurança

• Gere tokens com o menor conjunto de escopos possível.
• Para um único projeto, crie um token limitado ao projeto no painel.
• Tokens limitados a projeto não podem criar novos projetos nem acessar recursos de outro projeto.
• Comandos destrutivos exigem --yes.
• O manifesto Compose de templates permanece controlado pela plataforma; a CLI não aceita Compose arbitrário.
• Revogue tokens não utilizados pelo painel HAD Deploy.

Referência rápida

had login [--api-url <url>] [--token-stdin]
had token update [--token-stdin]
had logout
had config

had projects list|create|edit|delete
had apps list|create|edit|delete
had templates list|create|services|deploy|deployments|status|logs|edit|delete
had deploy <project-id> <app-id>
had status <deployment-id>
had logs <deployment-id> [tail]

Suporte

Abra o painel HAD Deploy para criar conexões Git, emitir ou revogar tokens e acompanhar a infraestrutura. Ao solicitar suporte, envie o ID público do recurso (prj_, app_, tpl_ ou dep_) e o horário aproximado da operação — nunca envie o token.