v0.1.0 Beta

ZERO SERVER CLI

Gerencie toda sua infraestrutura diretamente do terminal.

Instalação

Binário standalone, sem Node. Instala o comando zs em /usr/local/bin.

$curl -fsSL https://raw.githubusercontent.com/zeroserver-cc/zsc-cli/main/install.sh | sh

Depois de instalar, é só zs login. Nenhuma configuração extra é necessária.

Comandos

zs loginAutentica com email e senha. Token salvo localmente.

zs login --profile <nome>Autentica uma conta extra em um perfil de sessão próprio.

zs whoamiExibe o usuário autenticado e o perfil ativo.

zs session listLista os perfis de sessão, marcando o ativo e sua origem.

zs session use <nome>Define o perfil padrão global.

zs logout --profile <nome>Encerra apenas a sessão daquele perfil.

zs deployLê o zs.yaml do diretório e sobe a app multi-serviço.

zs deploy <image> --port 80Atalho single-container, sem zs.yaml.

zs deploy <image> --env KEY=VALSingle-container com variáveis de ambiente.

zs listLista todas as instâncias com status e endereço.

zs logs <app-ou-id>Exibe os logs de uma aplicação.

zs stop <app-ou-id>Para uma aplicação em execução.

zs remove <app-ou-id>Remove a aplicação e seus recursos.

zs config set backend-url <url>Opcional: aponta para outro backend (self-hosted ou local). Padrão: https://api.zeroserver.cc.

Múltiplas contas

Dá para manter várias contas logadas ao mesmo tempo. Cada perfil de sessão guarda sua própria sessão em ~/.config/zsc/sessions/<perfil>.json. O perfil ativo é resolvido nesta ordem:

1. flag --profile <nome> em qualquer comando

2. variável de ambiente ZS_PROFILE

3. session = "<nome>" num zs.toml ao lado do zs.yaml (commitável, fixa o projeto na conta certa)

4. padrão global definido com zs session use <nome>

5. perfil default

$zs login --profile cliente-x && zs session list

Usar um perfil sem sessão autentica na hora: no terminal, pede email e senha (com 2FA); em CI, usa ZS_ACCESS_TOKEN/ZS_REFRESH_TOKEN; sem terminal, falha com um erro claro. Sessões antigas (pré-perfis) migram sozinhas para o perfil default. Disponível a partir da v0.12.1; confira com zs --version (o auto-update cuida do resto).

Workflow de Exemplo

# 1. Login
$ zs login

# 2. Deploy (lê o zs.yaml do diretório)
$ zs deploy

# 3. Acompanhar até RUNNING e ver a URL
$ zs list

# 4. Ver logs / parar
$ zs logs <app-ou-id>
$ zs stop <app-ou-id>

Guia completo do primeiro deploy: Documentação.