Краткое руководство по GitHub Codespaces

В этой статье

Испытайте GitHub Codespaces за 5 минут.

Введение

В этом руководстве вы создадите codespace из репозитория шаблонов и изучите некоторые важные возможности, доступные в codespace. Вы будете работать в версии браузера Visual Studio Code, которая изначально является редактором по умолчанию для GitHub Codespaces. После работы с этим кратким руководством вы можете использовать Codespaces в других редакторах и изменить редактор по умолчанию. Ссылки приведены в конце этого руководства.

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

Дополнительные сведения о принципах работы GitHub Codespaces см. в сопутствующем руководстве Подробный обзор GitHub Codespaces.

Создание кодового пространства

Перейдите к репозиторию шаблонов github/haikus-for-codespaces .
Над списком файлов щелкните Использовать этот шаблон, а затем выберите Открыть в codespace.

Запуск приложения

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

Когда терминал будет доступен, введите команду npm run dev. В этом примере используется проект Node.js, и эта команда выполняет скрипт с меткой dev в package.json файле, который запускает веб-приложение, определенное в примере репозитория.

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

Изменение приложения и просмотр изменений

Вернитесь в codespace и откройте haikus.json файл, щелкнув его в проводнике.
Измените поле text первого haiku, чтобы персонализировать приложение с помощью собственного haiku.
Для просмотра изменений вернитесь на вкладку запущенного приложения в браузере и обновите ее.

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

Фиксация и отправка изменений

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

На панели действий щелкните представление Система управления версиями.
Чтобы выполнить изменения, щелкните + рядом с файлом haikus.json или рядом с элементом Изменения , если вы изменили несколько файлов и хотите создать их все.
Чтобы зафиксировать промежуточные изменения, введите сообщение фиксации с описанием внесенных изменений, а затем нажмите кнопку Зафиксировать.
Щелкните Опубликовать ветвь.
В раскрывающемся списке "Имя репозитория" введите имя нового репозитория, а затем выберите Опубликовать в GitHub частный репозиторий или Опубликовать в общедоступном репозитории GitHub.

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

Персонализация с помощью расширения

При подключении к codespace с помощью браузера или классического приложения Visual Studio Code доступ к Visual Studio Code Marketplace можно получить непосредственно из редактора. В этом примере вы установите расширение VS Code, которое изменяет тему, но вы можете установить любое расширение, полезное для вашего рабочего процесса.

На боковой панели слева нажмите значок "Расширения".
В строке поиска введите fairyfloss и нажмите кнопку Установить.
Выберите тему fairyfloss, выбрав ее из списка.

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

Дальнейшие действия

Вы успешно создали, персонализировали и запустили свое первое приложение в codespace, но еще многое нужно изучить! Ниже приведены некоторые полезные ресурсы для выполнения дальнейших действий с GitHub Codespaces.

Подробное руководство. В этом кратком руководстве представлены некоторые функции GitHub Codespaces. В глубоком обзоре эти области рассматриваются с технической точки зрения.
"Добавление конфигурации контейнера разработки в репозиторий". В этих руководствах содержатся сведения о настройке репозитория для использования GitHub Codespaces с определенными языками.
"Введение в контейнеры разработки".В этом руководстве содержатся сведения о создании пользовательской конфигурации для Codespaces для проекта.