Быстрый старт для GitHub Codespaces

Введение

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

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

Дополнительные сведения о том, как работает GitHub Codespaces, см. в руководстве по AUTOTITLE.

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

1. Перейдите к репозиторию шаблонов github/haikus-for-codespaces .

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

   

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

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

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

   

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

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

   

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

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

1. Вернитесь к пространству кода и откройте haikus.json файл, щелкнув его в обозревателе.

2. Измените поле text первого haiku, чтобы персонализировать приложение с помощью собственного haiku.

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

   Если вы закрыли вкладку браузера, щелкните вкладку "Порты" в VS Code, наведите указатель мыши на значение локального адреса для запущенного порта и щелкните значок "Открыть в браузере ".

   

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

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

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

   

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

   

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

   

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

   

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

   

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

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

   

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

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

1. На панели действий щелкните значок расширений.

   

2. В строке поиска введите fairyfloss и нажмите кнопку "Установить".

   

3. Выберите тему fairyfloss, выбрав ее из списка.

   

Сведения о синхронизации параметров

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

Следующие шаги

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

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

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

• Включение или отключение GitHub Codespaces для вашей организации
• Использование кодовых пространств GitHub в Visual Studio Code
• Использование кодовых пространств GitHub с GitHub CLI
• Настройка редактора по умолчанию для GitHub Codespaces.
• Управление стоимостью GitHub Codespaces в вашей организации