Creating a codespace from a template

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

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

Вы можете начать с пустого шаблона, выбрать один из шаблонов, поддерживаемых GitHub для популярных технологий, таких как React или Jupyter Notebook, или запустить codespace из любого репозитория шаблонов в GitHub. С пустым шаблоном вы начнете с пустого каталога с доступом к облачным вычислительным ресурсам и средствам, языкам и средам выполнения, которые предустановлены с помощью образа codespace по умолчанию. С помощью других шаблонов вы получите начальные файлы для технологии, с которой вы работаете, а также, как правило, некоторые дополнительные файлы, такие как файл сведений .gitignore , файл и файлы конфигурации контейнера разработки, содержащие некоторые пользовательские конфигурации среды. Дополнительные сведения о контейнерах разработки и образе по умолчанию см. в разделе Introduction to dev containers.

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

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

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

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

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

   

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

   

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

   

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

   

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

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

   

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

   

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

   

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

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

   

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

• Измените тип компьютера codespace, чтобы убедиться, что вы используете ресурсы, соответствующие выполняемой работе (см. раздел Changing the machine type for your codespace).
• Разрешить GitHub автоматически использовать GPG для подписывания фиксаций, создаваемых в codespace (см. раздел Managing GPG verification for GitHub Codespaces).
• Поделитесь зашифрованными секретами с codespace (см. раздел Managing encrypted secrets for your codespaces).

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

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

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

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

   

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

   

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

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

• "AUTOTITLE"
• "AUTOTITLE"
• "AUTOTITLE"