Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Создание codespace для репозитория

Вы можете создать codespace для ветви в репозитории для разработки онлайн.

Сведения о создании codespace для репозитория

codespace можно создать на веб-сайте GitHub.com, в Visual Studio Code или с помощью GitHub CLI. Используйте вкладки в этой статье, чтобы отобразить инструкции для каждого из этих способов создания codespace.

Вы можете использовать GitHub Codespaces в вашей личной учетной записи GitHub.com с квотой бесплатного использования, включенной каждый месяц для учетных записей в планах Free и Pro.

Организации могут разрешить участникам и внешним участникам совместной работы создавать и использовать codespace за счет организации. Дополнительные сведения см. в разделе Включение GitHub Codespaces для организации.

Возможность создания codespace из репозиториев, принадлежащих организации, зависит от нескольких факторов, включая видимость репозитория и параметры организации или ее родительского предприятия. Дополнительные сведения см. в разделе Устранение неполадок при создании и удалении codespace.

Если вы запускаете новый проект, вы можете создать codespace на основе шаблона и опубликовать его в репозитории на GitHub позже. Дополнительные сведения см. в разделе Создание codespace на основе шаблона.

Примечание. Если вы используете интегрированную среду разработки JetBrains, вы можете использовать GitHub CLI для создания codespace. Затем можно использовать приложение Шлюза JetBrains, чтобы открыть codespace в интегрированной среде разработки JetBrains. Дополнительные сведения см. в разделе Использование GitHub Codespaces в интегрированной среде разработки JetBrains.

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

Все доступные среды codespace, созданные вами, можно просмотреть на github.com/codespaces.

Процесс создания codespace

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

  • Шаг 1. Виртуальная машина и хранилище назначаются вашей среде codespace.
  • Шаг 2. Создается контейнер и клонируется репозиторий.
  • Шаг 3. Вы можете подключиться к codespace.
  • Шаг 4. Для codespace выполняется настройка после создания.

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

Дополнительные сведения о жизненном цикле codespace см. в разделе Жизненный цикл codespace.

Если вы хотите использовать перехватчики Git для codespace, следует настроить перехватчики с помощью devcontainer.json скриптов жизненного цикла, таких как postCreateCommand. Они выполняются на шаге 4 выше. Сведения о скриптах жизненного цикла см. в спецификации контейнеров разработки на веб-сайте "Контейнеры разработки". Так как контейнер codespace создается после клонирования репозитория, любой каталог шаблонов Git, настроенный в образе контейнера, не будет применяться к codespace. Вместо этого после создания codespace необходимо установить перехватчики.

Можно изменять код, отлаживать его и использовать команды Git при разработке в codespace с помощью VS Code. Дополнительные сведения см. в документации по VS Code.

Чтобы ускорить создание codespace, администраторы репозитория могут включить предварительные сборки GitHub Codespaces для репозитория. Дополнительные сведения см. в разделе Сведения о предварительных сборках в GitHub Codespaces.

Создание codespace для репозитория

  1. На GitHub.com перейдите на главную страницу репозитория.

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

    Снимок экрана: раскрывающееся меню развернутой ветви со списком различных ветвей. Раскрывающееся меню со значком ветви и "магистральной линией" выделено темно-оранжевым контуром.

  3. Нажмите кнопку Код и выберите вкладку Кодовые пространства.

    Если за codespaces для этого репозитория взимается плата за организацию или ее родительское предприятие, под кнопкой Создать codespace on BRANCH отображается сообщение о том, кто будет платить за codespace.

  4. Создайте кодовое пространство с параметрами по умолчанию или настройте расширенные параметры:

    • Использование параметров по умолчанию

      Чтобы создать codespace с помощью параметров по умолчанию, щелкните знак "плюс" (). Кроме того, если у вас нет codespace для этого репозитория, можно щелкнуть Создать codespace в BRANCH.

    • Настройка параметров

      Чтобы настроить дополнительные параметры для кодового пространства, например другой тип компьютера или конкретный файл devcontainer.json, выполните следующие действия:

      1. В правом верхнем углу вкладки Codespaces выберите и щелкните Создать с параметрами.

        Снимок экрана: раскрывающийся список параметров на вкладке "Codespaces" с выделенным параметром "Создать с параметрами".

      2. На странице параметров для codespace выберите нужные параметры в раскрывающихся меню.

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

        Примечания

      3. Щелкните Create codespace (Создать codespace).

После подключения учетной записи в GitHub.com к расширению GitHub Codespaces можно создать новое codespace. Дополнительные сведения о расширении GitHub Codespaces см. в VS Code Marketplace.

  1. В VS Code на панели действий щелкните значок Удаленного обозревателя.

    Снимок экрана: панель действий. Значок боковой панели "Удаленный обозреватель" (прямоугольник, наложенный кругом) выделен оранжевым контуром.

    Примечание. Если удаленный обозреватель не отображается на панели действий:

    1. Откройте палитру команд. Например, нажмите клавиши SHIFT+COMMAND+P (Mac) или CTRL+SHIFT+P (Windows/Linux).
    2. Введите details.
    3. Щелкните Codespaces: сведения.
  2. Наведите указатель мыши на боковую панель "Удаленный обозреватель" и щелкните .

    Снимок экрана: боковая панель "Удаленный обозреватель" для GitHub Codespaces. Рядом с кнопкой со знаком "плюс" отображается подсказка "Create New Codespace".

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

    Снимок экрана: "octo-org/he", введенный в текстовое поле, и список из четырех репозиториев, которые начинаются с этой строки.

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

  4. Щелкните ветвь, в которой нужно выполнить разработку.

  5. Если появится запрос на выбор файла конфигурации контейнера разработки, выберите файл из списка.

  6. Щелкните тип компьютера, в котором нужно выполнить разработку.

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

Дополнительные сведения о GitHub CLI см. в разделе Сведения о GitHub CLI.

Чтобы создать codespace, используйте подкоманду gh codespace create.

gh codespace create

Вам будет предложено выбрать репозиторий. Если codespace для этого репозитория оплачивается организацией или ее родительским предприятием, отображается сообщение о том, кто будет платить за codespace. Затем вам будет предложено выбрать ветвь, файл конфигурации контейнера разработки (если доступно несколько) и тип компьютера (если доступно несколько).

Или же можно использовать флаги для указания некоторых или всех параметров:

gh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE

Замените в этом примере owner/repo идентификатором репозитория. Замените branch именем ветви или полным хэшем SHA фиксации, которую вы хотите сначала извлечь в codespace. Если флаг -r используется без флага b, codespace создается из ветви по умолчанию.

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

Замените machine-type допустимым идентификатором для доступного типа компьютера. Идентификаторы — это строки, такие как basicLinux32gb и standardLinux32gb. Тип доступных компьютеров зависит от репозитория, вашей личной учетной записи и расположения. При вводе недопустимого или недоступного типа компьютера, доступные типы отображаются в сообщении об ошибке. Если этот флаг пропущен, и доступно несколько типов компьютеров, вам будет предложено выбрать один из списка.

Подробные сведения о параметрах этой команды см. в руководстве по GitHub CLI.

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