Sua primeira aplicação no AIUBY Compute, pela linha de comando
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
Instale a CLI
terminal npm install -g @aiuby-ia/cliEntre 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 whoamiCopie um template
aiuby initsem argumento lista os templates. Ofastapi-httpé uma API HTTP mínima.terminal aiuby init fastapi-http minha-apiAponte para a sua imagem e valide
Edite
minha-api/aiuby.toml, troqueimagepelo endereço da sua imagem e valide o arquivo sem falar com a API.terminal aiuby config validate minha-api/aiuby.tomlCadastre 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-apiPeç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.
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 = 1Atençã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":
aiuby deploy minha-api
aiuby logs minha-api
aiuby stop minha-apideploy 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.



