Эволюция спецификации Docker Compose (Compose Spec vs v1/v2/v3)

Предупреждение WARN the attribute version is obsolete, it will be ignored, please remove it генерируется современным CLI Docker Compose v2. Исторически директива version: '3.8' или version: '2.4' использовалась устаревшим Python-инструментом docker-compose (v1) для определения схемы валидации и поддержки конкретных параметров. В современном стандарте Compose Specification формат версионирования внутри файла упразднен: движок автоматически поддерживает все актуальные директивы спецификации.

Бизнес-риски:

Засорение логов CI/CD систем предупреждениями, ложное срабатывание строгих проверок качества кода (Quality Gates), потенциальные коллизии параметров при смешивании старых и новых директив.

Таблица эволюции форматов Docker Compose

Пошаговое обновление файла до актуальной спецификации Compose

Сценарий 1: Простое удаление верхней строки version

Откройте файл docker-compose.yml в любом текстовом редакторе и удалите директиву version на первой строке:

# Оставьте сразу блок определения сервисов:
services:
  web:
    image: nginx:alpine
    ports:
      - '80:80'
  redis:
    image: redis:alpine

Сценарий 2: Автоматическое удаление устаревшего ключа через CLI

Для массовой очистки репозиториев в автоматизированных пайплайнах:

# Валидация обновленного манифеста без атрибута version
docker compose config

# Запуск стека по спецификации Compose V2
docker compose up -d

Сценарий 3: Переименование файла в стандартное имя compose.yaml

Согласно современной спецификации, предпочтительным именем манифеста является compose.yaml вместо docker-compose.yml:

# Переименование в рекомендуемый стандартом формат:
mv docker-compose.yml compose.yaml

# Docker Compose автоматически найдет compose.yaml без дополнительных флагов:
docker compose up -d

Типовые ошибки администраторов

• Откат на старый docker-compose (v1): Попытка установить устаревший python-пакет docker-compose v1 ради совместимости с версиями — грубая ошибка, так как v1 официально снят с поддержки.
• Удаление отступов в блоке services: При удалении верхней строки убедитесь, что блок services: остался на нулевом уровне индентации (без пробелов перед словом).