Использование GitHub Codespaces в интегрированной среде разработки JetBrains

Сведения о Codespaces в URI JetBrains

Если вы используете интегрированную среду разработки JetBrains для работы с кодом, вы можете воспользоваться преимуществами работы в codespace. Это можно сделать с помощью приложения Шлюза JetBrains.

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

Процесс подключения к удаленной разработке JetBrains

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

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

Предварительные условия

Для работы в codespace в интегрированной среде разработки JetBrains вам потребуется:

• Действительная лицензия JetBrains
• Приложение шлюза JetBrains
• GitHub CLI версии 2.18.0 или более поздней
• Существующее пространство кода, на котором выполняется сервер SSH

Лицензия JetBrains

Для подключения к codespace из шлюза JetBrains требуется лицензия по крайней мере на одно из поддерживаемых URI JetBrains.

Шлюз JetBrains

Вы можете установить и обновить шлюз JetBrains из приложения JetBrains Toolbox.

1. Скачайте и установите панель элементов JetBrains.

2. Откройте панель элементов JetBrains.

3. Найдите Шлюз в списке доступных средств и нажмите кнопку Установить.

   

GitHub CLI

Подключаемый модуль GitHub Codespaces для шлюза JetBrains требует установки и настройки GitHub CLI версии 2.18.0 или более поздней перед открытием codespace из шлюза JetBrains.

Используйте эту команду, чтобы проверить версию GitHub CLI:

gh --version

Дополнительные сведения см. в разделе Сведения о GitHub CLI.

Codespace, на котором выполняется сервер SSH

У вас должно быть существующее пространство кода для подключения. codespace можно создать на веб-сайте GitHub.com, в Visual Studio Code или с помощью GitHub CLI. Дополнительные сведения см. в разделе Создание codespace для репозитория.

На сервере codespace, к которому вы подключаетесь, должен быть запущен SSH-сервер. Образ контейнера по умолчанию включает сервер SSH, который запускается автоматически. Если codespaces не создаются из образа по умолчанию, можно установить и запустить сервер SSH, добавив следующую команду в features объект в devcontainer.json файле.

"features": {
    ...
    "ghcr.io/devcontainers/features/sshd:1": {
        "version": "latest"
    },
    ...
}

Дополнительные сведения о файле и образе контейнера по умолчанию см. в разделе Общие сведения оdevcontainer.json контейнерах разработки.

Настройка шлюза JetBrains

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

1. Откройте приложение шлюза JetBrains.

2. В разделе Установить другие поставщики щелкните ссылку Установить для GitHub Codespaces.

   

3. Щелкните Подключиться к Codespace.

   

4. В диалоговом окне "Добро пожаловать в шлюз JetBrains" щелкните Войти с помощью GitHub.

   

5. Щелкните значок рядом с одноразовым кодом, чтобы скопировать его, а затем щелкните ссылку для входа.

   

6. Если вы еще не вошли в GitHub, отобразится страница входа.

   • Введите свои данные и нажмите кнопку Войти.
   • Проверьте проверку подлинности, например введя код двухфакторной проверки подлинности.

7. На странице "Активация устройства" вставьте скопированный код и нажмите кнопку Продолжить.

8. Если вы принадлежите к организациям, отобразится страница "Единый вход в организации". Щелкните Авторизовать рядом с организациями, к которым вы хотите предоставить доступ шлюзу JetBrains, а затем нажмите кнопку Продолжить.

9. На странице "Авторизация GitHub Codespaces для JetBrains щелкните Авторизовать GitHub.

10. Вернитесь в приложение шлюза JetBrains и откройте codespace из списка активных или остановленных кодовых пространств. См. шаг 3 следующей процедуры.

Открытие codespace в интегрированной среде разработки JetBrains

Если вы настроили шлюз JetBrains в качестве редактора по умолчанию, шлюз запустится автоматически при открытии пространства кода из GitHub.com.

Если шлюз JetBrains не является редактором по умолчанию, вы по-прежнему можете открыть codespace в JetBrains, перейдя на страницу "Ваши codespaces" в github.com/codespaces и щелкнув многоточие (...) справа от codespace, которое нужно открыть. Дополнительные сведения см. в разделе Открытие существующего пространства кода.

Кроме того, можно открыть шлюз JetBrains и выбрать существующее пространство кода, как описано в следующей процедуре.

1. Откройте приложение шлюза JetBrains.

2. Щелкните Подключиться к Codespaces.

   

3. В списке "Ваши codespaces" щелкните пространство кода, с которым вы хотите работать.

   

4. В списке "Доступные среды разработки" щелкните интегрированную среду разработки JetBrains, которую вы хотите использовать. Шлюз запомнит ваш выбор при следующем подключении к codespace.

   

5. Нажмите кнопку Соединить.

   Примечание. Если вы используете брандмауэр: при первом подключении к удаленному ресурсу может быть предложено разрешить шлюзу JetBrains взаимодействовать по сети.

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

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

   Затем запускается клиентское приложение.

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

• "Разработка в codespace"
• Использование подключаемого модуля GitHub Codespaces для JetBrains
• Использование GitHub Copilot в GitHub Codespaces"
• Устранение неполадок клиентов GitHub Codespaces