Персонализация GitHub Codespaces для вашего аккаунта

Сведения о персонализации Codespaces

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

• Синхронизация параметров— можно синхронизировать параметры Visual Studio Code между классическим приложением и веб-клиентом VS Code .
• Файлы с точкой — вы можете использовать репозиторий dotfiles для указания скриптов, настроек оболочки и других конфигураций.

Персонализация GitHub Codespaces применяется к любому создаваемому пространству кода.

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

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

Синхронизация параметров позволяет синхронизировать такие конфигурации, как параметры, сочетания клавиш, фрагменты кода, расширения и состояние пользовательского интерфейса на компьютерах и экземплярах VS Code. Дополнительные сведения см. в разделе "Синхронизация параметров" в документации по VS Code.

Синхронизированные параметры кэшируются в облаке. Если синхронизация параметров включена в пространстве кода, все обновления, внесенные в пространство кода, отправляются в облако, и все обновления, которые вы отправляете в облако из других мест, извлекаются в пространство кода.

Например, часто используется синхронизация параметров для синхронизации параметров из классического приложения VS Code классического приложения, используемого для локальной работы, в пространства кода, открытые в браузере. Для этого вам потребуется выполнить следующие действия.

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

Кроме того, вы можете использовать одни и те же параметры во всех пространствах кода, которые вы открываете в веб-клиенте, оставляя локальные VS Code приложение не влияет. Для этого вам потребуется выполнить следующие действия.

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

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

Включена ли синхронизация параметров по умолчанию в пространстве кода, а связь между кэшируемыми параметрами и параметрами в пространстве кода зависит от нескольких факторов. К этим факторам относятся редактор, в котором вы открываете пространство кода, ваши предпочтения пользователей в GitHub, а также список доверенных репозиториев.

Для пространств кода, открытых в классическом приложении VS Code, синхронизация параметров сохраняется, если вы ранее включили синхронизацию параметров в приложении. Если синхронизация параметров включена, параметры синхронизируются как с облаком, так и из облака.

Для пространств кода, открытых в веб-клиенте VS Code синхронизация параметров по умолчанию отключена. Это означает, что экземпляр VS Code в пространстве кода использует тему и параметры по умолчанию.

Если вы используете веб-клиент и хотите, чтобы пространства кода использовали кэшированные синхронизированные параметры, можно включить синхронизацию параметров в пользовательских предпочтениях на GitHub. Дополнительные сведения см. в разделе "Управление параметрами синхронизации". Синхронизация параметров включена автоматически, если открыть пространство кода в веб-клиенте и включить синхронизацию параметров в пространстве кода.

Если синхронизация параметров включена в пользовательских предпочтениях, для пространств кода, открытых в веб-клиенте, поведение синхронизации параметров зависит от списка доверенных репозиториев.

• Если вы создаете пространство кода из доверенного репозитория, синхронизация параметров включена в пространстве кода по умолчанию, поэтому параметры синхронизируются как с облаком, так и из облака.

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

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

Список доверенных репозиториев для GitHub Codespaces предоставляется совместно между функциями проверки групповой политики и синхронизации параметров. Если у вас есть обе функции, если вы добавили выбранный список доверенных репозиториев для проверки GPG, синхронизация параметров включена в пространствах кода, созданных из этих репозиториев. Если вы доверяете новому репозиторию для синхронизации параметров, проверка GPG включена для того же репозитория. Хотя функции используют один и тот же список доверенных репозиториев, вы можете включить или отключить проверку GPG и синхронизацию параметров независимо.

Дополнительные сведения об управлении предпочтениями проверки GPG см. в разделе Управление верификацией GPG для GitHub Codespaces.

Управление параметрами синхронизации параметров

Если включить синхронизацию параметров в пользовательских предпочтениях, пространства кода, открытые в веб-клиенте VS Code будут извлекать кэшированные параметры из облака, а пространства кода, созданные из доверенных репозиториев, синхронизируются с кэшируемыми параметрами в обоих направлениях.

1. В правом верхнем углу любой страницы на GitHubщелкните рисунок профиля, а затем выберите октикона "шестеренка" aria-hidden="true" aria-label="gear" %} Settings.

2. В разделе "Код, планирование и автоматизация" боковой панели щелкните Codespaces.

3. Чтобы включить или отключить синхронизацию параметров, в разделе "Синхронизация параметров" выберите или отключите включение****.

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

   Примечание.

   Рекомендуется использовать выбранный список доверенных репозиториев. Дополнительные сведения см. в разделе Безопасность в GitHub Codespaces.

Обновления вступают в силу в новых пространствах кода. Однако вы можете включить синхронизацию параметров в существующем пространстве кода. Дополнительные сведения см. в разделе "Включение синхронизации параметров" в пространстве кода.

Включение синхронизации параметров в пространстве кода

В следующей процедуре описывается включение синхронизации параметров в пространстве кода, открытом в веб-клиенте. Сведения о включении синхронизации параметров в классическом приложении VS Code см. в документации по VS Code.

1. В VS Codeв нижней части панели действий выберите , а затем нажмите кнопку "Войти в параметры синхронизации".

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

   Примечание.

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

3. Чтобы настроить настройки синхронизации, откройте палитру команд Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux), затем начните вводить «Настройки синхронизации». Нажмите кнопку " Синхронизация параметров": настройка....

4. Выберите параметры, которые требуется синхронизировать, а затем нажмите кнопку "ОК".

   

Отключение синхронизации параметров в пространстве кода

Вы можете отключить синхронизацию параметров, чтобы прекратить синхронизацию параметров с экземпляром VS Code.

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

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

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

2. В нижней части панели действий выберите и нажмите кнопку "Синхронизация параметров" включена.

3. В раскрывающемся списке нажмите кнопку "Параметры синхронизации: отключить".

   

4. Чтобы очистить кэшированные параметры, в диалоговом окне выберите отключить синхронизацию на всех устройствах и очистить данные из облака.

   

5. Нажмите кнопку " Отключить".

Файлы с точкой

Файлы с точкой — это файлы и папки в системах Unix, которые начинаются с .. Они служат для управления конфигурациями приложений и оболочки в системе. Хранить файл с точкой и управлять им можно в репозитории на сайте GitHub. Для советов и обучающих материалов о том, что включить в ваш репозиторий dotfiles, см. GitHub does dotfiles.

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

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

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

• install.sh
• install
• bootstrap.sh
• bootstrap
• script/bootstrap
• setup.sh
• setup
• script/setup

Если ни один из этих файлов не найден, для всех файлов или папок в выбранном репозитории файлов с точкой, которые начинаются с ., будут созданы символические ссылки на каталог ~ или $HOME пространства codespace.

Любые изменения в выбранном репозитории файлов с точкой будут применяться только к каждому новому пространству codespace и не будут влиять на существующее пространство codespace.

Включение репозитория файлов с точкой дляCodespaces

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

1. В правом верхнем углу любой страницы на GitHubщелкните рисунок профиля, а затем выберите октикона "шестеренка" aria-hidden="true" aria-label="gear" %} Settings.

2. В разделе "Код, планирование и автоматизация" боковой панели щелкните Codespaces.

3. В разделе "Dotfiles" выберите "Автоматически устанавливать dotfiles ", чтобы GitHub Codespaces автоматически устанавливал dotfiles в каждое создаваемое пространство кода.

   

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

   

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

Если пространству кода не удается выбрать параметры конфигурации из dotfiles, см. раздел Устранение неполадок с вариантами персонализации для GitHub Codespaces.

Другие доступные параметры

Вы также можете персонализировать GitHub Codespaces с помощью дополнительных параметров в личных параметрах:

• Сведения о включении проверки GPG см. в разделе Управление верификацией GPG для GitHub Codespaces.
• Сведения о настройке редактора см. в разделе Настройка редактора по умолчанию для GitHub Codespaces.
• Чтобы задать, сколько времени пространство кода может оставаться неиспользуемо до автоматической остановки, см. раздел Установка периода тайм-аута для GitHub Codespaces.
• Чтобы задать период, для которого сохраняются неиспользуемые пространства кода, см. раздел Настройка автоматического удаления codespace.
• Сведения о настройке региона по умолчанию см. в разделе Настройка вашего региона по умолчанию для GitHub Codespaces.

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

• Создание репозитория
• Подробные сведения о GitHub Codespaces
• Настройка codespace
• Управление кодовыми пространствами