macOS 27 Docker CI: как развернуть self-hosted Mac? Руководство 2026

Задание сборки не запускается на Mac runner, хотя Docker CLI уже установлен?
Быстрое решение: self-hosted Mac подходит для проверенной сборки Docker-образов из shell-шагов, но не заменяет Linux runner для Docker container actions и service containers. До регистрации проверьте поддержку macOS в Docker Desktop, лицензию и права в целевой среде; зависимые от контейнерных actions задания направляйте на Linux.
Кому пригодится. DevOps-инженерам, которые добавляют сборку образов в GitHub Actions и хотят проверить её на Mac.
Командам, совмещающим шаги для macOS и Docker CI в одном workflow, — чтобы разделить задания по реальным требованиям.
Руководителям, оценивающим аренду Mac, — чтобы заранее проверить доступы, лицензию и ответственность за обслуживание.
Последняя проверка: 4 октября 2026 года. Сверено с документацией GitHub по self-hosted runner и требованиями установки Docker Desktop для Mac. Поддержку macOS 27 необходимо перепроверить по текущей версии документации Docker перед установкой.
Сначала — определить, какая часть Docker CI действительно требует Mac
Не стоит выбирать Mac runner только потому, что часть проекта собирается под macOS. В одном workflow могут соседствовать несколько принципиально разных типов работы:
- shell-команды, которые запускаются непосредственно на хосте;
- сборка Docker-образа из shell-команды через Docker CLI;
- Docker container actions, где само действие выполняется в контейнере;
- service containers, предоставляющие заданию контейнерную службу, например базу данных.
Первые два типа могут быть кандидатами для Mac runner, если Docker Desktop установлен и проверен именно в этой среде. Для Docker container actions и service containers документация GitHub устанавливает другое требование: self-hosted runner должен использовать Linux. Поэтому доступность Docker CLI на Mac не означает совместимость всей цепочки действий. Требование Linux для контейнерных заданий следует учитывать при проектировании workflow, а не после того, как сборка уже перенесена.
Представьте задачу: Mac выполняет shell-шаги, которым необходима macOS, затем запускает Docker CLI для сборки образа, а интеграционные проверки используют container action и service container. Это не одно неделимое задание для Mac. Его нужно разделить: macOS-зависимые действия оставить на Mac, контейнерный этап передать Linux runner, а выходные файлы передавать через артефакты. Так проще локализовать ошибку: отдельно проверяются сборка на хосте, доступ к Docker daemon и ограничения контейнерного окружения.
Для macOS 27 нельзя заранее считать подтверждёнными совместимость Docker Desktop, возможность виртуализации или права в облачной среде. Официальная инструкция Docker требует использовать поддерживаемую версию macOS, но актуальный список и условия нужно сверить перед развёртыванием. Страница установки Docker Desktop на Mac — исходная точка, а окончательная проверка выполняется на целевом runner.
Регистрация runner: маршрутизировать задания по меткам, а не по догадкам
Сначала решается, где регистрировать runner. Регистрация на уровне репозитория подходит, когда машина обслуживает конкретный проект и не должна быть общей для других команд. Уровень организации удобен, если runner требуется нескольким репозиториям и доступ к нему нужно ограничить через группы runner. В обоих случаях проверьте разрешения и политику доступа до установки: назначение группы и возможность использования runner зависят от настроек организации.
GitHub назначает runner метки, а workflow использует их для выбора подходящей машины. Для Mac полезно обозначить как минимум операционную систему, архитектуру и роль среды — например, отдельную метку для проверки сборки образов. Имена должны описывать фактические свойства runner, а не обещать несуществующие возможности. Принцип сопоставления меток и групп описан в документации о маршрутизации заданий к self-hosted runner.
Добавление машины выполняйте по инструкции GitHub для выбранного уровня регистрации. Сгенерированную команду и токен нельзя хранить в репозитории или выводить в логи. Их срок действия, область применения и права проверяйте по текущим инструкциям. Подробности установки и подключения приведены в официальном руководстве по добавлению self-hosted runner.
После установки запустите простой workflow, который выводит идентификатор ОС и архитектуру, затем проверьте, что он попал именно на ожидаемую машину. Для связи с GitHub runner должен иметь исходящий HTTPS-доступ по TCP-порту 443; требование и перечень условий связи нужно сверять с документацией GitHub по self-hosted runner. Не открывайте входящий доступ «на всякий случай»: сначала выясните, чего требует выбранная конфигурация, и согласуйте сетевые правила с администратором.
Установка Docker Desktop: до сборки сверить поддержку, лицензию и права
На этом этапе важно не путать три независимых проверки: поддерживает ли приложение данную версию macOS и архитектуру, разрешено ли его использование условиями лицензии команды, и возможно ли установить и запустить его в конкретной среде. Успешная загрузка установщика не доказывает, что Docker daemon будет доступен runner в автоматическом задании.
Начните с текущих требований Docker Desktop для Mac. Если macOS 27 ещё не указана в поддерживаемом диапазоне, не делайте вывод, что совместимость гарантирована по аналогии с предыдущим выпуском. Проверьте страницу повторно непосредственно перед установкой и проведите тест в целевой среде. Для арендуемой или облачной машины запросите подтверждение установки, первоначального запуска, поддержки нужной архитектуры и доступа к виртуализации. Наличие Mac как удалённой машины само по себе этого не подтверждает.
Отдельно проверьте права: установщику, первому запуску или вспомогательным компонентам могут требоваться действия администратора. Условия описаны в документации Docker о разрешениях для macOS. Если команда не может получить нужный доступ, следует выяснить это до подключения runner, а не пытаться обходить системные ограничения в production.
Лицензия — ещё одна самостоятельная часть решения. Согласно условиям лицензирования Docker Desktop, бесплатное использование для компаний ограничено условиями, включающими менее 250 сотрудников и менее 10 млн долларов годовой выручки; кроме того, документ определяет другие категории бесплатного использования. Эти пороги — условия лицензии, а не рекомендация по выбору тарифа. Сверьте актуальную редакцию документа, тип организации и сценарий использования; не делайте вывод по одному только размеру команды.
Удалённый доступ к Mac не означает автоматического наличия административных прав, разрешения на виртуализацию или подходящей лицензии Docker Desktop. Каждый пункт проверяется отдельно на целевой машине.
Первая сборка: проверить host-side процесс до переноса production
Для первоначальной проверки нужен минимальный путь: runner запускает shell-команду, Docker CLI подключается к работающему daemon, Buildx собирает образ, а workflow подтверждает результат. Такая проверка отвечает на практический вопрос: может ли именно этот runner выполнить именно этот этап без предположений об окружении.
Выполняйте шаги последовательно:
- Зафиксируйте состояние машины: версию macOS, архитектуру, версию Docker Desktop и runner. Эти сведения должны быть доступны для последующего сравнения, но не содержать токены или приватные параметры.
- Запустите на runner
docker version. Убедитесь, что команда показывает и клиент, и серверную часть. Если отображается только CLI или соединение с daemon завершается ошибкой, переходить к проверке Dockerfile рано. - Создайте маленький тестовый контекст с минимальным Dockerfile. Не начинайте с проекта, который скачивает множество зависимостей: при сетевой ошибке будет сложнее отличить проблему доступа от проблемы Docker.
- Запустите сборку с
docker buildx build --tag ci-smoke-test:local --load .. Ключ--loadпросит загрузить результат в локальное хранилище образов; назначение параметров Buildx описано в официальном справочнике команды. - Проверьте результат командой
docker image inspect ci-smoke-test:localлибо другим однозначным шагом проверки, подходящим вашему тесту. Недостаточно увидеть успешный exit code: нужно подтвердить, что ожидаемый образ действительно появился. - Если workflow должен отправлять образ в реестр, проверяйте публикацию отдельно от локальной сборки. Используйте защищённое хранилище секретов GitHub, ограничьте доступ заданию и сначала примените тестовый путь публикации. Не печатайте значение секрета и не помещайте его в аргументы, доступные из логов.
- Только после успешного локального smoke test проверяйте кэш и целевые платформы. Инструкции по сборкам для разных архитектур приведены в руководстве Docker по multi-platform. Не обещайте себе одинаковое поведение или скорость на разных архитектурах: результат требуется проверить на целевой машине и в нужном workflow.
Если сборка должна создавать образ не для архитектуры самого Mac, добавьте явный параметр платформы и проверьте доступный builder. Успешная локальная сборка ещё не подтверждает, что выбранная схема подходит для публикации под целевые системы. Сверьте используемые параметры с документацией Buildx, затем протестируйте получение и запуск итогового образа в среде, для которой он предназначен.
Решение по маршрутизации: когда оставить шаг на Mac, а когда выбрать Linux
Используйте условия ниже как рабочую развилку. Они не заменяют тестирование, но не дают принять наличие Docker CLI за доказательство совместимости всего задания.
- Если шаг запускается на хосте, действительно требует macOS, а установка Docker Desktop, лицензия и подключение daemon проверены, то оставьте его на Mac runner.
- Если шаг собирает образ из host-side shell и тестовая сборка с нужными параметрами прошла на целевой машине, то Mac можно использовать для этого этапа. Зафиксируйте фактическую архитектуру, параметры Buildx и способ передачи результата.
- Если workflow использует Docker container action или service container, то направьте соответствующее задание на Linux runner. Требование GitHub относится к типу задания, а не к тому, установлен ли Docker CLI на Mac.
- Если сборка требует недоступных в арендуемой среде прав или виртуализации, то не обходите ограничения. Выберите среду, где эти условия подтверждены, либо оставьте этот этап на Linux.
- Если Docker Desktop не поддерживает текущий выпуск macOS по действующей документации, то не вводите runner в production до подтверждения совместимости или изменения среды.
- Если проекту нужны и macOS-специфичные шаги, и Linux-контейнерные действия, то разделите workflow на задания с явными метками runner и передавайте между ними только необходимые артефакты.
Типичная ошибка — повесить на Mac общую метку вроде docker и считать, что её достаточно для всех Docker-заданий. Такая метка описывает наличие некоторого инструмента, но не удовлетворяет требованию Linux для container actions и service containers. Назначайте метки по потребностям конкретного job, а не по сходству названий.
FAQ: регистрация, контейнерные действия и аренда среды
Как подключить собственный Mac к GitHub Actions для выполнения заданий?
Сначала выберите уровень регистрации: репозиторий подходит для изолированной команды, организация — для общих runner и централизованной маршрутизации. Добавьте runner согласно официальной инструкции GitHub, сохраните выданную конфигурацию в защищённом месте и назначьте понятные метки по ОС, архитектуре и назначению. Затем запустите тестовое задание, явно указав эти метки, и проверьте, что оно не попадает на другой runner.
Можно ли запускать контейнерные действия GitHub Actions на Mac runner?
Нет, self-hosted runner, которому требуется выполнять Docker container actions или service containers, должен работать под Linux. Наличие Docker CLI или установленного Docker Desktop на Mac этого требования не отменяет. Оставьте на Mac shell-шаги, которым нужна macOS, а контейнерные действия и сервисы вынесите в отдельное задание на Linux runner. Перед разделением проверьте передачу артефактов и секретов между заданиями.
Как проверить сборку Docker-образа на Mac runner до включения её в основную CI-схему?
Подготовьте небольшой Dockerfile без внешних зависимостей и запустите сборку командой docker buildx build из shell-задания, выполняемого непосредственно на Mac. До сборки проверьте версию CLI и соединение с daemon; после — наличие ожидаемого образа или экспортированного артефакта. Публикацию проверьте отдельно, используя защищённый секрет и тестовый репозиторий образов. Сборку под целевую архитектуру подтвердите именно в нужной среде.
Что проверить перед арендой Mac для Docker CI?
Уточните, поддерживает ли текущий выпуск Docker Desktop вашу версию macOS и процессор, возможно ли установить и впервые запустить приложение в целевой среде, а также какие права для этого нужны. Сопоставьте условия лицензии с размером и типом организации. Не считайте виртуализацию или административный доступ гарантированными: запросите подтверждение условий и проведите сборку с реальным workflow до переноса критичных заданий.
Обслуживание: обновления, доступ и очистка кэша
Self-hosted runner требует сопровождения команды. Нужно отслеживать его доступность, обновлять приложение runner и Docker Desktop, пересматривать доступ к репозиторию или группе и защищать секреты. Уточните, кто отвечает за каждый пункт и как команда узнает, что машина перестала принимать задания. Если runner временно недоступен, workflow должен корректно ожидать его или перенаправлять только совместимые задания — не контейнерный job на Mac вопреки требованию Linux.
Кэш образов и промежуточных слоёв ускоряет повторные сборки, но постепенно занимает место и может сохранять устаревшее содержимое. Определите, кто и по какому правилу выполняет очистку. Сначала проверьте процесс на непроизводственном задании: убедитесь, что удаление кэша не затрагивает необходимые артефакты, а повторная сборка после очистки проходит ожидаемым способом.
Перед подключением production сохраните запись об изменениях macOS, Docker Desktop, runner и workflow. При обновлении проверяйте не только факт запуска машины, но и весь маршрут: выбор метки, доступ к daemon, сборку, публикацию и передачу артефактов. Если меняются лицензия, права установки или поддержка системного выпуска, повторите соответствующую проверку. Для вопросов по условиям работы с ProxyMac можно обратиться к справочным материалам; доступные варианты оплаты и условия уточняйте на странице тарифов.
Перед переходом на постоянную схему сравните варианты:
| Вариант | Подходящие задания | Основные ограничения | Что проверить до запуска |
|---|---|---|---|
| Self-hosted Mac runner | Host-side shell и проверенная сборка Docker-образов, когда нужен macOS | Docker Desktop и его права не гарантированы; container actions и service containers не заменяет | Поддержку macOS, лицензию, daemon, архитектуру, доступ runner к GitHub |
| Linux runner | Контейнерные действия, service containers и совместимые Docker-задачи | Не выполняет шаги, которым требуется macOS | Совместимость образов и инструментов, секреты, кэш и получение артефактов |
| Разделённый workflow | Проекты, где есть и macOS-зависимые шаги, и контейнерная CI-часть | Нужно явно передавать результаты между заданиями и согласовать их последовательность | Метки каждого job, передачу артефактов и поведение при сбое одного этапа |
Условия Docker Desktop стоит оценивать отдельно от стоимости самой машины:
| Проверка | Что подтверждает официальный источник | Действие команды |
|---|---|---|
| Поддержка macOS и архитектуры | Docker публикует условия установки для Mac и актуальный диапазон поддержки | Сверить текущий список с macOS 27 непосредственно перед развёртыванием |
| Лицензия Docker Desktop | Для бесплатного использования компаниями указаны пороги менее 250 сотрудников и менее 10 млн долларов годовой выручки; применяются условия лицензии | Проверить оба критерия и прочитать действующую редакцию документа |
| Права и виртуализация | Требования к разрешениям приложения описаны отдельно от общих условий установки | Проверить полномочия и первый запуск на целевой арендованной или облачной машине |
Маршрут заданий также следует зафиксировать до подключения постоянной нагрузки:
| Требование job | Куда направлять | Проверка результата |
|---|---|---|
| Shell-шагу нужна macOS | Mac runner с подходящими метками | Убедиться, что задание выполняется на ожидаемой системе |
| Docker CLI запускает сборку из shell на хосте | Mac runner только после целевого smoke test | Проверить daemon, собранный образ и публикацию отдельно |
| Используется Docker container action или service container | Linux runner | Подтвердить, что каждый соответствующий job маршрутизируется на Linux |
| Одному workflow нужны обе среды | Разделить на задания для Mac и Linux | Проверить передачу артефактов, секретов и поведение при сбое |
Если текущая схема использует только Linux, у неё есть понятные преимущества: контейнерные задания уже соответствуют требованию GitHub, а установка Docker Desktop на Mac не нужна. Но Linux runner не выполнит шаги, которым необходима macOS; разделение добавляет передачу артефактов и настройку маршрутизации. Собственный постоянно включённый Mac устраняет зависимость от доступности общей машины, но команда берёт на себя обновления, контроль доступа, лицензию, очистку кэша и проверку Docker Desktop. Арендуемая среда может быть удобнее для временной проверки или ограниченного проекта, однако до выбора нужно подтвердить права, виртуализацию и реальный запуск рабочего workflow.
Для короткого эксперимента или временной потребности вместо покупки оборудования разумно проверить аренду Mac в ProxyMac, но не переносить production только по факту доступности удалённого доступа. Сначала выполните smoke test, сверьте лицензию и разделите контейнерные задания с Linux runner. Так аренда решает задачу получения временной среды, а не маскирует ограничения: если нагрузка постоянная и требует особых физических интерфейсов или гарантированного административного контроля, собственная инфраструктура может оказаться подходящим вариантом.
Запустите собственный CI-runner на выделенном Mac
ProxyMac предоставляет физический Mac mini M4 с 10-ядерным процессором, 16 ГБ объединённой памяти и SSD на 256 ГБ для ваших задач сборки и тестирования.
Настройте runner и Docker-среду под свой рабочий процесс, подключаясь к Mac удалённо через SSH или VNC.