Не хотите читать всё это?
Просто скиньте в любой ИИ-чат (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.