Skip to main content

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

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

Примечание. Использование GitHub Codespaces с ИДЕНТИФИКАТОРами JetBrains в настоящее время находится в общедоступной бета-версии и подлежит изменению.

Сведения о Codespaces в идентификаторах JetBrains

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

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

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

Примечание. В шлюзе JetBrains доступны только существующие пространства кода. Пространства кода можно создавать в GitHub.comили с помощью GitHub CLI. Дополнительные сведения см. в разделе Создание пространства кода для репозитория.

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

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

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

Необходимые компоненты

Чтобы работать в пространстве кода в интегрированной среде разработки JetBrains, вам потребуется:

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

Лицензия JetBrains

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

Шлюз JetBrains

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

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

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

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

    Снимок экрана: панель элементов JetBrains с "Шлюзом" в нижней части списка приложений. Рядом с каждым приложением есть кнопка "Установить".

GitHub CLI

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

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

Shell
gh --version

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

Пространство кода под управлением SSH-сервера

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

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

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

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

Примечание. Сведения о подключении к пространству кода по протоколу SSH см. в разделе "Устранение неполадок клиентов GitHub Codespaces".

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

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

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

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

    Снимок экрана: страница "Добро пожаловать в шлюз JetBrains" со списком "GitHub Codespaces" в разделе "Установка дополнительных поставщиков".

  3. Щелкните Подключение в Codespace.

    Снимок экрана: шлюз с кнопкой "Подключение до Codespaces".

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

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

    Снимок экрана: одноразовый код входа. Значок копирования рядом с кодом выделен темным оранжевым контуром.

  6. Щелкните ссылку для входа под кодом входа.

  7. Если вы сейчас не вошли в GitHub, отображается страница входа.

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

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

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

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

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

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

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

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

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

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

    Снимок экрана: домашняя страница шлюза JetBrains с кнопкой "Подключение в codespaces".

  3. При первом подключении вам будет предложено выбрать, следует ли разрешить GitHub собирать анонимные данные об использовании, чтобы улучшить функциональные возможности и взаимодействие с пользователем. Нажмите кнопку "Разрешить " или " Запретить".

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

  4. В списке "Пространства кода" щелкните пространство кода, в которое вы хотите работать.

    Снимок экрана: список "Пространства кода" в шлюзе JetBrains.

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

    Снимок экрана: раскрывающийся список "Выбор интегрированной среды разработки" в шлюзе JetBrains. Указатель мыши указывает на IntelliJ IDEA.

  6. Щелкните Подключить.

    Примечания

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

      Если репозиторий не имеет файла решения, Всадник открывается в базовом представлении каталога проекта и будет иметь ограниченные возможности. Например, вы не получите. Навигация по коду, зависят от NET. Если в репозитории есть только один файл решения, он будет использоваться автоматически без отображения запроса. Дополнительные сведения см. в разделе "Создание и открытие проектов и решений" в документации JetBrains.

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

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

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

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

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