Docker Desktop на Mac

Не хотите читать всё это?

Просто скиньте в любой ИИ-чат (Claude, ChatGPT и т.д.) ссылку на https://pastukhov.com/agents/agent/mac-docker-desktop.md или на https://pastukhov.com/llms.txt и попросите сгенерировать конфигурационные файлы и команды. Он прочитает документацию, задаст несколько вопросов о вашей настройке и выдаст готовую конфигурацию. Экономьте время — пусть модель читает за вас.

Вы также можете связаться со мной через Telegram — я всегда рад помочь. И это не просто вежливость — мне действительно нравится общаться с единомышленниками, особенно если вы так же увлечены программированием, как и я.

Docker Desktop для Mac — программа с графическим интерфейсом для управления контейнерами Docker. Контейнер — это изолированная среда, в которой Pastukhov Agent работает со всеми своими инструментами, ничего не «разбрасывая» по вашей системе: легко установить, легко удалить, легко заменить на новую версию. На Mac пастакухов агент запускается в Docker Desktop одинаково просто и на компьютерах с чипом Apple Silicon (M1/M2/M3/M4), и на моделях с процессором Intel.

Установка Docker Desktop

Скачайте установщик Docker Desktop для Mac с docker.com — важно выбрать версию под ваш компьютер:

  • Apple Silicon — Mac с чипом M1/M2/M3/M4: версия «Mac with Apple chip»;
  • Intel — Mac с процессором Intel: версия «Mac with Intel chip».

Откройте скачанный файл .dmg и перетащите Docker в папку Applications, затем запустите из неё. Возможно, macOS попросит разрешить установку системных расширений — подтвердите в System Settings.

Настройка проекта

Создайте папку для вашего проекта. Внутри создайте файл docker-compose.yml по Руководству по настройке Docker — или файл .env, если предпочитаете запуск командой. Выберите образ — оба работают и на Apple Silicon, и на Intel без дополнительной настройки:

  • maxpastukhov/agent:dev-latest — полная среда разработки (2,8 ГБ): включает инструменты разработки ASP.NET Core и Node.js;
  • maxpastukhov/agent:min-latest — компактный полнофункциональный образ (570 МБ), если инструменты разработки ASP.NET Core не нужны: Node.js, Python и всё необходимое уже внутри.

Запуск Pastukhov Agent

Откройте Terminal в папке проекта и запустите контейнер:

# Если используете Docker Compose
docker compose up -d

# Если используете Docker CLI с файлом .env
docker run -d --env-file .env -p 5001:80 -v ./MyProject:/project maxpastukhov/agent:dev-latest

Запущенный контейнер появится на панели Docker Desktop — там можно смотреть его журналы, перезапускать и останавливать контейнер мышью, без командной строки.

Откройте браузер и перейдите по адресу http://localhost:5001 (или тому порту, который вы задали).

Нужны специальные инструменты? Если в проекте используются специфические языки или инструменты, которых нет в образе, его можно расширить собственным Dockerfile — как это сделать, описано в разделе «Расширение образа собственными инструментами» Руководства по настройке Docker.

Полезные советы

  • Apple Silicon — Docker Desktop работает на этих чипах нативно, а образы Pastukhov Agent поддерживают обе архитектуры (многоархитектурные): один и тот же образ запустится и на M-чипе, и на Intel, без настройки.
  • Файлы проекта — папка проекта подключается прямо в контейнер. Указывайте пути относительно текущей папки или абсолютные — оба варианта работают.
  • Больше мощности — выделение памяти и процессора для Docker Desktop настраивается в Settings → Resources, если проектам нужно больше ресурсов.
  • Автозапуск — включите запуск Docker Desktop при входе в систему (Settings → General), чтобы контейнеры всегда были готовы к работе.

Подробная настройка Docker (файлы compose, переменные окружения, учётные данные) — в Руководстве по настройке Docker.