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-accessque 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
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.Crie a pilha
Terminal aws cloudformation deploy --stack-name aiuby-deploy --template-file aiuby-deploy.yaml --capabilities CAPABILITY_NAMED_IAM --region us-east-2Sã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).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
| Estado | O que significa |
|---|---|
| Na fila / Implantando | A AIUBY pediu a entrega e acompanha o provedor (ou o agente). |
| Verificando saúde | A versão nova está no ar; a verificação precisa passar 2 vezes seguidas. |
| No ar | Passou. A entrega anterior vira “Substituída” e é para ela que se volta. |
| Voltou para a anterior | A verificação falhou 3 vezes seguidas (ou o provedor/agente já voltou sozinho): a versão anterior está no ar. |
| Falhou | Nã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.