Сведения о персонализации Codespaces
При использовании любой среды разработки важным шагом является настройка параметров и инструментов в соответствии с вашими предпочтениями и рабочими процессами. GitHub Codespaces позволяет персонализировать codespace двумя основными способами.
- Синхронизация параметров . Параметры Visual Studio Code можно синхронизировать между классическим приложением и веб-клиентом VS Code.
- Файлы с точкой — вы можете использовать репозиторий
dotfiles
для указания скриптов, настроек оболочки и других конфигураций.
Персонализация GitHub Codespaces применяется к любому создаваемому пространству codespace.
Обслуживающие проект также могут определить конфигурацию по умолчанию, которая применяется к каждому пространству codespace для репозитория, созданному любым пользователем. Дополнительные сведения см. в разделе Основные сведения о контейнерах разработки.
Синхронизация параметров
Синхронизация параметров позволяет синхронизировать конфигурации, такие как параметры, сочетания клавиш, фрагменты кода, расширения и состояние пользовательского интерфейса на компьютерах и экземплярах VS Code. Дополнительные сведения см. в разделе Синхронизация параметров документации по VS Code.
При включении синхронизации параметров в экземпляре VS Code, например в классическом приложении VS Code на ноутбуке, параметры для этого экземпляра сохраняются в облаке. Из облака параметры извлекаются во все новые codespace в момент создания и непрерывно синхронизируются со всеми существующими пространствами кода, в которых включена синхронизация параметров.
Включена ли синхронизация параметров по умолчанию в codespace, зависит от существующих параметров и от того, открываете ли вы codespace в браузере или в классическом приложении VS Code.
- При открытии codespace в браузере синхронизация параметров всегда сначала отключается. Это означает, что передача параметров выполняется только в одном направлении: GitHub Codespaces извлекает параметры, хранящиеся в облаке, в пространство кода в момент создания, но все изменения, внесенные в параметры в codespace, не распространяются в облако, поэтому не отражаются в других пространствах кода. Кроме того, все изменения, внесенные в параметры в других местах, не отражаются в пространстве кода.
- Если вы открываете codespace в классическом приложении VS Code, синхронизация параметров остается включенной в codespace, если вы ранее включили ее для приложения. Все обновления, внесенные в параметры, отправляются в облако, поэтому отражаются в новых codespace и существующих пространствах кода, в которых включена синхронизация параметров. Если вы вносите изменения в параметры в других экземплярах VS Code, где включена синхронизация параметров, эти обновления будут отражены в codespace.
Если вы работаете в codespace, где отключена синхронизация параметров, вы можете включить синхронизацию параметров, чтобы отправить изменения, внесенные в параметры, в облако, или извлечь последние изменения в параметры, внесенные в другом месте.
Включение синхронизации параметров
Примечание: Синхронизация параметров следует включать только в codespace, созданных из репозиториев, которым вы доверяете. Дополнительные сведения см. в разделе Безопасность в GitHub Codespaces.
-
В VS Code в нижней части панели действий выберите и щелкните Включить синхронизацию параметров...
-
В раскрывающемся списке выберите параметры, которые нужно синхронизировать.
-
Щелкните Вход & Включить, а затем выберите учетную запись, с которой нужно синхронизировать параметры.
После входа экземпляр VS Code будет немедленно обновлен для отображения последних синхронизированных параметров.
Отключение синхронизации параметров
Вы можете отключить синхронизацию параметров, чтобы остановить синхронизацию параметров с экземпляром VS Code.
По умолчанию при отключении синхронизации параметров новые codespace продолжают использовать параметры, кэшированные с момента последней отправки параметров в облако. Если ваши codespace по-прежнему создаются с кэшируемыми параметрами и вы хотите вернуться к использованию параметров по умолчанию VS Code в codespaces, вы можете очистить кэш в облаке, отключив синхронизацию параметров.
-
Если в вашем экземпляре VS Code сейчас отключена синхронизация параметров, необходимо сначала включить ее. Инструкции см. в разделе Персонализация GitHub Codespaces для вашей учетной записи.
-
В нижней части панели действий выберите и щелкните Параметры Синхронизация включена.
-
В раскрывающемся списке щелкните Параметры Синхронизация: отключить.
-
Чтобы очистить кэшированные параметры, в диалоговом окне выберите Отключить синхронизацию на всех устройствах и очистите данные из облака.
-
Щелкните Выключить.
Файлы с точкой
Файлы с точкой — это файлы и папки в системах Unix, которые начинаются с .
. Они служат для управления конфигурациями приложений и оболочки в системе. Хранить файл с точкой и управлять им можно в репозитории на сайте GitHub. Рекомендации и учебники по включению в репозиторий файлов с точкой см. в статье, посвященной файлам с точкой в GitHub.
Репозиторий файлов с точкой может включать псевдонимы оболочки и настройки, любые инструменты, которые требуется установить, или любую другую персонализацию пространства codespace, которую вы хотите сделать.
Вы можете настроить GitHub Codespaces для использования файлов точек из любого репозитория, которым вы владеете, выбрав этот репозиторий в личных параметрах GitHub Codespaces.
При создании новой среды codespace GitHub клонирует выбранный репозиторий файлов с точкой в среду codespace и выполняет поиск одного из следующих файлов, чтобы настроить среду.
- install.sh
- install
- bootstrap.sh
- bootstrap
- script/bootstrap
- setup.sh
- setup
- script/setup
Если ни один из этих файлов не найден, для всех файлов или папок в выбранном репозитории файлов с точкой, которые начинаются с .
, будут созданы символические ссылки на каталог ~
или $HOME
пространства codespace.
Любые изменения в выбранном репозитории файлов с точкой будут применяться только к каждому новому пространству codespace и не будут влиять на существующее пространство codespace.
Примечание: В настоящее время Codespaces не поддерживает персонализацию параметров уровня пользователя для VS Code в репозитории dotfiles
. Вы можете задать параметры по умолчанию Рабочая область и Удаленная среда [Codespaces] для определенного проекта в репозитории проекта. Дополнительные сведения см. в разделе Основные сведения о контейнерах разработки.
Включение репозитория файлов с точкой дляCodespaces
Вы можете использовать выбранный репозиторий файлов точек для персонализации среды GitHub Codespaces. Выбрав репозиторий файлов с точкой, вы можете добавить в него скрипты, настройки и конфигурации. Затем необходимо включить файлы точек на личной странице параметров GitHub Codespaces.
Предупреждение. Файлы с точкой могут выполнять произвольные скрипты, которые могут содержать непредвиденный или вредоносный код. Перед установкой репозитория файлов с точкой рекомендуется проверять скрипты, чтобы убедиться, что они не выполняют никаких непредвиденных действий.
-
В правом верхнем углу любой страницы щелкните фотографию профиля, а затем выберите Параметры.
1. В разделе "Код, планирование и автоматизация" на боковой панели нажмите Codespaces. -
В разделе "Файлы точек" выберите Автоматическая установка файлов точек , чтобы GitHub Codespaces автоматически устанавливал файлы точек в каждое новое пространство кода, которое вы создаете.
-
Используйте раскрывающийся список, чтобы выбрать репозиторий, из которого вы хотите установить файлы точек.
Можно добавить в репозиторий файлов с точкой дополнительные скрипты, параметры, файлы конфигурации или изменить существующие файлы при желании. Изменения параметров будут приняты только новыми пространствами codespace.
Если в codespace не удается получить параметры конфигурации из файлов точек, см. раздел Устранение неполадок с параметрами персонализации для GitHub Codespaces.
Другие доступные параметры
Вы также можете персонализировать GitHub Codespaces с помощью дополнительных параметров в личных параметрах:
- Чтобы включить проверку GPG, см. раздел Управление проверкой GPG для GitHub Codespaces.
- Сведения о настройке редактора см. в разделе Настройка редактора по умолчанию для GitHub Codespaces.
- Сведения о том, как долго кодовое пространство может оставаться неиспользуемой, прежде чем оно будет автоматически остановлено, см. в разделе Настройка периода ожидания для GitHub Codespaces.
- Чтобы задать период хранения неиспользуемых кодовых пространств, см. раздел Настройка автоматического удаления codespace.
- Чтобы задать регион по умолчанию, см. раздел Настройка региона по умолчанию для GitHub Codespaces.