This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

AIUBY Compute

CLI aiuby

A linha de comando da AIUBY: Compute, leitura da engenharia e portões de CI pela API v1, com autenticação por chave, comandos e códigos de saída.

#Instalação

A CLI exige Node.js 20 ou mais novo e é instalada pelo npm:

bash
npm install -g @aiuby-ia/cli
aiuby --version

Como alternativa, o mesmo pacote é servido pelo site:

bash
npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz

#Autenticação

A CLI usa uma chave de API do workspace, que é o "projeto" dela. Crie a chave só com os escopos que vai usar: no Compute são "Ler o Compute", "Gerenciar aplicações do Compute" e, para implantar, "Implantar no Compute"; na engenharia, o escopo de cada comando está na tabela abaixo. aiuby login aceita chave só de engenharia.

bash
aiuby login       # cola a chave; ela não aparece na tela
aiuby whoami
  • A chave nunca é aceita como argumento, para não ficar no histórico do terminal.
  • Ela fica em ~/.config/aiuby/credentials.json, com permissão restrita ao seu usuário.
  • A CLI fala só com a API da AIUBY: nunca pede credenciais de nuvem.

Em automação, sem interação:

bash
printf '%s' "$CHAVE" | aiuby login
# ou, sem guardar nada em disco:
export AIUBY_TOKEN="aiuby_..."

#Primeiro uso

bash
aiuby init fastapi-http minha-api   # copia um template de partida
cd minha-api
aiuby config validate               # confere o aiuby.toml, sem usar a rede
aiuby apps create                   # cadastra; não implanta
aiuby deploy --dry-run minha-api    # mostra o plano
aiuby deploy minha-api              # pago (saldo e teto) ou na prévia liberada pela equipe
aiuby logs minha-api                # últimas linhas de log
aiuby stop minha-api

Os templates de partida são fastapi-http, langgraph-agent, vllm-openai, hf-stable-diffusion e yolo-detect.

#Comandos

Versão 0.11.0. Cada comando pede uma chave com o escopo indicado (o rótulo é o da tela Acesso → Chaves de API). Todos aceitam --json; listas aceitam --limit e --cursor. Os comandos de engenharia usam a API v1 e pedem o Cortex ativo (avaliações, o Agents).

Compute e conta

Escopos "Ler o Compute", "Gerenciar aplicações do Compute" e, para implantar, "Implantar no Compute".

ComandoO que fazEscopo
aiuby init [template] [diretório]Copia um template; sem argumento, lista os templates—
aiuby login [--url <endereço>]Guarda uma chave de API, depois de conferir com a API—
aiuby logoutApaga a chave deste computador—
aiuby whoamiOrganização, workspace e endereço da API—
aiuby project listO projeto (workspace) da chave—
aiuby apps listAplicações do workspace—
aiuby apps status <id>Detalhe, revisões e plano de uma aplicação—
aiuby apps create [arquivo]Cadastra a aplicação do aiuby.toml, com a primeira revisão—
aiuby apps update [arquivo]Grava a configuração como nova revisão—
aiuby capacity list [--provider gcp|aws]Catálogo de hardware, como referência—
aiuby config validate [arquivo]Valida um aiuby.toml local, sem rede—
aiuby deploy --dry-run <id>Mostra o plano, sem criar nada—
aiuby deploy [--no-wait] <id>Implanta a revisão atual e acompanha até ficar em execuçãocompute:deploy
aiuby stop <id>Para a implantação e apaga o serviçocompute:deploy
aiuby rollback <id> <N>Grava uma revisão nova com a configuração da revisão N; não implanta—
aiuby secrets list|set|delete <id> <NOME>Segredos da aplicação; o valor vem do terminal (sem eco) ou da entrada padrão—
aiuby token <id>Token de 1 hora para aplicação com endereço protegidocompute:invoke
aiuby logs [--limit N] <id>Últimas linhas de log da implantação mais recente—
aiuby billingSaldo, teto e gasto do mês de Compute, e os tamanhos com preço—
aiuby usage [--limit N]Extrato do Compute—
aiuby rollout status|start|promote|pause|resume|abort <app>Canary e blue-green no Compute (status lê; o resto pede compute:deploy)—
aiuby doctorConfere ambiente, credencial e resposta da API—

Grafo e Engineering Intelligence

ComandoO que fazEscopo
aiuby graph services [--query <texto>]Serviços do catálogo de engenhariaengineering:read
aiuby graph ask "<assunto>" [--intent <intenção>]Consulta estruturada ao grafo, sem modelo, com as fontesengineering:read
aiuby graph entity <id> [--depth 1-3]Entidade e as ligadas a elaengineering:read
aiuby graph eventsÚltimos eventos de código, catálogo, implantação e SLOengineering:read
aiuby insights delivery [--days N]Indicadores de entrega com amostraengineering:read
aiuby dora [--service S | --team T] [--days N]DORA com fórmulas e tendência semanalengineering:read
aiuby intel [--days N] [--team T]Relatório por time: DORA, PRs, itens e sprintsengineering:read
aiuby ai-efficiency [--days N]Assentos de ferramentas de IA, ociosos e custo desperdiçadoengineering:read
aiuby work-items push <arquivo.json>Envia itens de trabalho (até 500)engineering:ingest
aiuby code-review list|get <id>|branch-policy|metricsRevisões de PR por IA, política de branch e métricasengineering:read
aiuby code-review check --repo R --pr N --sha SPortão de revisão do PR (sai 6 se não passar)engineering:read

SLOs, incidentes, runbooks e flags

ComandoO que fazEscopo
aiuby slos list|get <id>|composites|composite <id>SLOs, orçamento de erro e SLOs compostosengineering:read
aiuby incidents list|get <id>Incidentes e os alertas agrupadosengineering:read
aiuby runbooks list|get <id>Runbooks e os passos da versão atualengineering:read
aiuby flags list|cleanupFlags por ambiente e candidatas a limpezaengineering:read

Segurança, supply chain e APIs

ComandoO que fazEscopo
aiuby security findings [--severity] [--status] [--tool] [--category]Achados dos scannersengineering:read
aiuby security scans [get <id>]Scans e os achados de cada umengineering:read
aiuby security scan --repo R [--scanner S]... [--wait]Pede um scansecurity:scan
aiuby security gate --repo R [--fail-on] [--kev] [--epss-at-least]Portão de severidade (sai 6 se reprovar)security:read
aiuby security upload-sarif|upload-sbom <arquivo> --repo REnvia SARIF ou SBOM de outra ferramentasecurity:write
aiuby sbom get <dono/nome> [--format]|where <pacote|purl|CVE>SBOM do repositório e busca de pacote ou CVEengineering:read
aiuby apis list|get|drift|spec|findings|applications|policiesInventário e postura de APIsengineering:read
aiuby apis traffic <arquivo.json>Envia tráfego do gateway (até 2.000 linhas)api-security:ingest
aiuby api-protection list|get|stats|samplesProteção de API em tempo de execuçãoengineering:read

Entrega, código e testes

ComandoO que fazEscopo
aiuby pipelines list|runs|run|templates|variablesPipelines, execuções, modelos e nomes de variáveisengineering:read
aiuby artifacts list|tagsImagens e pacotes do registro de artefatosengineering:read
aiuby artifacts login --repository RCredencial de 15 minutos para docker logincompute:deploy
aiuby releases list|get <id>Releases em Kubernetes (get sai 0, 7, 6 ou 1 pelo estado)engineering:read
aiuby releases approve <id>Aprova o estágio que espera (não aprova produção)delivery:approve
aiuby releases rollback <id> [--reason]Volta a release à versão anteriordelivery:rollback
aiuby iac check|appliedPortão de IaC no CI e registro do applyiac:check
aiuby iac plan|runs|run|apply|insight|reportPlan e apply gerenciados com OpenTofuiac:run
aiuby db check <migrações.sql...>Portão de migrações no CIdb:check
aiuby db databases|migrations|schema-diffBancos, histórico e diferença de schemadb:read
aiuby db report|gate|snapshot <arquivo.json>Relato de migração, portão antes de aplicar e retrato do schemadb:report
aiuby resilience checkRiscos de resiliência novos do PR (sai 6 se bloquear)resilience:check
aiuby tests run|statusSuíte Playwright no executor isoladotests:run
aiuby test-plans listPlanos de teste declarativosengineering:read
aiuby load-tests scenarios list|get|create|deleteCenários de cargaload-test:run
aiuby load-tests run|statusExecução de carga e vereditoload-test:run
aiuby catalog list|get, scorecard, scorecards list|get, portal adoptionDeveloper Portalengineering:read
aiuby code search <texto>Busca nos repositórios indexadosengineering:read
aiuby tickets listTickets do Code Automationengineering:read

Agentes e MCP

ComandoO que fazEscopo
aiuby skills list|get <nome>Skills publicadas; get imprime o SKILL.md e o sha256skills:read
aiuby evals cases|add-case|run|latest|getSuíte de avaliação de um agente (run --wait sai 6 se reprovar)agents:eval
aiuby mcp config [--client claude|cursor|generic]Bloco de configuração do servidor MCP; não imprime a chave—

Os comandos run, scale, volumes e domains existem, mas respondem que ainda não estão disponíveis (saída 4). A referência completa, com todas as opções, está no README do pacote.

#Variáveis de ambiente

VariávelEfeito
AIUBY_TOKENChave de API. Tem prioridade sobre o arquivo; use em automação
AIUBY_API_URLEndereço da API. O padrão é https://aiuby.com
AIUBY_CONFIG_DIRDiretório do arquivo de credencial

#Códigos de saída

CódigoSignificado
0Sucesso
1Erro de rede, de servidor ou falha no doctor
2Uso incorreto
3Não autenticado
4Recusado: indisponível, não encontrado, sem permissão ou plano com bloqueios
5Configuração inválida
6Bloqueado pelo portão: check de resiliência, IaC ou migração negado, teste ou carga reprovados, portão de segurança, de revisão ou de banco reprovado, release com portão fechado
7Aguardando aprovação, ou ainda rodando no fim da espera (--wait)