Архитектура Docker Desktop Virtualization и механизм File Sharing

Ошибка Error response from daemon: mount denied: The path is not shared from the host and is not known to Docker характерна для сред Docker Desktop (macOS, Windows). В отличие от нативного Linux, где контейнеры используют общее ядро с хостом, в Docker Desktop демон dockerd работает внутри легковесной виртуальной машины Linux (Hyper-V, WSL2 или Apple Virtualization Framework). Для предоставления доступа к файлам хоста используется механизм File Sharing (VirtioFS / gRPC-FUSE / Plan 9). Если запрошенный каталог не включен в список разрешенных ресурсов, гипервизор блокирует операцию монтирования.

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

Полная блокировка локальной разработки у frontend/backend инженеров, невозможность локального тестирования микросервисов, потеря рабочего времени команд разработки.

Таблица компонентов виртуализации Docker Desktop

Пошаговая настройка разрешений File Sharing

Сценарий 1: Добавление каталога в File Sharing на macOS

1. Откройте Docker Desktop -> нажмите на иконку шестеренки (Settings).
2. Перейдите в раздел Resources -> File Sharing.
3. Нажмите кнопку + (Add) и выберите директорию вашего проекта (например, /Users/developer/projects).
4. Нажмите Apply & Restart.

Сценарий 2: Переключение на Virtualization Framework / VirtioFS

На современных версиях macOS VirtioFS обеспечивает максимальную скорость и стабильность:

# Проверка доступности пути через CLI macOS
ls -la /Users/$(whoami)/projects

# В настройках Docker Desktop:
# Settings -> General -> выберите 'Use Virtualization framework'
# Settings -> Features in development -> включите 'VirtioFS'

Сценарий 3: Настройка Docker Desktop на Windows с бэкендом WSL2

Если проект находится внутри файловой системы Windows, а Docker использует WSL2:

# Настройка WSL Integration в Docker Desktop:
# Settings -> Resources -> WSL Integration -> Включите нужный дистрибутив

# Рекомендация ITSTM: Перенесите код внутрь файловой системы WSL2:
mkdir -p ~/projects/app
cd ~/projects/app
# Запуск из нативного Linux пути исключает ошибки маппинга Windows-дисков

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

• Хранение тяжелых проектов (node_modules, vendor) на смонтированных дисках Windows: Скорость I/O через трансляцию файловой системы падает в десятки раз, приводя к таймаутам монтирования.
• Монтирование системных директорий без прав администратора: Попытка смонтировать /etc или системные папки блокируется встроенными политиками безопасности ОС хоста.