Objetivos dessa aula

• Entender como criar uma imagem Docker para a nossa aplicação
• Aprender a rodar a aplicação utilizando Docker
• Introduzir o conceito de Docker Compose para múltiplos contêineres
• Aprender o que é um Dockerfile e sua estrutura
• Entender os benefícios e motivos da mudança para o PostgreSQL

Parte 1

Docker e Postgres

Docker

Docker é uma ferramenta para criar containers.

Containers são formas de isolar as dependências. Da mesma forma que fazemos com o ambiente virtual. Que isolam as dependências do python.

No caso dos containers Docker, estamos falando de isolamento de ferramentas do sistema operacional. Isolamos programas e ambientes de forma completa

Cruso gratuito sobre docker da linuxtips

PostgreSQL

Um Banco de Dados Relacional de código aberto.

• Escalabilidade: SQLite não é ideal para aplicações em larga escala ou com grande volume de dados. PostgreSQL foi projetado para lidar com uma grande quantidade de dados e requisições.
• Concorrência: diferentemente do SQLite, que tem limitações para gravações simultâneas, o PostgreSQL suporta múltiplas operações simultâneas.
• Funcionalidades avançadas: PostgreSQL vem com várias extensões e funcionalidades que o SQLite pode não oferecer.

Nota importante

Embora para o escopo da nossa aplicação e os objetivos de aprendizado o SQLite pudesse ser suficiente, é sempre bom nos prepararmos para cenários de produção real. A adoção de PostgreSQL nos dá uma prévia das práticas do mundo real e garante que nossa aplicação possa escalar sem grandes modificações de infraestrutura.

Executando o postgres com docker

Essa instrução vai iniciar um container do postgres no nosso pc e disponibilizando ele na porta 5432.

Conectando nossa aplicação ao postgres

Precisamos instalar o driver para o postgres na nossa aplicação:

Também precisamos alterar a URL do banco de dados

Subindo a aplicação

Erro na migração

Ao fazer uma chamada que depende do banco de dados, vamos obter um:

Internal Server Error

Se olharmos o shell

A tabela users não existe na nossa aplicação.

Executando as migrações no novo banco

Com isso, tudo deve funcionar como esperado!

Os testes envolvendo o postgres

Se executarmos os testes, eles vão continuar passando, pois os dados estão fixos na fixture:

Usando as variáveis de ambiente no teste

Porém, agora temos um novo problema :)

O container do banco de dados precisa estar rodando

Testando com Docker

Existe uma biblioteca python que gerencia as dependências de containers externos para que a aplicação seja executada. O TestContainers

Para instalar:

Alterando a fixture para usar o TestContainer

Assim os testes podem iniciar um container novo a cada vez que a fixture for chamada

O escopo da fixture

Diferentes escopos

• function: executada em todas as funções de teste;
• class: executada uma vez por classe de teste;
• module: executada uma vez por módulo;
• package: executada uma vez por pacote;
• session: executava uma vez por execução dos testes;

Para resolver o problema com a lentidão dos testes, iremos criar uma fixture para iniciar o container do banco de dados com o escopo session.

Criando uma nova fixture

Para criar um única imagem docker, podemos iniciar ela de forma isolada na aplicação

Alterando a fixture de session

Agora a session faz tudo que precisa fazer, mas sem a responsabilidade do iniciar a conexão

Parte 2

Criando a imagem do nosso projeto

Criando a imagem do nosso projeto

Rodando o código

Podemos acessar para ver nossa aplicação http://127.0.0.1:8000/docs

Parte 3

Docker compose

Docker compose

A ideia do docker compose é criar um único arquivo yaml que reúna todos os containers necessários para executar a aplicação.

Dessa forma podemos gerenciar todos os os containers com um único comando o docker compose.

O banco de dados

A aplicação

Rodando tudo

Funciona?

Não ... migrações ...

Entrypoint

A ideia do entrypoint é alterar o comando CMD para executar um script bash.

Assim que o container for inciado, ele executará esse script.

Entrypoint no compose

Refazendo o container

Commit

Suplementar / Para próxima aula

Na próxima aula vamos conversar sobre como criar estruturas de testes que rodam no github, via integração contínua. Uma boa introdução para o assunto é essa live de python:

Github Actions - Live de Python #170 - Com Willian Lopes

Não esqueça de responder ao quiz

Quiz