Управление предварительными сборками

Вы можете просматривать, изменять и удалять конфигурации предварительной сборки для репозитория.

Кто может использовать эту функцию?

Параметры уровня репозитория для GitHub Codespaces доступны для всех репозиториев, принадлежащих личная учетная запись.

Для репозиториев, принадлежащих организациям, параметры уровня репозитория для GitHub Codespaces доступны для организаций на GitHub Team и GitHub Enterprise планов. Чтобы получить доступ к параметрам, организация или ее родительская организация должны добавить метод оплаты и установить ограничение расходов для GitHub Codespaces. Дополнительные сведения см. в разделе "[AUTOTITLE" и "Выбор владельцев и оплаты пространств кода в вашей организации](/get-started/learning-about-github/githubs-plans)".

В этой статье

Сведения об управлении предварительными сборками

Предварительные сборки, настроенные для репозитория, создаются и обновляются с помощью рабочего процесса GitHub Actions под управлением службы GitHub Codespaces.

В зависимости от параметров в конфигурации предварительной сборки, рабочий процесс обновления для предварительной сборки может активироваться следующими событиями:

  • создание или обновление конфигурации предварительной сборки;
  • отправка фиксации или запроса на вытягивание в ветвь, для которой настроены предварительные сборки;
  • изменение любого из файлов конфигурации для контейнера разработки;
  • активация события по расписанию, которое определено в конфигурации предварительной сборки;
  • активация этого рабочего процесса вручную.

Параметры в конфигурации предварительной сборки определяют, какие события активируют автоматическое обновление предварительной сборки. См. раздел "Настройка предварительных сборок".

Пользователи с правами администратора в репозитории могут проверять ход выполнения предварительных сборок, изменять и удалять конфигурации предварительной сборки.

Чтобы найти все репозитории, на которых размещена предварительная конфигурация, необходимо получить копию отчета об использовании, выполнив действия для autoTITLE.

Просмотр хода выполнения для предварительной сборки

Текущее состояние последнего запуска рабочего процесса для каждой конфигурации предварительной сборки, настроенной на странице GitHub Codespaces параметров репозитория. Здесь может быть указаны значения вида "Выполняется" или "Последний запуск 1 час назад".

Чтобы просмотреть выходные данные журнала для последнего запуска рабочего процесса предварительной сборки, щелкните Просмотреть выходные данные.

Снимок экрана: страница "Конфигурация предварительной сборки". Перечислены две конфигурации предварительной сборки. Выделена кнопка "Просмотреть выходные данные" для одной конфигурации.

Это действие отображает на вкладке Действия выходные данные последнего запуска рабочего процесса.

Снимок экрана: выходные данные рабочего процесса предварительной сборки на вкладке "Действия" GitHub.

Кроме того, чтобы просмотреть все выполняемые рабочие процессы предварительной сборки, связанные с указанной ветвью, выберите раскрывающееся меню и нажмите кнопку "Вид запусков".

Снимок экрана: раскрывающееся меню параметров конфигурации, показанное нажатием кнопки с тремя точками. Выбран параметр "Просмотреть запуски".

Отобразится журнал выполнения рабочего процесса предварительной сборки для связанной ветви.

Снимок экрана: список "Предварительные сборки Codespaces" с журналом выполнения для рабочих процессов предварительной сборки.

Изменение конфигурации предварительной сборки

  1. На странице параметров репозитория для Codespaces щелкните многоточие справа от конфигурации предварительной сборки, которую вы хотите изменить.

  2. В раскрывающемся меню выберите Изменить.

    Снимок экрана: раскрывающееся меню параметров конфигурации, отображаемое путем нажатия кнопки с тремя точками. Выбран параметр "Изменить".

  3. Внесите необходимые изменения в конфигурацию предварительной сборки и щелкните Обновить.

    Если в конфигурации контейнера разработки для репозитория указаны разрешения на доступ к другим репозиториям, отобразится страница авторизации. Дополнительные сведения о том, как это указано в файле, см. в devcontainer.json разделе "Управление доступом к другим репозиториям в кодовом пространстве".

    Щелкните значок , чтобы просмотреть сведения о необходимых разрешениях.

    Снимок экрана: страница авторизации для предварительной конфигурации. В этом запросе перечислены три разрешения.

    Нажмите кнопку "Авторизовать" и продолжайте **** предоставлять эти разрешения для создания предварительной сборки. Кроме того, можно нажать кнопку " Продолжить" без авторизации , но при этом пространства кода, созданные из результирующих предстроек, могут работать неправильно.

    Note

    Пользователям, создающим пространства кода с помощью этой предварительной сборки, также будет предложено предоставить эти разрешения.

Отключение конфигурации предварительной сборки

Чтобы приостановить обновление предварительных сборок для конфигурации, можно отключить для нее выполнения рабочего процесса. Отключение выполнений рабочего процесса для конфигурации предварительной сборки не удаляет ранее созданные предварительные сборки для этой конфигурации, а значит экземпляры codespace будут по-прежнему успешно создаваться из существующей предварительной сборки.

Отключение рабочего процесса для конфигурации предварительной сборки полезно, если необходимо изучить сбои создания предварительной сборки.

  1. На странице параметров репозитория для Codespaces щелкните многоточие справа от конфигурации предварительной сборки, которую вы хотите отключить.

  2. В раскрывающемся меню выберите Отключить запуски.

    Снимок экрана: раскрывающееся меню параметров конфигурации, показанное нажатием кнопки с тремя точками. Выбран параметр "Отключить запуски".

  3. Чтобы подтвердить намерение отключить эту конфигурацию, щелкните ОК.

Удаление конфигурации предварительной сборки

Note

Список репозиториев, содержащих предварительную сборку, можно найти, получив копию отчета об использовании.

При удалении конфигурации предварительной сборки также удаляются все ранее созданные для нее предварительные сборки. Это означает, что вскоре после удаления конфигурации все созданные ею предварительные сборки станут недоступными для создания нового пространства кода.

После удаления конфигурации предварительной сборки продолжится выполнение всех рабочих процессов, которые уже была поставлены в очередь или запущены для этой конфигурации. Они будут указаны в журнале выполнения рабочего процесса наряду со всеми ранее завершенными запусками рабочего процесса.

  1. На странице параметров репозитория для Codespaces щелкните многоточие справа от конфигурации предварительной сборки, которую вы хотите удалить.

  2. В раскрывающемся меню выберите Удалить.

    Снимок экрана: раскрывающееся меню параметров конфигурации, отображаемое путем нажатия кнопки с тремя точками. Выбран параметр "Удалить".

  3. Чтобы подтвердить удаление, щелкните ОК.

Запуск предварительных сборок вручную

Иногда бывает нужно вручную запустить рабочий процесс для конфигурации предварительной сборки. Как правило, это необходимо только при отладке проблемы с рабочим процессом для предварительной конфигурации сборки.

  1. На странице параметров репозитория для Codespaces щелкните многоточие справа от конфигурации предварительной сборки, для которой вы хотите запустить рабочий процесс.

  2. В раскрывающемся меню щелкните Активировать вручную.

    Снимок экрана: раскрывающееся меню параметров конфигурации, показанное нажатием кнопки с тремя точками. Выбран параметр "Вручную активировать".

Дополнительные материалы