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

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

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

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

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

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

Создание пространства кода из шаблона GitHub

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

1. В левом верхнем углу GitHubвыберите , а затем щелкните Codespaces , чтобы перейти на страницу "Ваши пространства кода" на github.com/codespaces.

2. Чтобы просмотреть полный список шаблонов, в разделе "Обзор шаблонов быстрого запуска" нажмите кнопку " Просмотреть все".

   

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

   

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

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

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

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

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

2. Нажмите кнопку "Использовать этот шаблон", а затем нажмите кнопку "Открыть" в пространстве кода.

   

   Примечание.

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

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

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

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

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

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

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

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

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

   

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

   

   Примечание.

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

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

   

4. Нажмите кнопку "Опубликовать ветвь".

   

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

   

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

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

   

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

• Измените тип компьютера пространства кода, чтобы убедиться, что вы используете ресурсы, подходящие для выполняемой работы (см . autoTITLE).
• Разрешить GitHub автоматически использовать GPG для подписывания фиксаций в пространстве кода (см . раздел AUTOTITLE).
• Совместное использование секретов с пространством кода (см . раздел AUTOTITLE).

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

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

1. В левом верхнем углу GitHubвыберите , а затем щелкните Codespaces , чтобы перейти на страницу "Ваши пространства кода" на github.com/codespaces.

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

   

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

   

4. При необходимости, чтобы просмотреть новый репозиторий, нажмите кнопку "Просмотреть репозиторий".

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

• Создание пространства кода для репозитория
• Общие сведения о жизненном цикле пространства кода
• Использование системы управления версиями в codespace