Como rodar uma aplicação web em Python num container no ECS com Fargate

Se você é o dev que só quer botar uma aplicação Python no ar sem esperar alguém provisionar uma instância, ou o SRE que vai manter esse serviço rodando depois, este é o caminho mais curto dentro do ECS. Sigo aqui o fluxo oficial descrito no guia "Learn how to create an Amazon ECS Linux task for Fargate" da AWS, adaptando o exemplo (que na documentação usa um container httpd) para uma aplicação Python de verdade.

Por que ECS com Fargate para essa aplicação

Com o launch type FARGATE, o ECS gerencia a infraestrutura por trás do container: não existe instância EC2 para você corrigir, atualizar AMI ou escalar manualmente. Você define a task, o ECS decide onde ela roda.

Se você já opera Kubernetes em outro lugar, o EKS pode fazer sentido por consistência. Mas para uma aplicação web simples como essa, com um container e desired count fixo, o ECS resolve sem o overhead de control plane, CRDs ou operators que o Kubernetes exigiria.

Pré-requisitos

• Usuário IAM com permissão AdministratorAccess, ou permissão para criar o Amazon ECS task execution IAM role (o console tenta criar esse papel automaticamente).
• Acesso ao console ECS v2 na região sa-east-1 (ou a região que você preferir, desde que suporte Fargate).
• Um security group com a porta 80 liberada para entrada, origem 0.0.0.0/0 (Anywhere). Sem isso o serviço sobe, mas ninguém acessa.

Passo 1: criar o cluster

No console, vá em Clusters > Create cluster. Dê um nome único (até 255 caracteres entre letras, números e hífen) e use a VPC padrão da conta. Container Insights é opcional nesse ponto; ative se quiser métricas agregadas desde já. Confirme em Create.

Passo 2: montar a task definition em Python

A documentação oficial usa public.ecr.aws/docker/library/httpd:latest como exemplo mínimo, só para provar o fluxo. Troquei a imagem por python:3.12-slim e o comando por um servidor HTTP embutido do próprio Python, para não depender de build nem de publicar nada no ECR agora: a ideia é validar o caminho do ECS antes de empacotar sua aplicação de produção (que, num cenário real, seria Flask ou FastAPI atrás de um gunicorn, numa imagem sua).

Em Task Definitions, escolha Create new Task Definition, Create new revision with JSON, cole o bloco abaixo e salve:

{
 "family": "python-web-fargate",
 "networkMode": "awsvpc",
 "containerDefinitions": [
 {
 "name": "python-app",
 "image": "public.ecr.aws/docker/library/python:3.12-slim",
 "portMappings": [
 {
 "containerPort": 80,
 "hostPort": 80,
 "protocol": "tcp"
 }
 ],
 "essential": true,
 "entryPoint": ["sh", "-c"],
 "command": [
 "mkdir -p /app && echo '<html><head><title>Python na ECS</title></head><body><h1>Aplicacao Python rodando no Fargate</h1></body></html>' > /app/index.html && cd /app && python3 -m http.server 80"
 ]
 }
 ],
 "requiresCompatibilities": ["FARGATE"],
 "cpu": "256",
 "memory": "512"
}

Alguns pontos que merecem atenção nessa definição:

• networkMode: "awsvpc" é obrigatório para tasks Fargate: cada task recebe sua própria interface de rede.
• cpu: "256" e memory: "512" são os mesmos valores usados no exemplo oficial da AWS para esse tipo de teste. É suficiente para validar o fluxo; uma aplicação Flask real com tráfego provavelmente precisaria de mais.
• O entryPoint/command gera o index.html na hora e sobe o servidor embutido do Python na porta 80, dispensando qualquer build de imagem.

Passo 3: criar o serviço

Vá em Clusters, abra o cluster criado no passo 1, aba Services, Create. Em Task definition family, escolha python-web-fargate. Dê um nome ao serviço.

Em Environment, selecione Launch type FARGATE. Em Deployment configuration, defina Desired tasks como 1. Em Networking, use um security group que tenha a regra inbound de porta 80 liberada, do jeito descrito nos pré-requisitos: esse é o ponto mais comum de erro silencioso, porque o serviço sobe normalmente mesmo sem essa regra, só que inacessível.

Passo 4: ver a aplicação no ar

No cluster, aba Services, abra o serviço recém-criado, depois a aba Tasks e clique na task em execução. Na seção Configuration, em Public IP, clique em Open address.

Deve abrir no navegador a página HTML gerada pelo command da task definition, confirmando que a aplicação Python está respondendo na porta 80 do Fargate.

Quando não funciona de primeira, os culpados de sempre são: a task execution IAM role não foi criada automaticamente (confira em IAM se o papel ecsTaskExecutionRole existe, e se seu usuário tem permissão para o console criá-lo); a task fica alguns segundos em PROVISIONING antes de RUNNING, o que é normal; ou o security group escolhido na criação do serviço não tem a regra de porta 80 aberta, e nesse caso a task sobe saudável mas o navegador só dá timeout.

ECS com Fargate basta, ou era hora do EKS?

Para uma aplicação web de um container só, com escala controlada pelo desired count do serviço, o ECS Fargate resolve inteiro o que esse tutorial precisa. O EKS entra quando você já depende de primitivas do Kubernetes: operators, CRDs, Helm charts, service mesh entre múltiplos clusters. Trazer um control plane Kubernetes só para rodar um container Python seria complexidade que essa aplicação não pede.

Quanto isso custa em sa-east-1

O guia oficial usado aqui não traz tabela de preço nem detalha o modelo de cobrança do Fargate. Para saber quanto custa rodar essa combinação de cpu: 256 e memory: 512 na região sa-east-1, vale consultar diretamente a AWS Pricing Calculator ou a página oficial de preços do Fargate antes de levar isso para produção.

O que importa na prática é não esquecer o passo seguinte.

Passo 5: limpar os recursos

Terminado o teste, vá em Clusters, selecione o cluster, aba Services, selecione o serviço e escolha Delete (ou Force delete, que escala o serviço a zero antes de remover). Confirme digitando delete.

Com o serviço removido, volte para Clusters, escolha Delete Cluster e confirme digitando delete cluster-nome-do-cluster. Isso também limpa Auto Scaling groups, VPCs ou load balancers que tenham sido criados junto com o cluster, mas recursos de EC2 ou Elastic Load Balancing criados fora desse fluxo precisam ser removidos manualmente.

Fonte 1: Documentação do Amazon ECS — Fargate

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html

Fonte: Documentação do Amazon ECS — Fargate