Carregando
0x50Lição 6 de 16

Imagens de contêiner para entrega

Empacote aplicações como imagens de contêiner pequenas, seguras e rápidas de construir: camadas e cache, builds multi-stage, usuários sem root e tags imutáveis.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Explicar imagens, contêineres e camadas, e ordenar um Dockerfile para aproveitar bem o cache
  • Encolher as imagens com builds multi-stage e imagens base pequenas
  • Usar tags e referências de imagem que tornam os deploys reprodutíveis

“Na minha máquina funciona” era a música-tema da Noite do Release. Os contêineres acabam com isso: uma imagem empacota a aplicação com o seu runtime e as suas bibliotecas, e um contêiner é uma instância em execução de uma imagem - idêntica no notebook, no CI e em produção.

Uma imagem é uma pilha de camadas somente leitura. Cada instrução de um Dockerfile que altera o sistema de arquivos (RUN, COPY, ADD) acrescenta uma camada, e o Docker faz cache de cada passo: se uma instrução e tudo antes dela não mudaram, a camada em cache é reaproveitada. Quando um passo muda, todos os passos depois dele são reconstruídos.

Dockerfile
1# ---- build stage: has compilers and build tools ----
2FROM python:3.12-slim AS build
3WORKDIR /src
4COPY requirements.txt .
5RUN pip wheel --wheel-dir /wheels -r requirements.txt   # cached until requirements change
6COPY . .
7RUN pip wheel --no-deps --wheel-dir /wheels .
8
9# ---- runtime stage: only what the app needs to run ----
10FROM python:3.12-slim
11RUN useradd --create-home baker
12COPY --from=build /wheels /wheels
13RUN pip install --no-cache-dir /wheels/* && rm -rf /wheels
14USER baker
15EXPOSE 8000
16CMD ["gunicorn", "byte_bakery.app:app", "--bind", "0.0.0.0:8000"]

O que faz deste um bom Dockerfile:

  • Ordem pensada para o cache: copie a lista de dependências e instale as dependências antes de copiar o código-fonte. O código muda muitas vezes por dia; as dependências, raramente - então a instalação lenta continua em cache.
  • Build multi-stage: a imagem final copia só os wheels construídos, deixando compiladores e caches de build para trás, no estágio de build. Imagens menores são baixadas mais rápido e têm menos vulnerabilidades.
  • Imagem base pequena: bases -slim, Alpine ou distroless em vez de um sistema operacional completo.
  • Usuário sem root: se a aplicação for comprometida, o atacante não é root no contêiner.
  • Um .dockerignore deixa .git, virtualenvs locais e segredos como .env fora do contexto de build.

Tags e digests

Uma referência de imagem se parece com registry.example.com/byte-bakery/shop:1.4.0. A tag (1.4.0) é um rótulo que pode ser movido - alguém pode enviar uma imagem diferente com a mesma tag, e latest (o padrão quando você omite a tag) muda o tempo todo. Um digest (shop@sha256:9c1f...) é o hash do conteúdo da imagem e nunca pode apontar para outra coisa.

Implante versões específicas - nunca latest - e fixe pelo digest onde precisar de certeza. Muitas equipes usam o SHA do commit como tag das imagens e deixam a ferramenta de deploy traduzir as tags em digests.

layer_cache.py
1steps = ["FROM python:3.12-slim", "COPY . .", "RUN pip install -r requirements.txt", "CMD ..."]
2changed_step = 1   # we edited app.py, which "COPY . ." includes
3for index, step in enumerate(steps):
4    print("REBUILD" if index >= changed_step else "CACHED ", step)
Saída
CACHED  FROM python:3.12-slim
REBUILD COPY . .
REBUILD RUN pip install -r requirements.txt
REBUILD CMD ...

Copiar tudo antes de instalar as dependências faz uma mudança de uma linha no app.py reinstalar todos os pacotes. Inverta a ordem e a instalação continua em cache.

Principais conclusões

  • Uma imagem é uma pilha de camadas em cache; quando um passo muda, todos os passos seguintes são reconstruídos.

  • Coloque os passos que mudam pouco (dependências) antes dos que mudam muito (código-fonte).

  • Use builds multi-stage, imagens base pequenas, um usuário sem root e um .dockerignore.

  • Implante tags versionadas ou digests, nunca latest.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: automatize tarefas de DevOps com Python

Escreva as pequenas ferramentas em Python que times de DevOps realmente criam, como executores de pipeline, verificadores de plano, calculadoras de métricas e scanners, e execute-as com entradas de exemplo. Elas rodam localmente no navegador; não é preciso ter servidores nem contas na nuvem.

Exercício 1

Preveja o cache de camadas

+25 XP

A entrada são os passos do Dockerfile, --- e depois os arquivos alterados desde o último build (talvez nenhum). Um passo COPY é afetado quando um arquivo alterado combina com uma das suas origens (cada palavra entre COPY e o destino, que é a última palavra): . combina com qualquer arquivo; uma origem terminada em / combina com os arquivos dentro daquela pasta; qualquer outra precisa combinar exatamente. Os outros passos nunca são afetados por arquivos.

O primeiro passo afetado e todos os passos depois dele são reconstruídos. Imprima cada passo como CACHED ... ou REBUILD ... (CACHED seguido de dois espaços, para alinhar) e depois rebuilt 2 of 6 steps.

  • Ordem boa, mudança de código
  • Ordem ruim, mudança de código
  • Cópias de pastas
  • Nada mudou
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Confira as referências de imagem

+25 XP

A primeira linha da entrada lista os registries permitidos, separados por vírgulas. Cada linha seguinte é uma referência de imagem. O registry dela é a primeira parte separada por / se essa parte contiver um . ou : ou for localhost; caso contrário, é docker.io. Um digest vem depois de @; uma tag vem depois do último : que aparece depois da última /.

Confira nesta ordem e imprima REJECT (registry docker.io not allowed), REJECT (no tag means latest), REJECT (latest is not a version), OK (pinned by digest), OK (version tag) para tags como 1.4.0 ou v1.4.0, ou WARN (tag main can move) para qualquer outra tag - cada um depois da referência e de dois-pontos. Termine com rejected: 2 of 6.

  • Manifestos da Byte Bakery
  • Docker Hub permitido
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…