Neste artigo, voc\u00ea vai percorrer o processo de deploy de uma aplica\u00e7\u00e3o FastAPI<\/a> no AWS App Runner, com foco em um setup limpo e pronto para produ\u00e7\u00e3o, sem complexidade desnecess\u00e1ria.<\/p>\n\n\n\n Se voc\u00ea gosta de APIs r\u00e1pidas, menos arquivos YAML e deploys que n\u00e3o exigem sacrif\u00edcio ritual, est\u00e1 no lugar certo.<\/p>\n\n\n\n Antes de escrever qualquer c\u00f3digo, \u00e9 preciso criar alguns recursos b\u00e1sicos na AWS. Essas configura\u00e7\u00f5es permitem que o App Runner puxe a imagem do container com seguran\u00e7a e execute a aplica\u00e7\u00e3o FastAPI.<\/p>\n\n\n\n Primeiro, crie um reposit\u00f3rio para armazenar a imagem Docker da aplica\u00e7\u00e3o FastAPI.<\/p>\n\n\n\n Depois de criar, copie e guarde o Repository URI<\/em><\/strong>. Ele ser\u00e1 necess\u00e1rio mais adiante, na hora de fazer o build e o push da imagem Docker.<\/p>\n\n\n\n O App Runner precisa de permiss\u00e3o expl\u00edcita para puxar imagens do Amazon ECR. Esse acesso \u00e9 concedido criando uma role no IAM.<\/p>\n\n\n\n Leia tamb\u00e9m: <\/strong>Construindo redes neurais do zero<\/a><\/p>\n<\/blockquote>\n\n\n\n Com os pr\u00e9-requisitos da AWS prontos, chegou a hora de criar o servi\u00e7o do App Runner que vai rodar a aplica\u00e7\u00e3o FastAPI. Siga os passos abaixo:<\/p>\n\n\n\n Assim que o servi\u00e7o for criado e o deploy terminar, o App Runner passa a executar a sua aplica\u00e7\u00e3o FastAPI conteinerizada. Daqui em diante, o foco \u00e9 adaptar o c\u00f3digo da aplica\u00e7\u00e3o para funcionar bem com o App Runner.<\/p>\n\n\n\n Leia tamb\u00e9m: <\/strong>Al\u00e9m do \u201cvibe coding\u201d: engenharia com IA e Cursor<\/a><\/p>\n<\/blockquote>\n\n\n\n Para automatizar o processo de build e deploy, \u00e9 preciso configurar no GitHub as credenciais da AWS e as vari\u00e1veis espec\u00edficas de cada ambiente. Isso permite que o workflow do GitHub Actions se autentique na AWS e envie imagens Docker para o Amazon ECR.<\/p>\n\n\n\n Usar ambientes ajuda a isolar credenciais e aplicar controles extras, como revisores obrigat\u00f3rios ou secrets espec\u00edficos de cada ambiente.<\/p>\n\n\n\n Com o ambiente criado, o pr\u00f3ximo passo \u00e9 adicionar os secrets que o pipeline de CI\/CD precisa.<\/p>\n\n\n\n Garanta que as credenciais do IAM usadas aqui tenham permiss\u00e3o para autenticar no ECR e enviar imagens para o reposit\u00f3rio.<\/p>\n\n\n\n Com o ambiente e os secrets configurados no GitHub, chegou a hora de criar o workflow do GitHub Actions que faz o build da imagem Docker e a envia automaticamente para o Amazon ECR.<\/p>\n\n\n\n Leia tamb\u00e9m:<\/strong> Como usar Selenium para web scraping no AWS Lambda<\/a><\/p>\n<\/blockquote>\n\n\n\n Vamos come\u00e7ar pelo arquivo respons\u00e1vel por instanciar a aplica\u00e7\u00e3o FastAPI. O trecho de c\u00f3digo abaixo mostra um setup m\u00ednimo de FastAPI, expondo um \u00fanico endpoint GET \/health.<\/p>\n\n\n Agora, veja o Dockerfile. Ele \u00e9 propositalmente simples: instala as dependencies com o gerenciador de pacotes uv, define o diret\u00f3rio de trabalho e chama o script entrypoint.sh. Preste aten\u00e7\u00e3o especial na porta exposta<\/strong>, que precisa coincidir com a porta configurada no AWS App Runner<\/strong> (8080 por padr\u00e3o).<\/p>\n\n\n O arquivo docker-compose.yml tamb\u00e9m \u00e9 direto. Ele referencia o Dockerfile, exp\u00f5e as portas do container e carrega as vari\u00e1veis de ambiente do arquivo .env.<\/p>\n\n\n Por fim, o script entrypoint.sh<\/strong> sobe o servidor Uvicorn, escutando na porta 8080.<\/p>\n\n\n Crie um arquivo chamado .github\/workflows\/app-runner-deploy.yml na raiz do projeto e adicione a configura\u00e7\u00e3o abaixo. Esse workflow define o pipeline do GitHub Actions respons\u00e1vel pelo deploy. Ele executa os seguintes passos: autentica na AWS, faz o build da imagem Docker, aplica a tag e envia a imagem para o Amazon ECR.<\/p>\n\n\n Depois de fazer o commit e o push das suas mudan\u00e7as para a branch escolhida (neste exemplo, a branch main), a execu\u00e7\u00e3o do workflow aparece na aba Actions<\/strong>. Se tudo estiver configurado corretamente, todos os passos v\u00e3o terminar com sucesso.<\/p>\n\n\n\n O resultado final \u00e9 uma imagem Docker dispon\u00edvel no seu reposit\u00f3rio do Amazon ECR.<\/p>\n\n\n\n Depois que voc\u00ea envia o c\u00f3digo para a branch definida no workflow do GitHub Actions, o deploy no App Runner \u00e9 disparado automaticamente. Voc\u00ea acompanha o processo e consulta todos os logs de execu\u00e7\u00e3o direto no console do servi\u00e7o do App Runner.<\/p>\n\n\n\n O deploy deve terminar em poucos minutos.<\/p>\n\n\n\n Para testar a aplica\u00e7\u00e3o, acesse a URL clicando em Default domain<\/strong> e chame, por exemplo, o endpoint \/docs para ver a documenta\u00e7\u00e3o da API.<\/p>\n\n\n\n O AWS App Runner oferece um equil\u00edbrio convincente entre simplicidade e robustez operacional. Para aplica\u00e7\u00f5es conteinerizadas como servi\u00e7os FastAPI, ele elimina boa parte do overhead tradicional de gest\u00e3o de infraestrutura e ainda se integra de forma limpa ao restante do ecossistema AWS.<\/p>\n\n\n\n Para muitos servi\u00e7os de backend e APIs, o App Runner acerta o ponto entre plataformas totalmente gerenciadas e solu\u00e7\u00f5es mais complexas como ECS ou EKS.<\/p>\n\n\n\n Leia tamb\u00e9m: <\/strong>Boas pr\u00e1ticas de FinOps na AWS: como cortar e otimizar custos de cloud<\/a><\/p>\n<\/blockquote>\n\n\n\n Este artigo foca em um setup simples e funcional, mas h\u00e1 v\u00e1rias frentes que valem a explora\u00e7\u00e3o seguinte:<\/p>\n\n\n\nConfigura\u00e7\u00f5es na AWS<\/h2>\n\n\n\n
Reposit\u00f3rio no Elastic Container Registry<\/h3>\n\n\n\n
\n
A role do App Runner<\/h3>\n\n\n\n
\n
{\n\u00a0 \"Version\"<\/span>: \"2012-10-17\"<\/span>,\n\u00a0 \"Statement\"<\/span>: [\n\u00a0 \u00a0 {\n\u00a0 \u00a0 \u00a0 \"Effect\"<\/span>: \"Allow\"<\/span>,\n\u00a0 \u00a0 \u00a0 \"Principal\"<\/span>: {\n\u00a0 \u00a0 \u00a0 \u00a0 \"Service\"<\/span>: \"apprunner.amazonaws.com\"<\/span>\n\u00a0 \u00a0 \u00a0 },\n\u00a0 \u00a0 \u00a0 \"Action\"<\/span>: \"sts:AssumeRole\"<\/span>\n\u00a0 \u00a0 }\n\u00a0 ]\n}<\/code><\/span>Code language:<\/span> JSON \/ JSON with Comments<\/span> (<\/span>json<\/span>)<\/span><\/small><\/pre>\n\n\n\n
\n
Criando o servi\u00e7o no App Runner<\/h2>\n\n\n\n
\n
\n
A base do CI\/CD: conectando o GitHub \u00e0 AWS<\/h2>\n\n\n\n
Crie um ambiente no GitHub<\/h3>\n\n\n\n
\n
Gerenciando credenciais da AWS e vari\u00e1veis de deploy com seguran\u00e7a<\/h2>\n\n\n\n
Adicione os secrets do ambiente<\/h3>\n\n\n\n
\n
Boas pr\u00e1ticas de seguran\u00e7a para CI\/CD<\/h3>\n\n\n\n
\n
\n
Mudan\u00e7as no c\u00f3digo: adaptando a aplica\u00e7\u00e3o para rodar no App Runner<\/h2>\n\n\n\n
import<\/span> os\n\nfrom<\/span> fastapi import<\/span> FastAPI\nfrom<\/span> fastapi.middleware.cors import<\/span> CORSMiddleware\nfrom<\/span> starlette.middleware.sessions import<\/span> SessionMiddleware\n\n\napp = FastAPI()\n\napp.add_middleware(\n\u00a0 \u00a0 CORSMiddleware,\n\u00a0 \u00a0 allow_origins=[\"*\"<\/span>],\n\u00a0 \u00a0 allow_credentials=True,\n\u00a0 \u00a0 allow_methods=[\"*\"<\/span>],\n\u00a0 \u00a0 allow_headers=[\"*\"<\/span>],\n)\n\napp.add_middleware(SessionMiddleware, secret_key=os.getenv(\"JWT_SECRET_KEY\"<\/span>, \"default\"<\/span>))\n\n@app.get(\"\/health\"<\/span>)\nasync<\/span> def health_check():\n\u00a0 \u00a0 \"\"<\/span>\"Health check endpoint.\"<\/span>\"\"<\/span>\n\u00a0 \u00a0 return<\/span> {\"status\"<\/span>: \"ok\"<\/span>}<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\nFROM python:3.12<\/span>.11<\/span>-slim-bookworm AS builder\n\nCOPY --from<\/span>=ghcr.io\/astral-sh\/uv:latest \/uv \/uvx \/bin\/\n\nWORKDIR \/app\nENV PATH=\"\/app\/.venv\/bin:$PATH\"<\/span>\n\nENV UV_LINK_MODE=copy\n\nCOPY pyproject.toml uv.lock .python-version .\/\nRUN uv sync --locked --no-dev\nRUN uv pip install --system alembic\n\nCOPY . .\n\nFROM python:3.12<\/span>.11<\/span>-slim-bookworm\n\nCOPY --from<\/span>=ghcr.io\/astral-sh\/uv:latest \/uv \/uvx \/bin\/\nRUN apt-get<\/span> update && \\\n apt-get<\/span> upgrade -y && \\\n apt-get<\/span> clean && \\\n rm -rf \/var\/lib\/apt\/lists\/* \/tmp\/* \/var\/tmp\/*\n\nRUN pip install --upgrade pip setuptools\n\nWORKDIR \/app\nENV PATH=\"\/app\/.venv\/bin:$PATH\"\n\nCOPY --from=builder \/app \/app\nCOPY entrypoint.sh \/entrypoint.sh\n\nRUN chmod +x \/entrypoint.sh\n\nEXPOSE 8080\n\nENTRYPOINT [\"\/entrypoint.sh\"]<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\nservices<\/span>:\n\u00a0 singuessr<\/span>:\n\u00a0 \u00a0 build<\/span>:\n\u00a0 \u00a0 \u00a0 context<\/span>: .\n\u00a0 \u00a0 \u00a0 dockerfile<\/span>: Dockerfile<\/span>\n\u00a0 \u00a0 ports<\/span>:\n\u00a0 \u00a0 \u00a0 -<\/span> \"8080:8000\"<\/span>\n\u00a0 \u00a0 env_file<\/span>:\n\u00a0 \u00a0 \u00a0 -<\/span> .env<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n#!\/bin\/sh<\/span>\n\nset -e\n\necho<\/span> \"Starting application...\"<\/span>\nuv run uvicorn main:app --host 0.0<\/span>.0<\/span>.0<\/span> --port 8080<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nAutomatizando build e deploy com GitHub Actions<\/h2>\n\n\n\n
name: AWS App Runner Deploy Develop\n\non:\n\u00a0 push:\n\u00a0 \u00a0 branches:\n\u00a0 \u00a0 \u00a0 - main # \u2190 branch name<\/span>\n\njobs:\n\u00a0 deploy:\n\u00a0 \u00a0 name: FastAPI deployment to AWS App Runner\n\u00a0 \u00a0 runs-on: ubuntu-latest\n\u00a0 \u00a0 environment: Production # \u2190 Github environment<\/span>\n\n\u00a0 \u00a0 steps:\n\u00a0 \u00a0 \u00a0 - name: Checkout\n\u00a0 \u00a0 \u00a0 \u00a0 uses: actions\/checkout@v3\n\n\u00a0 \u00a0 \u00a0 - name: Configure AWS Credentials\n\u00a0 \u00a0 \u00a0 \u00a0 uses: aws-actions\/configure-aws-credentials@v2\n\u00a0 \u00a0 \u00a0 \u00a0 with:\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY }}\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 aws-region: ${{ secrets.AWS_REGION }}\n\n\u00a0 \u00a0 \u00a0 - name: Login to Amazon ECR\n\u00a0 \u00a0 \u00a0 \u00a0 uses: aws-actions\/amazon-ecr-login@v1\n\n\u00a0 \u00a0 \u00a0 - name: Build Docker image\n\u00a0 \u00a0 \u00a0 \u00a0 run: |\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 docker build \\\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 -t fastapi-app-runner:latest \\\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 -f Dockerfile .\n\n\u00a0 \u00a0 \u00a0 - name: Tag Docker image\n\u00a0 \u00a0 \u00a0 \u00a0 run: |\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 docker tag fastapi-app-runner:latest \\\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 ${{ secrets.ECR_REPOSITORY_URI }}:latest\n\n\u00a0 \u00a0 \u00a0 - name: Push Docker image to ECR\n\u00a0 \u00a0 \u00a0 \u00a0 run: |\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 docker push ${{ secrets.ECR_REPOSITORY_URI }}:latest<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n![\"Configura\u00e7\u00e3o](\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/01\/app-runner-deploy.png\")
<\/figure>\n\n\n\n![\"Aplica\u00e7\u00e3o](\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/01\/fastapi-app-runner.png\")
<\/figure>\n\n\n\nDeploy no App Runner: disparando e acompanhando publica\u00e7\u00f5es autom\u00e1ticas<\/h2>\n\n\n\n
![\"Log](\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/01\/app-runner-event-log-1200x278.png\")
<\/figure>\n\n\n\n![\"Resposta](\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/01\/fast-ap-1200x272.png\")
<\/figure>\n\n\n\nConsidera\u00e7\u00f5es finais e pr\u00f3ximos passos<\/h2>\n\n\n\n
Por que o App Runner funciona bem com FastAPI<\/h3>\n\n\n\n
\n
\n
Pr\u00f3ximos passos: escala, seguran\u00e7a e melhorias operacionais<\/h2>\n\n\n\n
\n
\n
![\"legacy-app-ckl](\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2023\/06\/legacy-app-ckl-1200x409.jpg\")
<\/a><\/figure>\n","protected":false},"excerpt":{"rendered":"