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

Skip to content
Menu da documentação

Destinos de deploy (prévia)

Destino AWS (ECS Express Mode)

Entregue a imagem aprovada pelo CI no ECS da sua conta AWS, com canary e volta automática, sem a AIUBY guardar chave da sua conta.

#Estado atual

Atenção

Prévia fechada: os destinos AWS, servidor Linux e Vercel estão ligados só para organizações que a equipe AIUBY habilita (hoje, a organização interna). A tela fica em Software Delivery → Destinos de deploy.

#Como funciona

  • Você cria na sua conta, com um modelo de CloudFormation da AIUBY, um papel aiuby-deploy-access que só a AIUBY assume e só com o ExternalId da sua organização. Nenhuma chave de acesso da sua conta sai dela.
  • A cada entrega, a AIUBY assume o papel por 15 minutos, copia a imagem aprovada para um repositório aiuby/<destino> do ECR da sua conta com o mesmo digest e cria ou atualiza um serviço do ECS Express Mode (Fargate, balanceador com HTTPS e escala automática criados pela AWS).
  • O ECS faz o deploy em canary, com o alarme de deploy defeituoso e a volta automática da própria AWS. Enquanto o canary roda, a verificação de saúde da AIUBY bate no endereço do serviço; se falhar seguidas vezes, a AIUBY pede ao ECS para parar o deploy e voltar.
  • Depois do deploy, a verificação confirma; se falhar, a AIUBY atualiza o serviço de volta para a imagem anterior.

Usamos o ECS Express Mode porque o App Runner deixou de aceitar clientes novos em 30/04/2026 e a AWS recomenda o Express Mode no lugar.

#Preparar a conta

  1. Baixe o modelo

    Na tela Destinos de deploy, em “Preparar conta AWS”, copie o modelo (ele já traz o ExternalId da sua organização) para aiuby-deploy.yaml.

  2. Crie a pilha

    Terminal
    aws cloudformation deploy --stack-name aiuby-deploy --template-file aiuby-deploy.yaml --capabilities CAPABILITY_NAMED_IAM --region us-east-2

    São três papéis: o que a AIUBY assume, o de execução das tarefas (AmazonECSTaskExecutionRolePolicy) e o de infraestrutura do Express Mode (AmazonECSInfrastructureRoleforExpressGatewayServices).

  3. Cadastre o destino

    Informe as três saídas da pilha, a região, a porta do contêiner e o caminho de saúde. A conta precisa ter a VPC padrão com sub-redes públicas em duas zonas.

#Estados da entrega

EstadoO que significa
Na fila / ImplantandoA AIUBY pediu a entrega e acompanha o provedor (ou o agente).
Verificando saúdeA versão nova está no ar; a verificação precisa passar 2 vezes seguidas.
No arPassou. A entrega anterior vira “Substituída” e é para ela que se volta.
Voltou para a anteriorA verificação falhou 3 vezes seguidas (ou o provedor/agente já voltou sozinho): a versão anterior está no ar.
FalhouNão havia para onde voltar (primeira entrega) ou a volta também falhou; o motivo aparece na linha.

#O que ainda não existe

  • VPC e sub-redes próprias, domínio próprio e variáveis de ambiente pela tela (o serviço usa a VPC padrão e o endereço gerado pela AWS).
  • A primeira entrega num serviço não tem para onde voltar: se falhar, fica como “Falhou” e o serviço segue na AWS para você ver os logs.
  • Remover o destino não apaga o serviço nem o repositório do ECR na sua conta.