21 KiB
title, shortTitle, intro, versions, type, topics, permissions, ms.openlocfilehash, ms.sourcegitcommit, ms.translationtype, ms.contentlocale, ms.lasthandoff, ms.locfileid
| title | shortTitle | intro | versions | type | topics | permissions | ms.openlocfilehash | ms.sourcegitcommit | ms.translationtype | ms.contentlocale | ms.lasthandoff | ms.locfileid | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Настройка предварительных сборок | Configure prebuilds | Вы можете настроить проект для автоматической предварительной сборки пространства кода при каждой отправке изменений в репозиторий. |
|
how_to |
|
People with admin access to a repository can configure prebuilds for the repository. | dbb355e150695f27d1d6a7fa51eccc33a0ebde4f | e8c012864f |
MT | ru-RU | 11/09/2022 | 148159120 |
Можно настроить конфигурацию предварительной сборки для определенной ветви репозитория в сочетании с определенным файлом конфигурации контейнера разработки.
Все ветви, созданные из родительской ветви с поддержкой предварительных сборок, обычно также получают предварительные сборки для той же конфигурации контейнера разработки. Это связано с тем, что предварительные сборки для дочерних ветвей, которые используют ту же конфигурацию контейнера разработки, что и родительская ветвь, по большей части идентичны, поэтому разработчики могут воспользоваться более быстрым временем создания codespace в этих ветвях. Дополнительные сведения см. в статье Общие сведения о контейнерах разработки.
Обычно при настройке предварительных сборок для ветви они доступны для различных типов компьютеров. Однако если в репозитории больше 32 ГБ, предварительные сборки не будут доступны для двух- и четырехъядерных компьютеров, так как хранилище ограничено 32 ГБ.
Предварительные требования
Предварительные сборки создаются с помощью {% data variables.product.prodname_actions %}. В результате для репозитория, для которого настраиваются предварительные сборки, необходимо включить {% data variables.product.prodname_actions %}. Дополнительные сведения см. в разделе Управление параметрами {% data variables.product.prodname_actions %} для репозитория.
Настройка предварительных сборок
{% data reusables.codespaces.accessing-prebuild-configuration %}
-
В разделе "Конфигурация предварительной сборки" выберите Настроить предварительную сборку.
-
Выберите ветвь, для которой требуется настроить предварительные сборки.
{% note %}
Примечание. Все ветви, созданные из базовой ветви с поддержкой предварительных сборок, обычно также получают предварительные сборки для той же конфигурации контейнера разработки. Например, если включить предварительные сборки для файла конфигурации контейнера разработки для ветви репозитория по умолчанию, в большинстве случаев ветви на основе ветви по умолчанию также получат предварительные сборки для той же конфигурации контейнера разработки.
{% endnote %}
-
При необходимости в раскрывающемся меню Файл конфигурации выберите
devcontainer.jsonфайл конфигурации, который вы хотите использовать для предварительных сборок. Дополнительные сведения см. в статье Общие сведения о контейнерах разработки.
-
Выберите способ автоматического запуска обновлений предварительной сборки.
- Каждая отправка (параметр по умолчанию) — при использовании этого параметра предварительные сборки будут обновляться при каждой отправке, выполненной в указанную ветвь. Это гарантирует, что пространства кода, созданные из предварительной сборки, всегда будут содержать последнюю конфигурацию пространства кода, включая все недавно добавленные или обновленные зависимости.
- При изменении конфигурации — с помощью этого параметра предварительные сборки будут обновляться при каждом обновлении связанных файлов конфигурации для заданного репозитория и ветви. Это гарантирует, что изменения в файлах конфигурации контейнера разработки для репозитория используются при создании пространства кода из предварительной сборки. Рабочий процесс {% data variables.product.prodname_actions %}, который обновляет предварительные сборки, будет выполняться реже, поэтому этот параметр будет использовать меньше {% data variables.product.prodname_actions %} минут. Однако этот вариант не гарантирует, что пространства кода всегда содержат недавно добавленные или обновленные зависимости, поэтому их может потребоваться добавить или обновить вручную после создания пространства кода.
- Запланировано . С помощью этого параметра предварительные сборки можно обновлять по пользовательскому расписанию, определенному вами. Это может снизить потребление {% data variables.product.prodname_actions %} минут, однако при использовании этого параметра можно создавать пространства кода, которые не используют последние изменения конфигурации контейнера разработки.
-
При необходимости выберите Уменьшить доступность предварительной сборки только для определенных регионов , чтобы создавать предварительные сборки только в указанных регионах. Выберите регионы, в которых должны быть доступны предварительные сборки.
По умолчанию предварительные сборки создаются во всех доступных регионах, что влечет за собой плату за хранение для каждой предварительной сборки.
{% note %}
Примечания
- За предварительную сборку в каждом регионе взимается отдельная плата за хранение. Поэтому следует включить предварительные сборки только для регионов, где они точно будут использоваться. Дополнительные сведения см. в статье Сведения о выставлении счетов за {% data variables.product.prodname_github_codespaces %}.
- Разработчики могут задать регион по умолчанию для {% data variables.product.prodname_github_codespaces %}, что позволяет включить предварительные сборки для меньшего числа регионов. Дополнительные сведения см. в разделе Настройка региона по умолчанию для {% data variables.product.prodname_github_codespaces %}.
{% endnote %}
-
При необходимости в разделе Журнал шаблонов укажите количество сохраняемых версий предварительной сборки. Можно ввести любое число от 1 до 5. Число сохраненных версий по умолчанию равно 2. Это означает, что сохраняются только последняя предварительная сборка и предыдущая версия.
В зависимости от параметров триггера предварительной сборки предварительная сборка может изменяться при каждой отправке или при каждом изменении конфигурации контейнера разработки. Сохранение более старых версий предварительной сборки позволяет создать предварительную сборку из более старой фиксации с другой конфигурацией контейнера разработки, отличной от текущей предварительной сборки. Этот параметр позволяет задать количество сохраненных версий на уровне, соответствующем вашим потребностям.
Если задать для сохранения число версий предварительной сборки равным 1, {% data variables.product.prodname_github_codespaces %} сохранит только последнюю версию предварительной сборки и удалит старую версию при каждом обновлении шаблона. Это означает, что вы не получите предварительно созданное пространство кода, если вернетесь к более старой конфигурации контейнера разработки.
С каждой сохраненной версией предварительной сборки связаны затраты на хранилище. Например, если вы создаете предварительные сборки в 4 регионах и сохраняете 2 версии, с вас будет взиматься плата за хранение до 8 предварительных сборок. Дополнительные сведения о выставлении счетов см. в статье Сведения о выставлении счетов за {% data variables.product.prodname_github_codespaces %}.
-
При необходимости добавьте пользователей или команды, которые будут получать уведомления при сбое запусков рабочего процесса предварительной сборки для этой конфигурации. Начните вводить имя пользователя, имя команды или полное имя, а затем щелкните его, когда оно появится, чтобы добавить в список. Добавленные пользователи и команды будут получать сообщения электронной почты при сбое предварительной сборки. В сообщении будет содержаться ссылка на журналы выполнения рабочего процесса для изучения проблемы.
-
При необходимости в нижней части страницы щелкните Показать дополнительные параметры.
Если в разделе "Дополнительные параметры" выбрать Отключить оптимизацию предварительной сборки, codespace будут созданы без предварительной сборки, если последний рабочий процесс предварительной сборки завершился сбоем или выполняется в данный момент. Дополнительные сведения см. в разделе Устранение неполадок с предварительными сборками.
-
Нажмите кнопку Создать.
{% data reusables.codespaces.prebuilds-permission-authorization %}
После создания конфигурации предварительной сборки она отображается на странице {% data variables.product.prodname_github_codespaces %} параметров репозитория. Рабочий процесс {% data variables.product.prodname_actions %} помещается в очередь, а затем выполняется, чтобы создать предварительные сборки в указанных регионах на основе ветви и файла конфигурации контейнера разработки, которые вы выбрали.
Сведения об изменении и удалении конфигураций предварительной сборки см. в статье "Управление предварительными сборками".
Настройка переменных среды
Чтобы разрешить процессу предварительной сборки доступ к переменным среды, необходимым для создания среды разработки, их можно задать как секреты репозитория {% data variables.product.prodname_codespaces %} или как секреты организации {% data variables.product.prodname_codespaces %}. Дополнительные сведения см. в разделе Добавление секретов для репозитория и Добавление секретов для организации.
Созданные таким образом секреты будут доступны любому пользователю, который создаст среду codespace из этого репозитория. Если этого не требуется, можно также задать секрет CODESPACES_PREBUILD_TOKEN. Секрет CODESPACES_PREBUILD_TOKEN используется только для предварительной сборки, а его значение недоступно в пространствах кода пользователей.
Предварительные сборки не могут использовать секреты на уровне пользователя во время создания среды, поскольку такие секреты недоступны, пока не будет создана среда codespace.
Настройка трудоемких задач для включения в предварительную сборку
Команды onCreateCommand и updateContentCommand можно использовать в devcontainer.json для включения длительных процессов в процесс создания предварительной сборки. Дополнительные сведения см. в документации по {% data variables.product.prodname_vscode %}, devcontainer.json reference.
onCreateCommand выполняется только один раз при создании предварительной сборки updateContentCommand , в то время как выполняется при создании предварительной сборки и при последующих обновлениях. Добавочные сборки должны быть включены в updateContentCommand, так как они представляют источник проекта и должны быть включены для каждого обновления предварительной сборки.