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

Создание codespace на основе шаблона

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

Сведения о шаблонах для GitHub Codespaces

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

Вы можете начать с пустого шаблона, выбрать шаблоны, поддерживаемые GitHub для популярных технологий, таких как React или Jupyter Notebook, или запустить пространство кода из любого репозитория шаблонов в GitHub.

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

Например, если создать codespace на основе шаблона React GitHub, вы будете поступать в рабочую область, содержащую файлы шаблонов для простого приложения, например index.js, app.jsи package.json. Вскоре после открытия codespace сервер разработки запустится автоматически, и вы сможете просматривать запущенное приложение на простой вкладке браузера в веб-клиенте VS Code.

Снимок экрана: простой браузер VS Code, отрисовывая веб-приложение в шаблоне React GitHub.

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

Совет: Чтобы помочь пользователям приступить к работе с платформой, библиотекой или другим проектом, можно настроить репозиторий шаблонов для использования с GitHub Codespaces. Дополнительные сведения см. в разделе Настройка репозитория шаблонов для GitHub Codespaces.

Создание codespace на основе шаблона GitHub

Шаблоны, поддерживаемые GitHub, включая пустой шаблон, доступны на странице "Ваши пространства кода".

  1. Перейдите на страницу "Ваши codespaces" на github.com/codespaces. 1. Чтобы просмотреть полный список шаблонов, в разделе "Изучение шаблонов быстрого запуска" нажмите кнопку Просмотреть все.

    Снимок экрана: раздел "Изучение шаблонов быстрого запуска". Параметр "Просмотреть все" выделен темно-оранжевым контуром.

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

    Снимок экрана: раздел "Изучение шаблонов быстрого запуска" на странице codespaces. Перечислены три шаблона, а имена шаблонов выделены оранжевыми контурами.

  3. Под именем шаблона, который вы хотите запустить, щелкните Использовать этот шаблон.

При создании нового пространства кода на основе шаблона оно всегда открывается в веб-клиенте Visual Studio Code. Вы можете повторно открыть существующее пространство кода в любом поддерживаемом редакторе. Дополнительные сведения см. в разделе Открытие существующего codespace.

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

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

  1. На GitHub.com перейдите на главную страницу репозитория. 1. Щелкните Использовать этот шаблон, а затем щелкните Открыть в codespace.

    Снимок экрана: кнопка "Использовать этот шаблон" и раскрывающееся меню, развернутое для отображения параметра "Открыть в codespace".

    Примечание: Если вы являетесь хранителем репозитория шаблонов и хотите зафиксировать изменения в самом репозитории шаблонов, создайте пространство кода из раскрывающегося списка Code . Дополнительные сведения см. в разделе Создание codespace для репозитория.

При создании нового пространства кода на основе шаблона оно всегда открывается в веб-клиенте Visual Studio Code. Вы можете повторно открыть существующее пространство кода в любом поддерживаемом редакторе. Дополнительные сведения см. в разделе Открытие существующего codespace.

Публикация в репозитории на GitHub

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

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

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

Публикация из VS Code

Если вы работаете в codespace, вы можете опубликовать его из веб-клиента VS Code или классического приложения.

  1. На панели действий щелкните представление Система управления версиями.

    Снимок экрана: панель действий VS Code с кнопкой управления версиями, выделенной оранжевым контуром.

  2. Чтобы внести изменения, щелкните + рядом с файлом, который вы добавили или изменили, или рядом с элементом Изменения , если вы изменили несколько файлов и хотите подготовить их все.

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

    Примечание: Если вы начинаете с пустого шаблона GitHub, вы не увидите список изменений, если вы не инициализировали каталог в качестве репозитория Git. Чтобы опубликовать codespace, созданные на основе пустого шаблона, щелкните Опубликовать в GitHub в представлении системы управления версиями, а затем перейдите к шагу 5.

  3. Чтобы зафиксировать промежуточные изменения, введите сообщение фиксации, описывающее внесенные изменения, а затем нажмите кнопку Зафиксировать.

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

  4. Щелкните Опубликовать ветвь.

    Снимок экрана: боковая панель "Система управления версиями" с кнопкой "Опубликовать ветвь".

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

    Снимок экрана: раскрывающийся список имен репозитория в VS Code. Показаны два варианта публикации в частном или общедоступном репозитории.

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

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

    Снимок экрана: сообщение подтверждения для успешно опубликованного репозитория с кнопкой "Открыть в GitHub".

При публикации codespace у вас есть доступ к большему набору параметров для настройки интерфейса GitHub Codespaces. Например, вы можете:

Публикация из GitHub.com

Неопубликованное пространство кода можно опубликовать на странице "Ваши codespaces" на GitHub.com. Это полезно, если вы хотите опубликовать пространство кода, которое в настоящее время не открыто в браузере. В этом случае работа будет сохранена в репозитории, но не будет связи между существующим пространством кода и новым репозиторием. Однако вы можете перейти к новому репозиторию и создать оттуда codespace, и это пространство кода будет подключено к репозиторию.

  1. Перейдите на страницу "Ваши codespaces" на github.com/codespaces.

  2. Рядом с неопубликованным пространством кода щелкните многоточие (...), а затем выберите Опубликовать в новом репозитории.

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

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

    Снимок экрана: раскрывающийся список "Опубликовать в новом репозитории" с полями "Имя", "Общедоступный" и "Частный" и кнопкой "Создать репозиторий".

  4. При необходимости, чтобы просмотреть новый репозиторий, щелкните Просмотреть репозиторий.

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