Terminal e automação

Zenifra CLI para deploy e operação no terminal

Instale a CLI oficial da Zenifra, autentique, crie projetos, publique por GitHub ou Docker/OCI, consulte logs e use API key em automações de CI/CD.

Abrir console Ver docs da CLI Ver quickstart

Do primeiro comando ao deploy observado

A CLI reúne os caminhos que devs repetem no dia a dia: instalar, autenticar, criar projeto, publicar, acompanhar builds e operar a aplicação.

Instalação

npm install -g @zenifra/cli
zenifra --help

Autenticação

zenifra auth login
zenifra auth api-key --key znf_sua_chave

Criar projeto

zenifra plans --type http
zenifra create project
zenifra create project --name app-api --plan basic --payment-mode hourly --config @examples/http-github-project.json

Deploy GitHub

zenifra deploy --project <project-id> --branch main
zenifra deploy watch --project <project-id> --build <build-id>

Quando usar Zenifra CLI

A página é um mapa rápido para quem quer avaliar se a Zenifra encaixa no fluxo técnico do time.

Dev que vive no terminal

Instale, autentique, crie projetos e dispare deploys sem sair do fluxo local.

Time com pipeline

Use API key organizacional em CI/CD para listar projetos, acionar deploys e acompanhar builds.

Operação de produção

Veja logs, variáveis, builds, deployments, URL e imagem atual pelo mesmo binário.

Fluxo reproduzível

Use a CLI em modo exploratório no terminal ou com API key e JSON em pipelines.

Instale e autentique

Use login interativo para uso pessoal ou API key organizacional para automação.

Crie ou conecte o projeto

Use o wizard quando estiver explorando ou arquivos de configuração para fluxos reproduzíveis.

Publique e observe

Dispare deploy GitHub, acompanhe builds e consulte logs, env vars e deployments pelo terminal.

Decisões antes de automatizar

Algumas escolhas definem se o fluxo fica mais adequado para uso local, produção ou CI/CD.

Login ou API key

GitHub ou OCI

GitHub usa deploy por branch; OCI usa projeto com imagem e atualização via project image set.

Wizard ou config

Wizard guia o primeiro uso; config versionada dá repetibilidade para times e pipelines.

Texto ou JSON

Use saída normal no terminal e --json quando o comando alimentar scripts ou CI/CD.

Checklist para usar a CLI

Separe credencial, project ID, branch, imagem e porta antes de transformar comandos locais em automação. Isso reduz tentativa e erro no primeiro deploy pelo terminal.

Node.js e npm disponíveis para instalar @zenifra/cli
Conta Zenifra ou API key organizacional criada no console
Project ID separado para deploy, logs, env vars e builds
Branch principal definida quando o deploy for GitHub
Imagem OCI e porta HTTP definidas quando o projeto usar Docker/OCI

Docker/OCI

zenifra create project --name app-api --plan basic --payment-mode hourly --config @examples/http-project.json
zenifra project image set --project <project-id> --image ghcr.io/sua-org/app:main

Logs, env vars e histórico

zenifra projects --type http
zenifra project logs --project <project-id>
zenifra project envs --project <project-id>
zenifra project env add --project <project-id> --name NODE_ENV --value production
zenifra builds --project <project-id>
zenifra deployments --project <project-id>

CI/CD

export ZENIFRA_API_KEY=znf_sua_chave
zenifra deploy --project <project-id> --branch main --json

Dúvidas frequentes

Respostas curtas para manter a página prática sem virar uma cópia da documentação.

A página substitui a documentação da CLI?

Não. Ela mostra o fluxo principal e os comandos mais usados; detalhes de flags e retornos ficam na documentação oficial.

Qual autenticação devo usar em CI/CD?

Use ZENIFRA_API_KEY no ambiente do job. A chave já carrega o contexto da organização e evita salvar sessão local no runner.

Existe deploy direto por imagem na CLI?

O fluxo atual para OCI é criar o projeto com config de imagem ou atualizar a imagem com project image set.

Como vejo comandos e exemplos completos?

Use zenifra help <command> ou zenifra <command> --help para ver uso, exemplos e saída esperada por comando.