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:
| Arquivo | Arquitetura | Dispositivos de exemplo |
|---|---|---|
Dockerfile | Padrão (usado como alternativa) | Qualquer |
Dockerfile.armv7 | ARMv7 | Raspberry Pi 3/4 (32 bits) |
Dockerfile.arm64 | ARM64 | NVIDIA Jetson, RPi 4/5 (64 bits) |
Dockerfile.amd64 | AMD64 | PCs 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
-slimou-alpinepara 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 delatestpara 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.