Можно ли хранить DataFile в контейнере?

Можно ли хранить DataFile в контейнере?

Краткий ответ

Технически можно, но это не рекомендуется в production. Файлы в контейнерах хранятся в памяти (по умолчанию в layered union filesystem) и теряются при перезагрузке контейнера. Это нарушает принцип twelve-factor app и создаёт проблемы с масштабируемостью.

Проблемы хранения файлов в контейнере

1. Потеря данных при перезагрузке

FROM openjdk:17
WORKDIR /app
COPY app.jar .
RUN mkdir -p /app/uploads
ENTRYPOINT ["java", "-jar", "app.jar"]

@Service
public class FileUploadService {
    private String uploadDir = "/app/uploads";  // ❌ ПЛОХО
    
    public void saveFile(String filename, MultipartFile file) throws IOException {
        file.transferTo(new File(uploadDir + "/" + filename));
        // Файл сохранён в контейнере
        // При перезагрузке контейнера - файл потеряется!
    }
}

# Контейнер работает
docker run -d myapp
# Пользователь загружает файл
# Файл хранится в /app/uploads внутри контейнера

# Контейнер упал или был переделан
docker stop <container>
docker run -d myapp  # новый контейнер
# ВСЕ файлы потеряны!

2. Увеличение размера образа контейнера

FROM openjdk:17
WORKDIR /app
COPY app.jar .
RUN mkdir -p /app/data && fallocate -l 1G /app/data/large_file  # 1GB!
ENTRYPOINT ["java", "-jar", "app.jar"]

# docker build -> образ весит уже 1GB+
# Каждый раз при запуске контейнера весь образ загружается

3. Проблемы при масштабировании (множество контейнеров)

// Представь 3 реплики приложения
// Container 1 -> хранит файлы в /app/uploads
// Container 2 -> хранит файлы в /app/uploads
// Container 3 -> хранит файлы в /app/uploads

// Пользователь загружает файл в Container 1
// Потом заходит снова - попадает в Container 2
// Container 2 не видит файл! (он только в Container 1)

@Service
public class FileService {
    public void uploadFile(String filename, MultipartFile file) throws IOException {
        file.transferTo(new File("/app/uploads/" + filename));
        // Файл только в этом контейнере!
    }
    
    public File getFile(String filename) {
        File file = new File("/app/uploads/" + filename);
        if (!file.exists()) {
            throw new FileNotFoundException("File not found");  // ???
            // Файл есть, но в другом контейнере!
        }
        return file;
    }
}

4. Проблемы обновления приложения

# Версия 1: контейнер с файлами
docker run -d app:v1
# Пользователи загружают файлы

# Выпустили версию 2
docker stop <container v1>
docker run -d app:v2  # новый контейнер
# ВСЕ файлы из v1 потеряны!

Правильные способы хранения файлов

1. Используй Volumes (Docker Volumes)

# docker-compose.yml
version: '3.8'
services:
  app:
    image: myapp:latest
    volumes:
      - uploads:/app/uploads  # именованный volume
    environment:
      UPLOAD_DIR: /app/uploads

volumes:
  uploads:  # создаст volume который persists между перезагрузками
    driver: local

# Volume остаётся даже после удаления контейнера
docker run -d -v uploads:/app/uploads myapp
# ...
docker stop <container>
docker run -d -v uploads:/app/uploads myapp  # файлы сохранены!

2. Используй Bind Mounts (монтирование директории хоста)

version: '3.8'
services:
  app:
    image: myapp:latest
    volumes:
      - ./uploads:/app/uploads  # директория хоста
    environment:
      UPLOAD_DIR: /app/uploads

# Файлы хранятся на хосте в ./uploads
docker run -d -v /host/path/uploads:/app/uploads myapp
# Даже если контейнер удалён, файлы остаются на хосте
ls /host/path/uploads/  # видны файлы

3. Используй облачное хранилище (S3, MinIO, GCS)

@Service
public class FileUploadService {
    @Autowired
    private AmazonS3 s3Client;
    
    public void uploadFile(String filename, MultipartFile file) throws IOException {
        // ✓ ПРАВИЛЬНО: файл хранится в S3
        PutObjectRequest request = new PutObjectRequest(
            "my-bucket",
            filename,
            file.getInputStream(),
            new ObjectMetadata()
        );
        s3Client.putObject(request);
    }
    
    public InputStream downloadFile(String filename) {
        S3Object s3Object = s3Client.getObject("my-bucket", filename);
        return s3Object.getObjectContent();
    }
}

// В любом контейнере, в любое время файл доступен из S3

4. Используй базу данных для хранения метаданных + внешнее хранилище

@Entity
public class FileMetadata {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private String id;
    
    private String filename;
    private String s3Path;  // путь в S3
    private Long fileSize;
    private LocalDateTime uploadedAt;
    private String uploadedBy;
}

@Service
public class FileService {
    @Autowired
    private AmazonS3 s3Client;
    
    @Autowired
    private FileMetadataRepository repository;
    
    public String uploadFile(String filename, MultipartFile file, String userId) throws IOException {
        // 1. Загруз в S3
        String s3Path = "uploads/" + UUID.randomUUID() + "/" + filename;
        s3Client.putObject("my-bucket", s3Path, file.getInputStream(), new ObjectMetadata());
        
        // 2. Сохрани метаданные в БД
        FileMetadata metadata = new FileMetadata();
        metadata.setFilename(filename);
        metadata.setS3Path(s3Path);
        metadata.setFileSize(file.getSize());
        metadata.setUploadedBy(userId);
        metadata.setUploadedAt(LocalDateTime.now());
        
        return repository.save(metadata).getId();
    }
    
    public FileInfo getFileInfo(String id) {
        FileMetadata metadata = repository.findById(id).orElseThrow();
        // Файл на S3, метаданные в БД
        return new FileInfo(metadata);
    }
}

Когда можно хранить файлы в контейнере

✓ Допустимо в разработке (development)

FROM openjdk:17
WORKDIR /app
COPY app.jar .
RUN mkdir -p /app/uploads
ENTRYPOINT ["java", "-jar", "app.jar"]

docker run -it -p 8080:8080 myapp:dev
# Локальная разработка - файлы теряются, но это окей

✓ Допустимо для кеша (если потеря некритична)

@Service
public class CacheService {
    private String cacheDir = "/tmp/cache";  // временная директория
    
    public void cacheThumbnail(String id, BufferedImage image) throws IOException {
        // Кеш - если потеряется, пересчитаем
        ImageIO.write(image, "jpg", new File(cacheDir + "/" + id + ".jpg"));
    }
}

✗ НЕ хранись для production данных

// ❌ ПЛОХО в production
public void saveImportantDocument(Document doc) throws IOException {
    FileOutputStream fos = new FileOutputStream("/app/documents/" + doc.getId() + ".pdf");
    // Документ потеряется при перезагрузке контейнера!
}

// ✓ ПРАВИЛЬНО
public void saveImportantDocument(Document doc) throws IOException {
    // Сохрани в S3, MongoDB, или другое persistent хранилище
    s3Client.putObject("documents", doc.getId() + ".pdf", docStream, metadata);
}

Практический пример: правильная архитектура

# docker-compose.yml
version: '3.8'
services:
  app:
    build: .
    ports:
      - "8080:8080"
    volumes:
      - ./tmp:/app/tmp  # временные файлы (для разработки)
    environment:
      SPRING_PROFILES_ACTIVE: dev
      STORAGE_TYPE: s3
      AWS_S3_BUCKET: my-bucket
      AWS_REGION: us-east-1
    depends_on:
      - db
  
  db:
    image: postgres:15
    volumes:
      - postgres_data:/var/lib/postgresql/data  # БД в volume
    environment:
      POSTGRES_PASSWORD: password

volumes:
  postgres_data:  # persists между перезагрузками

@Configuration
public class StorageConfig {
    @Bean
    public FileStorage fileStorage(@Value("${storage.type}") String type) {
        if ("s3".equals(type)) {
            return new S3FileStorage();  // Production
        } else if ("local".equals(type)) {
            return new LocalFileStorage();  // Development
        }
        throw new IllegalArgumentException("Unknown storage type: " + type);
    }
}

Заключение

❌ Не храни в контейнере:

• User-generated content
• Важные документы
• Данные, которые должны persisить
• Большие файлы

✅ Храни правильно:

• S3 / MinIO / GCS для файлов
• Volumes для persistent данных
• БД для метаданных
• Временные файлы в /tmp (очистятся автоматически)

✅ Помни:

• Контейнеры ephemeral (временные)
• Данные должны быть independent от контейнера
• Масштабируемость требует shared storage
• Twelve-factor app: конфиг и данные вне кода