Skill de Docker Volumes
Domine o armazenamento persistente do Docker, incluindo volumes nomeados, bind mounts, tmpfs e procedimentos de backup/restauração de dados.
Propósito
Implementar persistência de dados confiável para containers com gerenciamento adequado de volume, estratégias de backup e manipulação de permissões.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| volume_name | string | Não | - | Nome para o volume |
| mount_type | enum | Não | volume | volume/bind/tmpfs |
| backup | boolean | Não | false | Incluir comandos de backup |
Tipos de Armazenamento
| Tipo | Persistência | Caso de Uso | Gerenciado Por |
|---|
| Named Volume | Sim | Dados de Produção | Docker |
| Bind Mount | Sim | Desenvolvimento, configs | Host |
| tmpfs | Não (memória) | Secrets, arquivos temporários | Docker |
| Anonymous | Ciclo de vida do container | Espaço temporário (scratch space) | Docker |
Operações de Volume
Named Volumes
# Criar volume
docker volume create app_data
# Usar no container
docker run -d \
-v app_data:/var/lib/postgresql/data \
postgres:16-alpine
# Inspecionar volume
docker volume inspect app_data
# Listar volumes
docker volume ls
# Remover volumes não utilizados
docker volume prune
Bind Mounts
# Desenvolvimento - montar código-fonte
docker run -d \
-v $(pwd)/src:/app/src \
node:20-alpine
# Configuração apenas leitura (read-only)
docker run -d \
-v /etc/app/config.yaml:/app/config.yaml:ro \
myapp
tmpfs Mounts
# Dados sensíveis em memória
docker run -d \
--tmpfs /app/secrets:rw,noexec,nosuid,size=64m \
myapp
# Sintaxe do Compose
services:
app:
volumes:
- type: tmpfs
target: /app/tmp
tmpfs:
size: 100m
Docker Compose Volumes
services:
database:
image: postgres:16-alpine
volumes:
- db_data:/var/lib/postgresql/data
- ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro
environment:
POSTGRES_PASSWORD: ${DB_PASSWORD}
app:
image: myapp
volumes:
- uploads:/app/uploads
- ./config:/app/config:ro
volumes:
db_data:
driver: local
uploads:
external: true # Pré-criado
Backup & Restauração
Backup de Volume
# Backup para arquivo tar
docker run --rm \
-v app_data:/source:ro \
-v $(pwd)/backups:/backup \
alpine tar cvf /backup/app_data_$(date +%Y%m%d).tar -C /source .
# Backup compactado
docker run --rm \
-v app_data:/source:ro \
-v $(pwd)/backups:/backup \
alpine tar czvf /backup/app_data_$(date +%Y%m%d).tar.gz -C /source .
Restaurar Volume
# Restaurar de um tar
docker run --rm \
-v app_data:/dest \
-v $(pwd)/backups:/backup:ro \
alpine tar xvf /backup/app_data_20240101.tar -C /dest
Clonar Volume
docker run --rm \
-v source_volume:/from:ro \
-v target_volume:/to \
alpine cp -av /from/. /to/
Tratamento de Erros
Erros Comuns
| Erro | Causa | Solução |
|---|
volume in use | Container em execução | Pare o container primeiro |
permission denied | Incompatibilidade de UID | Corrija a propriedade (ownership) |
no space left | Disco cheio | Limpe ou expanda |
path not found | Bind mount ausente | Crie o diretório |
Correções de Permissão
# Verificar propriedade (ownership)
docker run --rm -v app_data:/data alpine ls -la /data
# Corrigir propriedade (deve corresponder ao usuário do container)
docker run --rm -v app_data:/data alpine chown -R 1000:1000 /data
# SELinux (RHEL/CentOS)
docker run -v /host/path:/container/path:Z myimage
Solução de Problemas (Troubleshooting)
Checklist de Depuração
- O volume existe?
docker volume ls - O mount está visível?
docker exec <c> df -h - As permissões estão corretas?
ls -la no container - Os dados estão persistindo? Pare/inicie o container
Comandos de Diagnóstico
# Verificar localização do volume
docker volume inspect app_data --format '{{.Mountpoint}}'
# Verificar mounts do container
docker inspect <container> --format '{{json .Mounts}}'
# Verificar uso de disco
docker system df -v
