Skip to Content

Docker & Compose

Os apps IronFlock são empacotados como imagens Docker. O Dockerfile define o ambiente de execução do código do seu app.

Dockerfile

Todo app precisa de um Dockerfile na pasta raiz. Esse arquivo configura um ambiente Linux para o seu app, a partir de uma imagem base:

FROM python:3.11-slim WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . CMD ["python", "main.py"]

Consulte a documentação oficial do Dockerfile para a referência completa da sintaxe.

Suporte a Múltiplas Arquiteturas

Para atender a diferentes arquiteturas de dispositivo, adicione Dockerfiles específicos por arquitetura:

ArquivoArquiteturaDispositivos de exemplo
DockerfilePadrão (usado como alternativa)Qualquer
Dockerfile.armv7ARMv7Raspberry Pi 3/4 (32 bits)
Dockerfile.arm64ARM64NVIDIA Jetson, RPi 4/5 (64 bits)
Dockerfile.amd64AMD64PCs industriais, Intel NUCs

Ao gerar um release, o IronFlock escolhe o Dockerfile mais específico para cada arquitetura de destino. Se não houver um arquivo específico para a arquitetura, o Dockerfile padrão é usado.

Docker Compose

Para apps com vários serviços (por exemplo, um servidor web + um banco de dados + um worker), use o Docker Compose:

# docker-compose.yml version: "3" services: app: build: . volumes: - data:/data ports: - "5000:5000" restart: unless-stopped redis: image: redis:7-alpine restart: unless-stopped volumes: data:

Os serviços do Compose não recebem uma pasta do app: guarde os arquivos em um volume nomeado, como data acima. Ele sobrevive a reinícios e atualizações e é excluído quando o app é removido do dispositivo. Montar um caminho do host, como /data:/data ou /shared:/shared, requer acesso privilegiado.

Coloque o docker-compose.yml na pasta raiz em vez de (ou junto com) um Dockerfile. Quando os usuários iniciam ou param o app em seus dispositivos, toda a stack do Compose é gerenciada como uma unidade.

O Docker Compose dá a você mais controle sobre:

  • Montagens de volumes e persistência de dados
  • Rede entre serviços
  • Limites de recursos
  • Arquiteturas com vários containers

Boas Práticas

  • Mantenha as imagens pequenas — Use imagens base -slim ou -alpine para reduzir o tempo de download em dispositivos com recursos limitados.
  • Fixe as versões — Use tags de versão específicas (python:3.11-slim) em vez de latest para builds reproduzíveis.
  • Aproveite o cache de camadas — Copie os arquivos de dependências antes do código do app para aproveitar o cache de camadas do Docker.
  • Use .dockerignore — Exclua arquivos desnecessários (docs, testes, .git) do contexto de build.
Last updated on