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

Skip to content
Menu da documentação

Entrega

Software Delivery

Pipelines, IaC gerenciado, Database DevOps, entrega em Kubernetes, registro de artefatos e portões de CI: o que existe, como ativar e as rotas da API v1.

#O que faz

Pipelines, implantação, infraestrutura, bancos, repositórios e artefatos com política e evidência.

FuncionalidadeO que fazNa área logada
Compute runtimeExecução de aplicações em CPU e GPU na nuvem, com revisões, volta de revisão, logs e segredos./plataforma/compute
PipelinesBuild e teste em executores isolados (Node, Python e Go) ou no runner próprio, com matriz, gatilhos por push, pull request e agenda, variáveis e segredos, relatórios JUnit, cobertura e política de teste. Quarentena de teste instável com prazo, divisão dos testes pela duração e seleção pelo que mudou; causa provável da falha, explicação por IA do passo que falhou, resumo do build, grafo dos estágios, tempo de cada passo e testes falhos e mais lentos na execução. Aprovação que pausa a execução (política ou estágio approval), com quem aprova, prazo e decisão pela tela, pela API e por aviso nos webhooks; cache de dependências no executor gerenciado por workspace, repositório e lockfile, por URL assinada. Build de imagem a partir do Dockerfile (Kaniko, sem Docker socket nem modo privilegiado) com push por digest para o Artifact Registry do workspace, cache de camadas no registro e scan de imagem como portão. O executor gerenciado atende repositórios públicos e privados do GitHub, pelo GitHub App da AIUBY ou por token./plataforma/entrega/pipelines
Progressive DeliveryCanary e blue-green no Compute pelo split de tráfego do Cloud Run: degraus com tempo de observação, verificação por saúde da revisão, taxa de erro, latência e incidentes, volta automática do tráfego no aborto, aprovação pela política antes dos 100% e janela de mudança./plataforma/compute
Destinos de deployEntrega do artefato aprovado pelo CI (imagem por digest ou commit) fora do Compute: AWS ECS na conta do cliente por papel com ExternalId, sem guardar chave; servidor Linux com agente que busca as ordens por HTTPS de saída e volta sozinho se a saúde falhar; e Vercel, pelo commit aprovado, com volta para o deployment anterior. Cada entrega fica na auditoria./plataforma/entrega/destinos
Kubernetes & GitOpsEntrega no cluster Kubernetes do cliente a partir de uma pasta de manifests (YAML + kustomization.yaml com imagens e réplicas) num repositório conectado: um agente instalado no cluster busca o estado desejado por HTTPS de saída e aplica só Deployments, Services e ConfigMaps do namespace do ambiente, sem a AIUBY guardar credencial do cluster. Commit novo na branch do ambiente vira diff e rollout rolling ou canary por réplicas, com prontidão relatada pelo agente, incidentes, checagem manual, política, regras de manifest e janela de mudança, relato de divergência (drift), gerador de aplicações por lista de ambientes e rollouts de produção no DORA. Helm não é renderizado (commite a saída do helm template); não há canary por tráfego (service mesh/ingress)./plataforma/entrega/kubernetes
Release OrchestrationRelease como conjunto de aplicações promovido por ambientes em ordem (dev, staging, produção), com portões antes de cada um: congelamento, janela de mudança, política como código, suíte E2E passando, scan sem achado crítico aberto, fila por recurso, migração do banco aplicada no commit e aprovação; linha do tempo com cada portão, rollout e decisão; rastreio por item do Jira; aprovar e voltar pela tela, pela API e pela CLI (aiuby releases get, approve e rollback). Vale para as aplicações de Kubernetes & GitOps; o Compute não entra na release./plataforma/entrega/kubernetes
Deployment GovernanceCongelamento de implantações por período com alvos Compute, Kubernetes e pipelines, que nenhuma aprovação fura; política antes de cada implantação do Compute com pedido de aprovação preso à revisão e ao hash da configuração; quem pede não aprova, chave de API nunca aprova; mínimo de N aprovações e grupo de aprovadores; chamado de mudança no Jira ou no ServiceNow como condição; tela com a fila do workspace e os congelamentos; eventos nos webhooks, inclusive no Slack./plataforma/compute/governanca
Delivery ControlsTravas entre o código e a produção: firewall de dependências conferido pelo CI e pelo proxy npm, proveniência de artefatos, registro de módulos de IaC e plan pedido pelo pipeline, quarentena, divisão e seleção de testes, fila por recurso e portão de banco nas releases, gerador de aplicações por ambiente e rastreio de itens do Jira, com cada regra e bloqueio na auditoria./plataforma/entrega/operacao
RepositoriesRepositórios do GitHub conectados ao workspace com token só leitura (inclusive privados) e ligados ao grafo, ao CI e aos scanners; status checks do pipeline publicados no commit, que a proteção de branch do GitHub pode exigir; busca de código full-text na branch padrão pela tela, pela API e pela CLI aiuby-repo. A AIUBY não hospeda Git./plataforma/entrega/operacao
Infrastructure as CodePlan e apply gerenciados com OpenTofu no executor isolado da AIUBY: workspaces de IaC (repositório, diretório, variáveis herdadas do ambiente, conjuntos de entrada e papéis de quem roda e de quem aprova), state sempre no seu backend S3 ou GCS com lock, identidade federada de curta duração na sua nuvem (AWS e GCP), plan avaliado pelo IaC Review e pela política do ambiente, apply só de um plan revisado (pelo hash) e com aprovação humana, fila por workspace e drift agendado só leitura. Também: custo estimado por preço de lista, raio de impacto com os serviços do grafo, dependências entre workspaces, registro de módulos versionados, plan pedido pelo pipeline, plan comentado no pull request, workspaces efêmeros com prazo e drift que vira tarefa do Code Automation. Não guarda state nem plan, não cria os papéis na sua nuvem, não importa recursos e não roda Terraform (só OpenTofu)./plataforma/entrega/iac
Database DevOpsRegistro dos bancos por ambiente (sem endereço de conexão nem credencial guardados pela AIUBY), histórico das migrações que o CI ou o runner aplicou e relatou, portão antes de aplicar (rollback exigido, check de migrações liberado, ordem de promoção e conteúdo trocado), diferença de schema entre ambientes por retratos do CI ou do conector de dados com TLS verificado e eventos de banco na auditoria. O runner próprio do cliente aplica changelogs Flyway ou Liquibase em SQL depois que outra pessoa aprova o plano pelo hash, desfazendo o lote se uma migração falhar; migração escrita por IA passa pelas regras SQL e pela revisão de outra pessoa. A plataforma não simula o SQL./plataforma/entrega/banco
IaC ReviewAnálise de mudanças Terraform/OpenTofu no CI: lê os .tf do PR ou, de preferência, o JSON do plan gerado no seu CI com as suas credenciais; aponta destruição, recriação, segredo no código, 0.0.0.0/0 e bucket público, estima o impacto, detecta drift contra o último apply registrado e decide pela política do ambiente (aprovação na tela). A plataforma não executa terraform, não guarda state nem o plan./plataforma/entrega/iac-db
Database Migration ReviewAnálise de migrações SQL no CI (Postgres; MySQL básico), sem conectar ao seu banco: DROP, TRUNCATE, troca de tipo com reescrita, NOT NULL sem DEFAULT, índice sem CONCURRENTLY, renomeação, expand e contract na mesma entrega e falta de rollback, com decisão pela política do ambiente. Não aplica migração nem compara schema entre ambientes./plataforma/entrega/iac-db
Self-hosted RunnerRunner próprio do cliente (VM ou Kubernetes), agente pull com uma chave por runner, que executa os jobs do CI com até 4 serviços auxiliares, cache de dependências e de build por ferramenta, plugins de etapa de catálogo fechado e medição de CPU e memória, além de playbooks do Ansible e da aplicação de migrações aprovadas, com a credencial do alvo só na máquina dele. Pull request de fork é bloqueado antes do despacho./plataforma/entrega/operacao
Artifact RegistryRepositórios Docker e npm por workspace no Google Artifact Registry da AIUBY (São Paulo), com credencial de push/pull de 15 minutos por conta de serviço restrita à organização, catálogo com digest, tags, tamanho, data e quem publicou, vínculo com repositório e commit no grafo, proveniência presa à execução, ao commit e ao digest, firewall de dependências com proxy npm, retenção por política auditada, eventos de versão publicada e removida, log de acesso por repositório e portão de implantação do Compute que recusa imagem sem scan ou sem assinatura verificada quando o workspace exige. Assinatura do cosign verificada com a chave pública ECDSA P-256 do workspace (sem keyless nem registro de transparência). Maven e PyPI não são atendidos./plataforma/entrega/artefatos

#Como ativar

  • Na área logada: o dono adiciona o Cortex (o runtime, a entrega progressiva e a governança de implantação do Compute pedem também o Compute) em Produtos (veja Produtos e conta pré-paga). As telas ficam no menu do produto.
  • Pela API v1 e pela CLI: a organização precisa do Cortex ativo, de conta de faturamento válida e de uma chave de API ligada ao workspace, com o escopo da rota.
  • Conecte os repositórios do GitHub ao workspace (token só leitura). Entrega em Kubernetes, carga e caos pedem o agente de entrega instalado no seu cluster; jobs na sua rede pedem o runner próprio.

Nota

Produto da plataforma não ativo ou módulo não liberado para a organização: a API v1 responde 404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.

#Primeiro uso

  1. Crie a chave

    Em Acesso → Chaves de API, uma chave por sistema, com só o escopo da etapa: Ler a engenharia (API v1) engineering:read para ler, Check de IaC no CI iac:check e Check de migrações no CI db:check nos portões do CI, Rodar plan e apply gerenciados de IaC iac:run para plan e apply gerenciados.
  2. Leia os pipelines

    bash
    curl "https://aiuby.com/api/v1/pipelines?limit=20" -H "Authorization: Bearer $AIUBY_TOKEN"
    
    aiuby pipelines list
    aiuby pipelines runs ci
    aiuby pipelines run <id>
  3. Ponha o portão no CI

    O plan roda no seu CI, com as suas credenciais; a AIUBY lê o JSON e decide pela política do ambiente.
    bash
    terraform plan -out plan.out && terraform show -json plan.out > plan.json
    aiuby iac check --env production --workspace core --commit "$GITHUB_SHA" --plan plan.json --wait 900
    aiuby db check --env production db/migrations/*.sql --base origin/main
    Saída 6: bloqueado. Saída 7: esperando aprovação na tela.

IaC gerenciado

O tofu plan roda no executor isolado da AIUBY, com a identidade de nuvem do seu ambiente e o state no seu backend. O apply só sai do plan revisado: informe o planHash que o plan devolveu.

bash
curl -X POST https://aiuby.com/api/v1/iac/runs \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"workspace":"rede-producao","kind":"plan"}'

curl -X POST "https://aiuby.com/api/v1/iac/runs/$PLAN_ID/apply" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"planHash":"<64 caracteres hexadecimais>"}'
json
{
  "data": {
    "id": "…", "workspace": "rede-producao", "kind": "plan", "status": "succeeded",
    "planHash": "…", "hasChanges": true, "decision": "needs_approval",
    "approvalStatus": "pending", "gate": "pending_approval", "findings": []
  },
  "error": null,
  "meta": {}
}

gate diz o que fazer: ready pode aplicar, pending_approval espera uma pessoa na tela, blocked não aplica, no_changes não há o que aplicar. A chave não aprova.

Database DevOps

A AIUBY não conecta ao seu banco: o CI relata as migrações e pergunta ao portão antes de aplicar.

bash
curl -X POST https://aiuby.com/api/v1/db/migrations/gate \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"database":"loja-prod","migrations":[{"version":"20261118","hasRollback":true}]}'
  • Relatar migrações de banco no CI db:report relata migração (POST /api/v1/db/migrations), pergunta ao portão e envia o retrato do schema (só tabelas, colunas e índices; nunca linhas).
  • Ler o histórico de bancos e migrações db:read lê bancos, histórico e a diferença de schema entre dois bancos (GET /api/v1/db/schema-diff?from=…&to=…).

Releases em Kubernetes

bash
aiuby releases get $RELEASE_ID       # 0 concluída, 7 em andamento ou aguardando aprovação, 6 portão fechado, 1 falhou
aiuby releases approve $RELEASE_ID   # chave com delivery:approve
curl -X POST "https://aiuby.com/api/v1/delivery/releases/$RELEASE_ID/rollback" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"reason":"erro no checkout"}'

Limite

A chave não aprova estágio de ambiente de produção nem estágio que a política manda aprovar: isso é de uma pessoa que administra o workspace, na tela. A chave também não aprova release criada por ela mesma.

#Rotas fora da v1 que aceitam chave

Estas rotas da plataforma aceitam chave além da sessão. Respondem JSON direto, sem o envelope da v1, e erro como { "error": { "message": "…" } }.

RotaEscopoPara quê
POST /api/platform/artifacts/firewall/checkLer a engenharia (API v1) engineering:readO CI confere dependências ({ dependencies: [{ ecosystem, name, version }] }) contra o firewall antes de instalar: allow ou block
GET /api/platform/artifacts/firewallLer a engenharia (API v1) engineering:readRegras do firewall de dependências
GET /api/platform/artifacts/proxy/npm/…Ler a engenharia (API v1) engineering:readProxy npm que aplica o firewall
POST /api/platform/artifacts/versions/{id}/provenanceImplantar no Compute (CLI) compute:deployRegistra a proveniência de uma versão publicada
GET /api/platform/iac/modulesLer a engenharia (API v1) engineering:readRegistro de módulos de IaC
POST /api/platform/iac/modulesRodar plan e apply gerenciados de IaC iac:runPublica um módulo de IaC
POST /api/platform/pipelines/runs/{id}/iac-planRodar plan e apply gerenciados de IaC iac:runPlan pedido pelo pipeline
POST /api/platform/pipelines/{id}/test-splitLer a engenharia (API v1) engineering:readDivide os testes pela duração
POST /api/platform/pipelines/{id}/test-selectionLer a engenharia (API v1) engineering:readSeleciona os testes pelo que mudou
GET /api/platform/pipelines/{id}/quarantineLer a engenharia (API v1) engineering:readTestes em quarentena
GET /api/platform/engineering/jira/{key}Ler a engenharia (API v1) engineering:readRastreio de um item do Jira até a entrega
GET /api/platform/delivery-ops/repositoriesLer a engenharia (API v1) engineering:readRepositórios conectados

O runner próprio usa rotas e chave próprias (uma por runner): veja Runner próprio.

#Rotas da API

RotaEscopoPara quêCLI
GET /api/v1/engineering/artifacts/repositoriesLer a engenharia (API v1) engineering:readRepositórios de artefatosaiuby artifacts list
GET /api/v1/engineering/artifactsLer a engenharia (API v1) engineering:readArtefatosaiuby artifacts list
GET /api/v1/engineering/artifacts/versionsLer a engenharia (API v1) engineering:readVersões e tagsaiuby artifacts tags
GET /api/v1/engineering/artifacts/versions/{id}Ler a engenharia (API v1) engineering:readUma versão—
POST /api/v1/engineering/artifacts/credentialsImplantar no Compute (CLI) compute:deployCredencial de push/pullaiuby artifacts login
POST /api/v1/iac/checkCheck de IaC no CI iac:checkCheck de IaC de um PR (portão do CI)aiuby iac check
GET /api/v1/iac/check/{id}Check de IaC no CI iac:checkEstado de um check de IaCaiuby iac check --wait
POST /api/v1/iac/appliedCheck de IaC no CI iac:checkRegistrar o apply feito pelo CIaiuby iac applied
POST /api/v1/db/checkCheck de migrações no CI db:checkCheck de migrações SQL de um PR (portão do CI)aiuby db check
GET /api/v1/db/check/{id}Check de migrações no CI db:checkEstado de um check de migraçõesaiuby db check --wait
POST /api/v1/iac/runsRodar plan e apply gerenciados de IaC iac:runDisparar um plan gerenciado de IaCaiuby iac plan
GET /api/v1/iac/runsRodar plan e apply gerenciados de IaC iac:runExecuções de IaCaiuby iac runs
GET /api/v1/iac/runs/{id}Rodar plan e apply gerenciados de IaC iac:runEstado de uma execução de IaCaiuby iac run <id>
POST /api/v1/iac/runs/{id}/applyRodar plan e apply gerenciados de IaC iac:runAplicar um plan aprovadoaiuby iac apply <id>
GET /api/v1/iac/runs/{id}/insightRodar plan e apply gerenciados de IaC iac:runCusto estimado e raio de impacto de um planaiuby iac insight <id>
GET /api/v1/iac/runs/reportRodar plan e apply gerenciados de IaC iac:runRelatório do histórico de IaC por workspaceaiuby iac report
GET /api/v1/db/databasesLer o histórico de bancos e migrações db:readBancos cadastradosaiuby db databases
GET /api/v1/db/migrationsLer o histórico de bancos e migrações db:readHistórico de migrações de um bancoaiuby db migrations <banco>
POST /api/v1/db/migrationsRelatar migrações de banco no CI db:reportRelatar uma migração aplicada, desfeita ou que falhouaiuby db report
POST /api/v1/db/migrations/gateRelatar migrações de banco no CI db:reportPortão antes de aplicar migraçõesaiuby db gate
POST /api/v1/db/schema-snapshotsRelatar migrações de banco no CI db:reportEnviar o retrato do schema de um bancoaiuby db snapshot
GET /api/v1/db/schema-diffLer o histórico de bancos e migrações db:readDiferença de schema entre dois bancosaiuby db schema-diff
GET /api/v1/delivery/releasesLer a engenharia (API v1) engineering:read (ou delivery:approve, delivery:rollback)Releases de entrega em Kubernetesaiuby releases list
GET /api/v1/delivery/releases/{id}Ler a engenharia (API v1) engineering:read (ou delivery:approve, delivery:rollback)Estado de uma releaseaiuby releases get <id>
POST /api/v1/delivery/releases/{id}/approveAprovar estágios de release (CLI) delivery:approveAprovar o estágio que espera aprovaçãoaiuby releases approve <id>
POST /api/v1/delivery/releases/{id}/rollbackVoltar releases (CLI) delivery:rollbackVoltar uma releaseaiuby releases rollback <id>
POST /api/v1/delivery/agent/syncdelivery:agentAgente de entrega: relatar e buscar o estado desejado—
POST /api/v1/deploy/vm-agent/syncdelivery:agentAgente da VM: relatar e buscar a imagem a rodar—
GET /api/v1/pipelinesLer a engenharia (API v1) engineering:readPipelines de CIaiuby pipelines list
GET /api/v1/pipelines/templatesLer a engenharia (API v1) engineering:readModelos de pipelineaiuby pipelines templates
GET /api/v1/pipelines/{id}/variablesLer a engenharia (API v1) engineering:readVariáveis e segredos de um pipeline (só nomes)aiuby pipelines variables <id>
GET /api/v1/pipelines/{id}/runsLer a engenharia (API v1) engineering:readExecuções de um pipelineaiuby pipelines runs <id>
GET /api/v1/pipelines/runs/{id}Ler a engenharia (API v1) engineering:readUma execução de pipelineaiuby pipelines run <id>
POST /api/v1/pipelines/runs/{id}/approvalAprovar estágios de release (CLI) delivery:approveAprovar ou recusar o portão de uma execução (só portão com allowApiKey)—

POST /api/v1/delivery/agent/sync é do agente instalado no cluster, com chave própria do ambiente: não é para chamar à mão.

#O que ainda não existe

  • Criar, versionar, disparar e cancelar pipeline pela API: a v1 só lê. Log de step e download de artefato ficam na tela.
  • Aprovar plan de IaC, migração ou estágio de produção por chave.
  • Helm renderizado pela entrega em Kubernetes: commite a saída do helm template.
  • Git hospedado pela AIUBY: os repositórios ficam no GitHub.
  • Terraform executado pela AIUBY: no IaC Review o plan é do seu CI; no IaC gerenciado, a AIUBY roda só OpenTofu.