Архитектура OverlayFS2 и причины сбоя монтирования

Ошибка failed to mount overlay: invalid argument возвращается системным вызовом mount(2) при попытке ядра Linux смонтировать слои файловой системы контейнера (lowerdir, upperdir, workdir, merged). Причиной является несовместимость параметров базовой файловой системы (например, XFS без поддержки ftype=1), повреждение метаданных в каталоге /var/lib/docker/overlay2 после сбоя питания, либо превышение лимита аргументов монтирования при огромном количестве слоев образа.

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

Полный отказ запуска контейнеров на конкретной ноде, зависание сборки образов в CI/CD, потеря данных в незакоммиченных слоях и повреждение runtime-директорий production-сервисов.

Таблица параметров подсистемы OverlayFS2

Пошаговый траблшутинг драйвера хранилища overlay2

Сценарий 1: Проверка поддержки d_type на файловой системе хоста

Если директория /var/lib/docker находится на разделе XFS, проверьте флаг ftype:

# Проверка параметров файловой системы XFS
xfs_info /var/lib/docker | grep ftype

# Если ftype=0, OverlayFS2 не поддерживается. Требуется переформатирование:
mkfs.xfs -n ftype=1 /dev/sdX

Сценарий 2: Очистка поврежденных слоев и метаданных Overlay2

При повреждении транзакций файловой системы после аварийного отключения:

# Остановка службы Docker
systemctl stop docker

# Проверка dmesg на ошибки файловой системы
dmesg -T | grep -E 'overlay|EXT4-fs|XFS'

# Проверка диска на ошибки (e2fsck / xfs_repair)
umount /var/lib/docker
e2fsck -fy /dev/mapper/vg_docker-lv_docker
mount /var/lib/docker

# Очистка невалидных слоев через daemon
systemctl start docker
docker system prune -a --volumes -f

Сценарий 3: Настройка storage-driver в daemon.json

Убедитесь в корректной конфигурации драйвера хранилища:

# Проверка конфигурации storage-driver в /etc/docker/daemon.json
{
  'storage-driver': 'overlay2',
  'storage-opts': [
    'overlay2.override_kernel_check=true'
  ]
}

# Перезапуск сервиса Docker
systemctl restart docker

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

• Запуск xfs_repair на смонтированной файловой системе: Это приводит к фатальному повреждению суперблока и полной потере данных.
• Ручное удаление папок внутри /var/lib/docker/overlay2: Ломает внутренний реестр слоев демона и вызывает лавину ошибок 500 при старте любого контейнера.