Comandos e referência

Esta página resume o comportamento atual dos comandos públicos da CLI e destaca os pré-requisitos mais importantes de cada fluxo.

Matriz rápida

Comando	Exige login	Exige --env	Aceita --json
login	nao	nao	nao
logout	nao	nao	nao
login-check	sim	nao	nao
list-environments	sim	nao	sim
list-packages	sim	sim	sim
create-package	sim	fluxo atual trata ambiente como obrigatório	nao
list-automations	sim	sim	sim
create-automation	sim	sim	nao
deploy-automation	sim	sim	nao

Login

tunnelhub login

• abre autenticação via navegador;

• solicita Tenant ID;

• salva tokens localmente;

• usa refresh automático quando necessário.

Fallback:

tunnelhub login --password

Verificação de sessão

tunnelhub login-check

Use para confirmar se as credenciais atuais ainda são válidas.

Logout

tunnelhub logout

Remove credenciais locais salvas pela CLI.

Listagem de ambientes

tunnelhub list-environments

Saída de máquina:

tunnelhub list-environments --json

Listagem de pacotes

tunnelhub list-packages --env DEV

Também é possível usar --json.

Criação de pacote

tunnelhub create-package --env DEV

Importante: a implementação atual trata o ambiente como obrigatório no fluxo, então valide esse contexto antes de criar o pacote.

Listagem de automações

tunnelhub list-automations --env DEV

Também é possível usar --json.

Criação de automação

tunnelhub create-automation --env DEV

O comando permite escolher entre quatro templates:

• NO_DELTA

• NO_DELTA_BATCH

• DELTA

• DELTA_BATCH

Durante o fluxo, a CLI cria a automação remotamente, baixa o template oficial correspondente, extrai o projeto para uma nova pasta e preenche service.uuid no tunnelhub.yml.

Deploy de automação

tunnelhub deploy-automation --env DEV --message "meu deploy"

Opções relevantes:

• --automation <uuid> para sobrescrever o service.uuid do tunnelhub.yml;

• --publish para solicitar criação de versão publicada.

Requisitos do deploy:

• estar autenticado;

• executar o comando na pasta que contém tunnelhub.yml, ou informar corretamente o contexto de execução;

• ter package.artifact configurado;

• fornecer --message.

O fluxo de deploy faz upload do artefato por URL assinada e depois solicita a criação do deploy na plataforma.

Troubleshooting rápido

• Nao autenticado: rode tunnelhub login.

• Ambiente inválido: valide com tunnelhub list-environments.

• tunnelhub.yml não encontrado: execute o comando na raiz correta do projeto.

• package.artifact ausente: configure o caminho do zip antes do deploy.

• UUID da automação ausente: preencha service.uuid ou use --automation.

Fluxo recomendado

tunnelhub login
tunnelhub list-environments
tunnelhub create-package --env DEV
tunnelhub create-automation --env DEV
# implementar e gerar artefato
tunnelhub deploy-automation --env DEV --message "primeira versão"

Consulte também tunnelhub.yml para o contrato de build e deploy.