Задания GitHub Actions перестали назначаться после вывода macOS-14 из эксплуатации, либо сборка на заменившем его Runner стала падать.
Сначала замените устаревшую метку на поддерживаемый Runner, который соответствует архитектуре проекта; затем отдельно проверьте Xcode, тесты и подпись. Смена runs-on сама по себе не подтверждает восстановление CI.
Для IT-руководителей, которым нужно определить охват сбоя и владельцев исправления.
Для платформенных инженеров, локализующих проблемы назначения, архитектуры и инструментов.
Для ответственных за выпуск, которым нужны подтверждения работоспособности сборки, тестирования и публикации перед возобновлением релизов.
Последняя проверка: 15 ноября 2026 года. Статус macOS-14 сверяется с объявлением GitHub о выводе образа из эксплуатации, а текущие метки и содержимое образов — с официальным перечнем Runner Images. Перед изменением рабочего процесса повторно проверьте эти источники: набор образов и доступные метки могут обновляться.
SECTION 01Задание не назначается: начните с метки Runner
Сигнал: workflow остаётся в очереди либо завершает попытку без запуска шага на машине. В этом случае сначала выясните, какой Runner запрашивает workflow и какие метки доступны, а не меняйте код приложения.
Объявление GitHub о выводе macOS-14 перечисляет затронутые метки macos-14, macos-14-large и macos-14-xlarge и описывает направление миграции. Не предполагайте, что сбой связан именно с этим изменением по одной строке ошибки: сначала сопоставьте фактическую конфигурацию с объявлением и текущим перечнем образов.
Почему GitHub Actions не назначает Runner после вывода macOS-14? Откройте workflow, проверьте runs-on и выясните, не осталась ли там устаревшая метка. Затем сопоставьте это значение с журналом запуска и текущим списком поддерживаемых Runner. Если метка уже заменена, но задача всё ещё не стартует, продолжайте проверку условий маршрутизации и доступности исполнителя; не объясняйте очередь выводом macOS-14 из эксплуатации без подтверждений.
Для диагностики условий выполнения полезны документация GitHub по устранению неполадок workflow и описание контекстов GitHub Actions. Сохраните ссылку на запуск, конфигурацию workflow и строку ошибки: вместе они позволяют отличить проблему метки от ошибки следующего этапа.
| Наблюдаемый сигнал | Что проверить | Какое свидетельство сохранить |
|---|---|---|
| Задание не начинает выполняться | Значение runs-on и метки в актуальном списке GitHub |
Файл workflow и запись запуска с ошибкой назначения |
| Runner запускается, но шаги не доходят до сборки | Фактическую ОС и контекст Runner в журнале | Начало job и значения контекста |
| Сбой появляется при установке зависимости | Архитектуру процесса и поддерживаемые форматы зависимости | Вывод установки и данные об архитектуре |
| Компиляция проходит, а выпуск нет | Тестовый этап, архив, подпись и публикацию по отдельности | Журналы каждого этапа и проверяемые артефакты |
SECTION 02Runner назначен, но зависимость не запускается
Сигнал: job стартовал на новом образе, а сборка останавливается при установке или вызове стороннего инструмента. Проверьте архитектуру фактического Runner и требования бинарной зависимости прежде, чем менять способ сборки.
Переход на другую метку macOS не означает автоматического перехода с одной архитектуры на другую. Если прежняя среда запускала Intel-бинарный файл, а новая среда использует другую архитектуру, несовместимость может проявиться в установщике, скрипте или при запуске инструмента — даже если workflow синтаксически корректен. И наоборот: ошибка скачивания пакета может быть вызвана источником или настройкой установки, а не архитектурой машины.
Как выяснить, из-за чего iOS-сборка падает после перехода с macOS-14 на macOS-15? Сопоставьте лог прежней успешной сборки с новым запуском: какая архитектура указана у Runner, какой пакет был загружен, какой файл попытался выполниться и на каком именно шаге возник отказ. Официальный список программного обеспечения образа macOS-15 поможет проверить заявленное содержимое образа, но не доказывает совместимость всех зависимостей вашего проекта.
Практический порядок проверки:
- зафиксируйте метку Runner и снимите сведения об архитектуре непосредственно в job;
- сравните версии и источники зависимостей с последним успешным запуском;
- проверьте, не загружает ли скрипт пакет только для одной платформы;
- запустите небольшой контрольный шаг, который устанавливает и вызывает проблемный инструмент;
- только после локализации причины меняйте пакет, способ установки либо целевую среду.
Для установки и поиска инструментов Apple отдельно документирует командные инструменты Xcode. Не считайте наличие этих инструментов доказательством наличия конкретной версии полного Xcode или подходящего SDK: выясните, какой именно компонент запускает ваша команда сборки.
SECTION 03Компиляция запускается, но выбрана не та версия Xcode
Сигнал: Runner назначен, однако сборка сообщает о другом SDK, недоступном симуляторе или несовпадении инструментов с ожиданиями проекта.
В workflow может быть указана только метка операционной системы, а не точная версия Xcode. Поэтому проверьте вывод фактического выбора инструментов в журнале job: версию macOS, Xcode, SDK и доступные среды симулятора. Затем сопоставьте их с официальным перечнем программного обеспечения для используемого Runner. Если образ обновился, сначала отделите изменение среды от регрессии исходного кода.
Где проверить фактически выбранный Xcode после смены macOS Runner? Ищите в job лог команд, которыми workflow выбирает инструменты и SDK, а также вывод проверки версии Xcode до сборки. Сравните эти записи с последним успешным запуском на том же коммите. Если workflow не печатает сведения о среде, добавьте диагностические команды до сборки и повторите запуск: иначе вы будете сравнивать предположения из YAML, а не использованные инструменты.
Если в доступном образе есть несколько вариантов Xcode, настройте явный выбор поддерживаемой версии в workflow и зафиксируйте её значение в логах. Не добавляйте неподтверждённые переменные среды и не полагайтесь на значение по умолчанию: проверьте поведение на текущем Runner, следуя документации GitHub по контекстам и описанию конкретного образа. Отдельно убедитесь, что выбранный SDK соответствует требованиям проекта и что нужный симулятор действительно доступен во время теста.
| Вариант восстановления | Когда он уместен | Ограничение, которое нужно проверить |
|---|---|---|
Оставить управляемый GitHub Runner и обновить runs-on |
Новый образ удовлетворяет требованиям проекта, а инструменты можно выбрать и проверить в job | Содержимое образа и доступные метки могут меняться; проверяйте их по официальному перечню |
| Явно выбирать Xcode в workflow | Требуемые версия Xcode и SDK присутствуют на используемом образе | Сам выбор версии не гарантирует доступность нужных симуляторов и компонентов |
| Использовать self-hosted Mac Runner | Рабочий процесс требует условий, которые нельзя получить на доступном управляемом образе | Команда принимает на себя настройку, обслуживание и контроль Runner |
| Проверить удалённый Mac как отдельный вариант размещения | Нужен управляемый командой macOS-хост, а публичный Runner не удовлетворяет подтверждённым требованиям | До решения необходимо проверить реальные условия доступа, поставки и использования на странице услуги |
macOS-15 и macOS-26 рассматривайте как названия меток для проверки, а не как гарантию того, что нужный образ доступен, имеет требуемую архитектуру или содержит нужную версию Xcode. Текущий статус каждой метки и состав образа устанавливайте по списку Runner Images; не выводите его из номера macOS или старой конфигурации.
Если новый Runner собирает проект, но запускает не те тесты или выбирает другой SDK, не объединяйте исправления. Сначала сохраните вывод среды, затем меняйте по одному параметру и сравнивайте результат на том же коммите.
SECTION 04Сборка прошла, но тесты или артефакт не приняты
Сигнал: компилятор завершился успешно, однако тесты, архивирование или последующая проверка выпуска не прошли. Успех компиляции подтверждает только этот этап, а не восстановление всего конвейера.
Разделите job на точки проверки: компиляция, модульные тесты, тесты на симуляторе и создание архива. Сопоставьте последнюю успешную запись и текущую запись для одного коммита, а затем определите первый этап с различающимся результатом. Проверьте выбранный SDK, доступность нужного симулятора, переменные среды и предположения скриптов о расположении инструментов.
В качестве минимального набора свидетельств сохраните commit, конфигурацию runs-on, вывод выбранного Xcode и SDK, итог каждого этапа и архив, если он был создан. Проверяйте артефакт тем же способом, который используется при передаче дальше по процессу: наличие файла само по себе не означает, что он соответствует ожиданиям публикации.
Что проверить, если после смены Runner компиляция успешна, а симуляторные тесты падают? Установите, запускается ли нужный симулятор на новом образе, какой runtime выбран и на каком тесте появляется первое расхождение. Если проблема ограничена симулятором, отделите её от ошибок сборки и логики приложения; не расширяйте изменение на весь pipeline, пока не найдена причина.
SECTION 05Подпись или публикация остановились после успешной сборки
Сигнал: компиляция и тесты завершены, но архив не подписан, экспорт не проходит или публикация не получает нужные полномочия. Не приписывайте такой отказ выводу Runner из эксплуатации без отдельной проверки учётных данных и конфигурации подписи.
Проверьте по отдельности сертификат или идентификатор подписи, provisioning profile, Keychain, секреты workflow и права, необходимые публикационному этапу. Убедитесь, что целевая среда действительно имеет доступ к этим значениям, а их передача не зависит от локального состояния прежнего Runner. Сопоставьте журнал ошибок подписи с журналом успешной компиляции: это разные границы отказа.
Не проверяйте восстановление только повторным запуском одной job. Проведите контролируемую проверку по тому же коммиту: получите архив, выполните принятый в команде шаг проверки подписи и подтвердите, что следующий этап публикации принимает результат. Если подпись снова не проходит, сохраните конкретную ошибку, но не раскрывайте в общих логах значения секретов или содержимое приватных ключей.
Достаточно ли одного успешного запуска, чтобы снова разрешить выпуск? Нет: успешная сборка не проверяет тестирование, подпись и публикацию. Возобновляйте выпуск после того, как соответствующие этапы завершились и вы располагаете логами и артефактами, подтверждающими каждый переход.
SECTION 06Когда рассматривать self-hosted или удалённый Mac
Сначала перечислите условия, без которых задача не может выполняться: требуемая архитектура, версия Xcode и SDK, доступ к внутренним зависимостям, симуляторы, хранение подписывающих данных и правила сетевого доступа. Для каждого условия укажите проверку и результат на текущем управляемом Runner. Рассматривать другой тип размещения имеет смысл, когда журналы реальных рабочих задач показывают, что необходимое условие недоступно, а не только потому, что новая метка вызвала неожиданный сбой.
GitHub описывает применение self-hosted Runner в руководстве по запуску workflow на собственном исполнителе. Этот вариант предоставляет команде больше контроля над средой, но требует самостоятельно оценить её настройку и сопровождение; он не устраняет потребность проверять доступ, инструменты и релизный процесс.
Перед выбором сопоставьте варианты по рабочим требованиям:
- Управляемый Runner: проще оставить обслуживание среды вне команды, если образ удовлетворяет требованиям и сбои можно исправить конфигурацией workflow.
- Self-hosted Mac Runner: подходит для условий, которые команда должна контролировать сама; заранее назначьте владельцев обновления, доступа и диагностики.
- Удалённый Mac: может рассматриваться, если проекту нужен доступный команде macOS-хост и подтверждённые требования не выполняются на управляемом образе. До решения проверяйте только те условия, которые фактически раскрыты на странице сервиса.
Для первичной оценки можно посмотреть информацию о вариантах размещения Mac и опубликованные условия и цены. Не переносите в архитектурное решение параметры, стоимость, регионы, сроки или гарантии, которые не подтверждены этими страницами и договорённостями. Если проекту не требуется контролируемый хост, а проблема устраняется сменой метки или настройкой Xcode, переход на отдельную машину добавит операционную ответственность без доказанной необходимости.
Закройте инцидент только после того, как зафиксированы применённая метка, фактические архитектура и инструменты, результаты тестов, проверка артефакта и состояние подписи с публикацией. Если все требования выполняются на поддерживаемом GitHub Actions macOS Runner, оставьте workflow на нём и добавьте проверки среды, чтобы следующий сдвиг образа был виден в логах. Если реальные задания подтверждают неудовлетворённые требования к macOS-хосту, сравните управляемый Runner с self-hosted и удалённым Mac по фактическим условиям вашей команды, а не по одному сообщению об ошибке.