Skip to main content

Устранение неполадок клиентов GitHub Codespaces

В этой статье содержатся сведения об устранении неполадок, которые могут возникнуть с клиентом, используемым для GitHub Codespaces.

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

Устранение неполадок веб-клиента Visual Studio Code

При возникновении проблем с использованием GitHub Codespaces в браузере, который не Chromium, попробуйте переключиться на браузер на основе Chromium, например Google Chrome или Microsoft Edge. Кроме того, можно проверить наличие известных проблем с браузером в microsoft/vscode репозитории, выполнив поиск проблем с именем браузера, например firefox или safari.

При возникновении проблем с использованием GitHub Codespaces в браузере на основе Chromium вы можете проверить, возникла ли другая известная проблема с VS Code в репозиторииmicrosoft/vscode.

Отличия от локальной работы в VS Code

При открытии codespace в браузере с помощью веб-клиента VS Code вы заметите некоторые отличия от работы в локальной рабочей области в классическом приложении VS Code. Например, некоторое настраиваемое сочетание клавиш будет отличаться или отсутствовать, а некоторые расширения могут вести себя по-разному. Сводку см. в разделе "Известные ограничения и адаптации" в документации по VS Code.

Вы можете проверить наличие известных проблем и записать новые проблемы с помощью интерфейса VS Code в репозитории microsoft/vscode .

Visual Studio Code Insiders

Visual Studio Code Участники программы предварительной оценки — это наиболее частый выпуск VS Code. Он содержит все последние функции и исправления ошибок, но иногда может содержать новые проблемы, которые приводят к неисправной сборке.

Если вы используете сборку программы предварительной оценки и заметили реакцию на проблемы в работе, рекомендуется переключиться на Visual Studio Code (стабильная версия) и повторить попытку.

Щелкните в левом нижнем углу редактора и выберите Переключиться на стабильную версию.... Если веб-клиент VS Code не загружается или значок недоступен, можно принудительно переключиться на Visual Studio Code Stable, добавив ?vscodeChannel=stable к URL-адресу codespace и загрузив codespace по нему.

Если проблема не устранена в Visual Studio Code Stable, проверьте наличие известных проблем и при необходимости зайдите в журнал новой проблемы в интерфейсе VS Code в репозитории microsoft/vscode .

Устранение неполадок в простом браузере

После запуска веб-приложения в codespace можно просмотреть запущенное приложение в простом браузере, внедренном в VS Code. В некоторых проектах приложение автоматически открывается на вкладке Простой браузер в редакторе при запуске приложения. Это происходит, если в devcontainer.json файле конфигурации для codespace свойство порта, на котором выполняется приложение, onAutoForward имеет значение openPreview.

"portsAttributes": {
  "3000": {
    "label": "Application",
    "onAutoForward": "openPreview"
  }
}

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

  1. В VS Code откройте вкладку Порты .

  2. Щелкните правой кнопкой мыши порт и выберите в редакторе команду Предварительный просмотр.

    Снимок экрана: вкладка "Порты VS Code". В контекстном меню выделена запись меню "Предварительный просмотр в редакторе"

Вкладка простого браузера не открывается автоматически

Если в devcontainer.json файле конфигурации указано "onAutoForward": "openPreview" значение для порта, но простой браузер не открывается автоматически при запуске приложения, убедитесь, что приложение запущено через порт, указанный в конфигурации. Приложение может запускаться на другом порту, если он занят.

Для реализации конфигурации порта, указанной в devcontainer.json, GitHub Codespaces записывает конфигурацию в файл VS Code settings.json при создании codespace. Вы можете проверить правильность записи settings.json конфигурации в codespace.

  1. В окне терминала в codespace введите следующую команду.

    Shell
    cat ~/.vscode-remote/data/Machine/settings.json
  2. Убедитесь, что settings.json файл содержит строки, подобные приведенным ниже.

     "remote.portsAttributes": {
         "3000": {
             "label": "Application",
             "onAutoForward": "openPreview"
         }
     }
    

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

Приложение не загружается

Иногда открывается вкладка Простой браузер, но вместо запущенного приложения отображается значок страницы ошибки или пустая страница. Это может произойти, если загружаемое веб-приложение содержит политику безопасности содержимого (CSP), которая ограничивает домены, в которые могут быть внедрены страницы сайта. Дополнительные сведения см. в разделе CSP: frame-ancestors на веб-сайте mdn.

Вы можете изменить политику безопасности приложения frame-ancestors локально, чтобы приложение отображалось в простом браузере. Кроме того, если проблема вызвана политикой frame-ancestors , вы сможете просмотреть приложение, открыв его в обычной вкладке браузера, а не в простом браузере. Для этого откройте вкладку Порты в VS Code, щелкните порт правой кнопкой мыши и выберите команду Открыть в браузере.

Устранение неполадок с VS Code

При открытии codespace в классическом приложении VS Code вы можете заметить несколько различий по сравнению с работой в локальной рабочей области, но взаимодействие должно быть аналогичным.

При возникновении проблем можно проверить наличие известных проблем и записать новые проблемы в интерфейсе VS Code в репозитории microsoft/vscode .

Visual Studio Code Insiders

Visual Studio Code Участники программы предварительной оценки — это наиболее частый выпуск VS Code. Он содержит все последние функции и исправления ошибок, но иногда может содержать новые проблемы, которые приводят к неисправной сборке.

Если вы используете сборку программы предварительной оценки и заметили реакцию на проблемы в работе, рекомендуется переключиться на Visual Studio Code (стабильная версия) и повторить попытку.

Чтобы переключиться на Visual Studio Code Stable, закройте приложение Visual Studio Code, откройте приложение Visual Studio Code Stable и снова откройте codespace.

Если проблема не устранена в Visual Studio Code Stable, проверьте наличие известных проблем и при необходимости зайдите в журнал новой проблемы в интерфейсе VS Code в репозитории microsoft/vscode .

Устранение неполадок в простом браузере

После запуска веб-приложения в codespace можно просмотреть запущенное приложение в простом браузере, внедренном в VS Code. В некоторых проектах приложение автоматически открывается на вкладке Простой браузер в редакторе при запуске приложения. Это происходит, если в devcontainer.json файле конфигурации для codespace свойство порта, на котором выполняется приложение, onAutoForward имеет значение openPreview.

"portsAttributes": {
  "3000": {
    "label": "Application",
    "onAutoForward": "openPreview"
  }
}

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

  1. В VS Code откройте вкладку Порты .

  2. Щелкните правой кнопкой мыши порт и выберите в редакторе команду Предварительный просмотр.

    Снимок экрана: вкладка "Порты VS Code". В контекстном меню выделена запись меню "Предварительный просмотр в редакторе"

Вкладка простого браузера не открывается автоматически

Если в devcontainer.json файле конфигурации указано "onAutoForward": "openPreview" значение для порта, но простой браузер не открывается автоматически при запуске приложения, убедитесь, что приложение запущено через порт, указанный в конфигурации. Приложение может запускаться на другом порту, если он занят.

Для реализации конфигурации порта, указанной в devcontainer.json, GitHub Codespaces записывает конфигурацию в файл VS Code settings.json при создании codespace. Вы можете проверить правильность записи settings.json конфигурации в codespace.

  1. В окне терминала в codespace введите следующую команду.

    Shell
    cat ~/.vscode-remote/data/Machine/settings.json
  2. Убедитесь, что settings.json файл содержит строки, подобные приведенным ниже.

     "remote.portsAttributes": {
         "3000": {
             "label": "Application",
             "onAutoForward": "openPreview"
         }
     }
    

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

Приложение не загружается

Иногда открывается вкладка Простой браузер, но вместо запущенного приложения отображается значок страницы ошибки или пустая страница. Это может произойти, если загружаемое веб-приложение содержит политику безопасности содержимого (CSP), которая ограничивает домены, в которые могут быть внедрены страницы сайта. Дополнительные сведения см. в разделе CSP: frame-ancestors на веб-сайте mdn.

Вы можете изменить политику безопасности приложения frame-ancestors локально, чтобы приложение отображалось в простом браузере. Кроме того, если проблема вызвана политикой frame-ancestors , вы сможете просмотреть приложение, открыв его в обычной вкладке браузера, а не в простом браузере. Для этого откройте вкладку Порты в VS Code, щелкните порт правой кнопкой мыши и выберите команду Открыть в браузере.

Устранение неполадок с ИНДЕ JetBrains

Проблемы с производительностью

Тип компьютера GitHub Codespaces с по крайней мере 4 ядрами рекомендуется использовать для выполнения любого из ИНДЕ JetBrains. Дополнительные сведения см. в разделе Изменение типа компьютера для кодового пространства.

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

Рекомендуемый размер кучи зависит от типа компьютера codespace.

Тип компьютераМаксимальный размер кучи
4 ядра, 8 ГБ ОЗУ2048 МиБ
8 ядер, 16 ГБ ОЗУ4096 МиБ
16 ядер, 32 ГБ ОЗУ8192 МиБ
32 ядра, 64 ГБ ОЗУ16 384 МиБ

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

Screenshot of the message recommending you increase the heap size

В зависимости от размера базы кода и объема памяти, необходимой для запуска приложения, может потребоваться дополнительно увеличить размер кучи. Необходимо задать размер кучи в диапазоне от размера, показанного в таблице выше, до 60 % ОЗУ удаленного узла. При наличии большого приложения не следует задавать слишком большой размер кучи, чтобы предоставить приложению достаточный объем памяти.

  1. В левой части панели навигации в верхней части окна приложения щелкните имя codespace.

    Снимок экрана: кнопка "Ресурсы" в JetBrains

  2. На вкладке Производительность обратите внимание на сведения о загрузке ЦП и памяти. Они указывают, перегружен ли компьютер.

    Снимок экрана: кнопка Localhost в JetBrains

  3. Перейдите на вкладку Параметры и измените размер кучи, увеличив его до не более 60 % доступной памяти для codespace.

    Снимок экрана: параметр максимального размера кучи

  4. Нажмите кнопку Сохранить и перезапустить.

Невозможно открыть клиент в MacOS Ventura

В MacOS Ventura при использовании версий шлюза JetBrains, предшествующих версии 2022.3, при первой попытке подключиться к codespace из шлюза JetBrains отображается сообщение о том, что клиентское приложение JetBrains "повреждено и не может быть открыто".

Screenshot of the 'cannot be opened' error message

Эта проблема устранена в шлюзе JetBrains версии 2022.3 и более поздних.

Чтобы избежать этой проблемы, обновите шлюз JetBrains.

Чтобы обойти эту проблему в более старых версиях шлюза, выполните следующие действия.

  1. Нажмите кнопку Отмена , чтобы закрыть это сообщение.

  2. Щелкните значок Apple в левом верхнем углу экрана и щелкните Параметры системы.

  3. Щелкните Конфиденциальность & Безопасность и прокрутите вниз до раздела "Безопасность".

    Снимок экрана: диалоговое окно "Безопасность & конфиденциальности"

    Вы увидите сообщение о том, что клиент JetBrains заблокирован.

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

    Screenshot of the error message with an 'Open' button
  5. Нажмите кнопку Отмена еще раз.

  6. Назад к приложению шлюза JetBrains и снова подключитесь к требуемому пространству кода. Клиент JetBrains откроется успешно. Авторизовать клиентское приложение для запуска на компьютере Mac вы не увидите сообщение при подключении к codespace в будущем.

Проблемы с SSH-подключением

Для подключения через сервер SSH, работающий в codespace, необходимо иметь ключ SSH в каталоге ~/.ssh (MacOS и Linux) или %HOMEPATH%\.ssh каталоге (Windows), который уже добавлен в учетную запись GitHub. Если в этом каталоге нет ключей, GitHub CLI создаст ключи. Дополнительные сведения см. в разделе Добавление адреса нового ключа SSH в учетную запись GitHub.

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

Проблемы с интегрированной среды разработки JetBrains

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