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
não
não
não
logout
não
não
não
login-check
sim
não
não
list-environments
sim
não
sim
list-packages
sim
sim
sim
create-package
sim
sim
não
list-automations
sim
sim
sim
create-automation
sim
sim
não
deploy-automation
depende do fluxo
depende do fluxo
não
Para deploy-automation:
no fluxo interativo, exige login e
--env;no fluxo CI/CD M2M, não exige login no navegador e aceita
--environment-idou--envcom UUID.
Login
tunnelhub loginabre autenticação via navegador;
solicita
Tenant ID;salva tokens localmente;
usa refresh automático quando necessário.
Fallback:
Verificação de sessão
Use para confirmar se as credenciais atuais ainda são válidas.
Logout
Remove credenciais locais salvas pela CLI.
Listagem de ambientes
Saída de máquina:
Listagem de pacotes
Também é possível usar --json.
Importante: --env é obrigatório. Você pode informar nome ou UUID do ambiente.
Criação de pacote
O comando é interativo e hoje exige --env no fluxo público atual.
Listagem de automações
Também é possível usar --json.
Importante: --env é obrigatório. Você pode informar nome ou UUID do ambiente.
Criação de automação
O comando permite escolher entre quatro templates:
NO_DELTANO_DELTA_BATCHDELTADELTA_BATCH
Durante o fluxo, a CLI:
consulta os pacotes do ambiente escolhido;
coleta nome, descrição, pacote, retention period e URL de repositório;
cria a automação na plataforma;
baixa o template oficial correspondente do GitHub;
extrai o projeto para uma nova pasta local;
preenche
service.uuidnotunnelhub.ymlgerado.
Deploy de automação
Opções relevantes:
--automation <uuid>para sobrescrever oservice.uuiddotunnelhub.yml;--environment-id <uuid>para informar explicitamente o UUID do ambiente;--publishpara solicitar criação de versão publicada.
Requisitos do deploy:
Fluxo com login:
estar autenticado;
executar o comando na pasta que contém
tunnelhub.yml;ter
package.artifactconfigurado;fornecer
--env;fornecer
--message.
Fluxo CI/CD M2M:
configurar
TH_API_HOST,TH_CLIENT_IDeTH_CLIENT_SECRET;executar o comando na pasta que contém
tunnelhub.yml;ter
package.artifactconfigurado;fornecer
--environment-idou--envcom UUID;fornecer
--message.
O fluxo de deploy faz upload do artefato por URL assinada e depois solicita a criação do deploy na plataforma.
No fluxo CI/CD com credenciais M2M:
configure
TH_API_HOST,TH_CLIENT_IDeTH_CLIENT_SECRET;use uma credencial autorizada para o ambiente alvo;
use
--environment-idou--envcom UUID do ambiente;use
--messagepara registrar o contexto humano do deploy;createdByda revisão ficará comoapi-client:<clientId>.
Exemplo:
Troubleshooting rápido
Não autenticado: rode
tunnelhub login.Ambiente inválido: valide com
tunnelhub list-environments.tunnelhub.ymlnão encontrado: execute o comando na raiz correta do projeto.package.artifactausente: configure o caminho do ZIP antes do deploy.UUID da automação ausente: preencha
service.uuidou use--automation.
Fluxo recomendado
Consulte também Deploy via CI/CD, Autenticação e ambientes e tunnelhub.yml.
Last updated