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

Skip to content
Menu da documentação

AIUBY Compute

AIUBY Compute

O Compute executa aplicações em contêiner na nuvem, a partir de um arquivo de configuração. Está em prévia: veja o que já funciona.

#Estado atual

Atenção

Cadastrar aplicações, criar revisões e ver o plano de implantação funciona em qualquer organização que tenha o produto. Implantar em CPU é pago: exige conta pré-paga com saldo e um teto mensal de Compute definido no workspace, num dos tamanhos da tela de cobrança do Compute; o plano diz o que falta. Implantar com GPU também é pago, por minuto de instância ligada, com as mesmas exigências. A prévia do runtime, sem cobrança e com prazo, vale só para organizações que a equipe AIUBY habilita.

#Como funciona

  1. Descreva a aplicação

    Um arquivo aiuby.toml diz qual imagem roda, em que porta, com que hardware e com quantas réplicas.

  2. Cadastre

    Pela CLI ou pela tela Compute → Apps. Cada mudança de configuração vira uma revisão nova; as anteriores não mudam.

  3. Veja o plano

    Antes de implantar, o plano mostra o que seria criado e o que impede a implantação, se houver bloqueio.

  4. Implante

    Na prévia do runtime, a aplicação sobe no Google Cloud e recebe um endereço público, com prazo para parar sozinha. Reimplantar troca a revisão no mesmo endereço.

#Limites da prévia

O quêLimite
Hardware (CPU)Até 1 vCPU e 1 GB de memória, em São Paulo
Hardware (GPU)Uma placa por aplicação, na máquina exata dela: NVIDIA L4 (24 GB) com 4 vCPU e 16 GB, na Bélgica; ou NVIDIA RTX PRO 6000 (96 GB) com 20 vCPU e 80 GB, na Holanda
Réplicas1, que escala a zero quando ociosa
EndereçoPúblico por padrão; ou só com token de acesso, se a aplicação exigir
PrazoA aplicação para sozinha: em CPU, 6 horas por padrão, até 24; com GPU, 1 hora por padrão, até 2. Reimplantar não renova o prazo
Aplicações implantadasPoucas ao mesmo tempo, somando toda a plataforma; com GPU, no máximo 3
Aplicações por workspace50
Revisões por aplicação200

Na prévia não há cobrança. Fora dela, a implantação em CPU é cobrada do saldo pré-pago pelo tempo em uso, sem prazo: 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.

TamanhoRecursosPreço por horaCobrança
CPU Pequena1 vCPU, 512 MBR$ 1,19Tempo em uso, ao segundo
CPU Média1 vCPU, 1 GBR$ 1,29Tempo em uso, ao segundo
CPU Grande2 vCPU, 2 GBR$ 2,49Tempo em uso, ao segundo
GPU NVIDIA L44 vCPU, 16 GBR$ 9,90Minuto iniciado de instância ligada
GPU NVIDIA RTX PRO 600020 vCPU, 80 GBR$ 29,90Minuto iniciado de instância ligada

Os valores são os da conta pré-paga na PTAX de R$ 5,65, tabela de 16/11/2026. O preço acompanha o câmbio e o preço da sua conta, como o consumo de IA: o valor do dia aparece na tela de cobrança do Compute. A hora é só a base do preço; a CPU é cobrada ao segundo e a GPU, por minuto.

Com GPU, a cobrança é por minuto de instância ligada: conta cada minuto iniciado, com mínimo de 1 minuto, incluindo a partida a frio e o tempo ocioso antes de a instância desligar. A configuração tem de ser uma placa, na máquina exata dela, com uma réplica: a NVIDIA L4 sobe na Bélgica e a RTX PRO 6000 na Holanda. Para implantar, o saldo precisa cobrir o mínimo de implantação mais 20 minutos da placa, e 20 minutos de cada outra aplicação com GPU já de pé. Durante o uso, se o saldo ou o teto do workspace não cobrem os próximos 20 minutos de placa, a aplicação é parada. Há no máximo 2 aplicações com GPU pagas de pé ao mesmo tempo, somando toda a plataforma.

#Voltar a uma revisão

Cada mudança de configuração vira uma revisão numerada, e nenhuma é apagada. Na tela da aplicação, dono e administrador podem escolher uma revisão anterior e voltar a ela (na CLI, aiuby rollback minha-api 3): a plataforma cria uma revisão nova com a mesma configuração e ela passa a ser a atual. A volta fica registrada na auditoria e não mexe no que está no ar; para a aplicação mudar, implante de novo.

#Proteger o endereço com token

Por padrão, quem tem o endereço chama a aplicação. Na tela da aplicação, em Acesso ao endereço, dono e administrador podem exigir token (no aiuby.toml, access = "token" em [config]): isso grava uma revisão nova, e passa a valer quando você implantar de novo. A partir daí, a chamada sem token recebe 403, e a com token inválido ou de outra aplicação recebe 401, antes de chegar à aplicação.

O token de acesso é emitido pela plataforma, vale 1 hora e serve só para o endereço daquela aplicação. Dono, administrador e membro emitem pela tela; um sistema pede pela API ou pela CLI (aiuby token minha-api), com uma chave que tenha o escopo compute:invoke:

bash
TOKEN=$(curl -sS -X POST "https://aiuby.com/api/platform/compute/apps/minha-api/access-token" \
  -H "Authorization: Bearer $AIUBY_TOKEN" | jq -r .token)

curl -sS "$ENDERECO_DA_APLICACAO/" -H "Authorization: Bearer $TOKEN"
  • A resposta traz token, expiresAt e url. Guarde o token e peça outro perto do vencimento: há um limite de 10 pedidos por minuto por chave.
  • O token não fica guardado na plataforma. A auditoria registra quem pediu e quando, sem o valor.
  • Ele ocupa o cabeçalho Authorization. Se a sua aplicação usa esse cabeçalho para outra coisa, mande o token em X-Serverless-Authorization.
  • Só existe token para aplicação em execução com acesso por token. Parar ou voltar a público não cancela um token já emitido: ele vence sozinho em até 1 hora, e só vale enquanto o endereço exigir token.
  • Uma revisão gravada sem dizer o acesso mantém o da revisão atual: atualizar a configuração não reabre o endereço sem querer.

#Segredos

Senha, chave ou token não vão em env, que fica na configuração e aparece para quem vê a aplicação. Vão em Segredos, na tela da aplicação: dono e administrador gravam um nome e um valor, e a aplicação lê o valor como variável de ambiente com aquele nome.

  • O valor fica cifrado no banco (AES-256-GCM) e não é devolvido por tela, API, log ou auditoria. A tela mostra só o nome e a data. Para trocar, grave o mesmo nome de novo.
  • Gravar, trocar ou apagar vale na próxima implantação. O que está no ar continua com o valor que recebeu.
  • Se um segredo e uma variável de env têm o mesmo nome, vale o segredo.
  • São até 20 segredos por aplicação, com até 4.000 caracteres cada. Os nomes seguem a regra das variáveis: maiúsculas, dígitos e sublinhado.
  • Na implantação, o valor é entregue à conta de nuvem como variável de ambiente do serviço da sua aplicação. Dentro do container, qualquer código da aplicação consegue ler.

Pela CLI: aiuby secrets set minha-api DATABASE_URL pede o valor sem mostrar na tela (ou lê da entrada padrão). Pela API, com uma chave de escopo compute:write (o valor vai no corpo, nunca na URL):

bash
curl -sS -X POST "https://aiuby.com/api/platform/compute/apps/minha-api/secrets" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d "{\"name\": \"DATABASE_URL\", \"value\": \"$DATABASE_URL\"}"

curl -sS "https://aiuby.com/api/platform/compute/apps/minha-api/secrets" -H "Authorization: Bearer $AIUBY_TOKEN"
curl -sS -X DELETE "https://aiuby.com/api/platform/compute/apps/minha-api/secrets/DATABASE_URL" -H "Authorization: Bearer $AIUBY_TOKEN"

#Réplicas

Na implantação paga em CPU, config.scaling.maxReplicas aceita de 1 a 3. A aplicação começa em zero, sobe réplicas conforme chegam requisições e volta a zero quando fica ociosa.

  • A cobrança é pelo tempo em uso de cada réplica: três réplicas atendendo ao mesmo tempo custam três vezes o preço por hora do tamanho.
  • O saldo mínimo para implantar conta cada réplica como uma aplicação a mais.
  • O teto mensal do workspace continua valendo para a soma.
  • Na prévia do runtime e nas aplicações com GPU, o máximo é 1.

#O que ainda não existe

  • GPU no Brasil: as placas ficam na Europa.
  • Segredos no aiuby.toml: eles são gravados pela tela, pela CLI ou pela API, nunca no arquivo.
  • Mais de 3 réplicas em CPU, mais de 1 réplica com GPU, e réplica mínima acima de zero (toda aplicação escala a zero).
  • Volumes e domínios próprios.

O catálogo de hardware que a CLI mostra é referência pública: cota, região e preço não foram verificados.