Dev Containers no VSCode: Ambientes Reproduzíveis para Desenvolver DAGs do Apache Airflow

Gilmar Pupo
24 de set.
2 min de leitura

O desenvolvimento moderno exige ambientes consistentes, rápidos de configurar e sem o famoso “funciona na minha máquina”.Com o Dev Container, integrado ao VSCode, é possível encapsular todo o setup do projeto dentro de um container Docker — incluindo sistema operacional, dependências, ferramentas e extensões do editor. Adotar Dev Containers no VSCode é uma maneira simples e eficaz de garantir ambientes homogêneos e acelerar o desenvolvimento.

No caso do Airflow, isso elimina as dores do setup local e permite desenvolver DAGs de forma reprodutível, segura e totalmente alinhada ao ambiente de produção.

O que é um Dev Container?

Um Dev Container é uma configuração que permite abrir qualquer pasta ou repositório diretamente em um container Docker, usando esse container como ambiente de desenvolvimento.O arquivo de configuração do Dev Container define tudo: sistema operacional, bibliotecas, extensões do VSCode e até serviços adicionais como bancos de dados.

Isso significa que todo o time (ou comunidade, no caso de projetos open source) terá o mesmo ambiente de desenvolvimento, pronto para uso, sem variações de setup local.

Pré-requisitos para começar

Docker instalado na máquina.
VSCode configurado.
Extensão Dev Containers (ou Remote - Containers).
(Opcional) Docker Compose para setups mais avançados.

Como funciona na prática

Você cria um diretório de projeto e abre no VSCode.
O editor gera ou reconhece a pasta .devcontainer, onde ficam as definições do ambiente.
Ao reabrir no container, o VSCode passa a rodar todo o desenvolvimento dentro daquele ambiente isolado.

Assim, as ferramentas e dependências vivem no container, e não no seu sistema operacional, evitando conflitos e poluição da máquina local.

Vantagens de usar Dev Containers

Ambiente reproduzível: todos os desenvolvedores usam a mesma base.
Independência de sistema operacional: funciona em Windows, Linux ou macOS.
Customização sob medida: instale pacotes, ferramentas e extensões só dentro do container.
Integração com VSCode: debug, autocomplete e execução de scripts acontecem de forma natural, mas dentro de um ambiente isolado.

Aplicando no desenvolvimento de DAGs do Airflow

Quando falamos em Apache Airflow, os Dev Containers se tornam ainda mais valiosos:

É possível garantir que a versão do Airflow e todas as bibliotecas sejam idênticas às do ambiente de produção.
Não há necessidade de instalar o Airflow e suas dependências localmente, o que normalmente gera conflitos.
O VSCode reconhece o container como ambiente oficial, permitindo linting, autocomplete e debug dos DAGs diretamente no editor.
A pasta dags/ pode ser sincronizada entre a máquina local e o container, de forma que qualquer mudança seja refletida automaticamente no Airflow em execução.

Benefícios práticos para times

Onboarding rápido: novos desenvolvedores só precisam clonar o repositório e abrir o projeto no container.
Produtividade maior: menos tempo resolvendo incompatibilidades de ambiente.
Escalabilidade: ambientes padronizados para projetos de longa duração ou equipes distribuídas.