Pular para o conteúdo

Sua primeira aplicação no AIUBY Compute, pela linha de comando

Equipe AIUBYRevisado em 16 nov 2026

CLI aiuby + AIUBY Compute

O AIUBY Compute executa aplicações em contêiner a partir de um arquivo de configuração. Cadastrar a aplicação, versionar a configuração e consultar o plano funciona em qualquer organização que tenha o produto, sem custo. Implantar em CPU é pago: sai do saldo pré-pago, pelo tempo em uso. Este tutorial vai do template ao plano e mostra o que a implantação exige.

#Antes de começar

  • Node.js 20 ou mais novo.
  • Uma organização com o AIUBY Compute adicionado em Produtos, na área do cliente.
  • Uma chave de API com os escopos "Ler o Compute" e "Gerenciar aplicações do Compute", criada em Chaves.
  • Uma imagem de contêiner publicada num registro. A plataforma ainda não constrói a imagem a partir do código.

#Passo a passo

  1. Instale a CLI

    terminal
    npm install -g @aiuby-ia/cli
  2. Entre com a chave

    A CLI pede a chave no terminal, sem eco. Ela não vai em parâmetro de comando nem fica no histórico.

    terminal
    aiuby login
    aiuby whoami
  3. Copie um template

    aiuby init sem argumento lista os templates. O fastapi-http é uma API HTTP mínima.

    terminal
    aiuby init fastapi-http minha-api
  4. Aponte para a sua imagem e valide

    Edite minha-api/aiuby.toml, troque image pelo endereço da sua imagem e valide o arquivo sem falar com a API.

    terminal
    aiuby config validate minha-api/aiuby.toml
  5. Cadastre a aplicação

    Cadastrar não implanta nem cria recurso de nuvem. Guarda a intenção e cria a revisão 1.

    terminal
    aiuby apps create minha-api/aiuby.toml
    aiuby apps status minha-api
  6. Peça o plano

    terminal
    aiuby deploy --dry-run minha-api

#O arquivo aiuby.toml

O template já vem com este formato. Cada mudança gravada com aiuby apps update vira uma revisão nova; as anteriores não mudam.

aiuby.toml
name = "Minha API"
slug = "minha-api"

[config]
runtime = "container"
image = "REGISTRO/minha-api:1"
port = 8080

[config.hardware]
provider = "any"
cpu = 1
memoryMb = 512

[config.scaling]
minReplicas = 0
maxReplicas = 1

Atenção

Variáveis de ambiente do arquivo ficam na configuração e aparecem para quem vê a aplicação. Não coloque senha, chave ou token ali: grave em Segredos, na tela da aplicação.

#Como ler o plano

O plano é a resposta para "isto pode ser implantado agora?". Quando não pode, ele lista cada motivo em uma linha, e o comando sai com código de erro, o que serve para um pipeline. A regra por trás é simples: o que não foi verificado bloqueia, nunca libera. Sem saldo na conta pré-paga ou sem teto mensal de Compute no workspace, a resposta diz exatamente o que falta, e nada é criado nem cobrado.

Numa organização com a prévia do runtime, habilitada pela equipe AIUBY, o mesmo comando confere os limites da prévia: até 1 vCPU e 1 GB em CPU, uma réplica, na região da prévia.

#Implantar, parar e ver os logs

Para implantar em CPU, a organização precisa de saldo na conta pré-paga e de um teto mensal de Compute no workspace, e a aplicação precisa estar num dos tamanhos da tela de cobrança do Compute. Com isso e uma chave que também tenha o escopo "Implantar no Compute":

terminal
aiuby deploy minha-api
aiuby logs minha-api
aiuby stop minha-api

deploy acompanha até a aplicação ficar em execução e mostra o endereço público. A aplicação fica no ar até você parar, o saldo acabar ou o teto do workspace ser atingido; parada ou ociosa não custa. stop apaga o serviço na hora. Como o valor é medido e debitado está em Implantação paga em CPU no AIUBY Compute.

#O que ainda não existe

  • Build a partir do código: hoje só imagem pronta.
  • Domínio próprio e mais de três réplicas por aplicação.
  • GPU no Brasil: as placas ficam na Europa.

A referência completa da CLI está em Compute e CLI, e a do arquivo em aiuby.toml.