Personalizar os codespaces para a sua conta

Sobre a personalização de Codespaces

Ao usar qualquer ambiente de desenvolvimento, a personalização das configurações e ferramentas para suas preferências e fluxos de trabalho é uma etapa importante. Codespaces permite duas formas principais de personalizar seus codespaces.

• Configurações de sincronização - Você pode usar e compartilhar as configurações Visual Studio Code entre Codespaces e outras instâncias de Visual Studio Code.
• Dotfiles - Você pode usar um repositório dotfiles público para especificar scripts, preferências do shell e outras configurações.

A personalização de Codespaces aplica-se a qualquer codespace que você criar.

Os mantenedores do projeto também podem definir uma configuração-padrão que se aplica a todos os codespaces de um repositório, criados por qualquer pessoa. Para obter mais informações, consulte "Configurar o Codespaces para seu projeto".

Configurações de sincronização

A sincronização de configurações permite que você compartilhe configurações como configurações, atalhos de teclado, snippets, extensões e estado da interface de usuário entre as máquinas e instâncias de Visual Studio Code.

To enable Settings Sync, in the bottom-left corner of the Activity Bar, select and click Turn on Settings Sync…. From the dialog, select which settings you'd like to sync.

Para obter mais informações, consulte o Guia de sincronização de configurações na documentação de Visual Studio Code.

Dotfiles

Os Dotfiles são arquivos e pastas de sistemas de tipo Unix, que começam com . e controlam a configuração de aplicativos e shells no seu sistema. Você pode armazenar e gerenciar seus dotfiles em um repositório no GitHub. Para obter aconselhamento e tutoriais sobre o que incluir no repositório dotfiles, consulte GitHub gerencia dotfiles.

Se sua conta de usuário em GitHub possui um repositório público denominado dotfiles, GitHub poderá usar este repositório automaticamente para personalizar o ambiente do seu codespace, uma vez habilitado nas suas configurações de codespaces pessoais. Atualmente, não são compatíveis os repositórios privados dotfiles.

O seu repositório dotfiles pode incluir os alias e preferências do seu shell, quaisquer ferramentas que você deseja instalar ou qualquer outra personalização de codespace que desejar fazer.

Ao criar um novo codespace, o GitHub clona seus repositórios de dotfiles para o ambiente do codespace e procura por um dos seguintes arquivos para configurar o ambiente.

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

Se nenhum desses arquivos for encontrado, quaisquer arquivos ou pastas nos dotfiles que comecem com . será vinculado simbolicamente ao diretório ~ ou $HOME do codespace.

Quaisquer alterações no repositório de dotfiles serão aplicadas apenas a cada novo codespace e não afetarão nenhum codespace existente.

Enabling your dotfiles repository for Codespaces

You can use your public dotfiles repository to personalize your Codespaces environment. Once you set up that repository, you can add your scripts, preferences, and configurations to it. You then need to enable your dotfiles from your personal Codespaces settings page.

1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações.

2. Na barra lateral esquerda, clique em Codespaces.

3. Under "Dotfiles", select "Automatically install dotfiles" so that Codespaces automatically installs your dotfiles into every new codespace you create.

   Note: This option is only available if you've created a public dotfiles repository for your user account.

You can add further script, preferences, configuration files to your dotfiles repository or edit existing files whenever you want. Changes to settings will only be picked up by new codespaces.

Other available settings

You can also personalize Codespaces using additional Codespaces settings:

• To set your default region, see "Setting your default region for Codespaces."
• To set your editor, see "Setting your default editor for Codespaces."
• To add encrypted secrets, see "Managing encrypted secrets for Codespaces."
• To enable GPG verification, see "Managing GPG verification for Codespaces."
• To allow your codespaces to access other repositories, see "Managing access and security for Codespaces."

Leia mais

• "Criar um repositório"