Personalizar os codespaces para a sua conta

Você pode personalizar Codespaces usando um repositório dotfiles em GitHub ou usando Configurações de Sincronização.

Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. Para obter mais informações, consulte os "produtos do GitHub".

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.

Para habilitar a sincronização de configurações, no canto inferior esquerdo da barra de atividades, selecione e clique Habilitar as configurações de sincronização…. Na caixa de diálogo, selecione quais configurações você gostaria de sincronizar.

Opção de configuração de sincronização no menu de gerenciamento

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.

Observação: Atualmente, o Codespaces não é compatível com a personalização das configurações do Usuário para o editor de Visual Studio Code com o repositório dotfiles. É possível definir as configurações-padrão do espaço de trabalho e Remote [Codespaces] para um projeto específico no repositório do projeto. Para obter mais informações, consulte "Configurar o Codespaces para seu projeto".

Habilitando o repositório de dotfiles para Codespaces

Você pode usar o seu repositório dotfiles público para personalizar o seu ambiente de Codespaces. Depois de configurar esse repositório, é possível adicionar seus scripts, preferências e configurações a ele. Em seguida, você deverá habilitar os seus dotfiles na sua página pessoal de configurações de Codespaces.

  1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações. Ícone Settings (Configurações) na barra de usuário

  2. Na barra lateral esquerda, clique em Codespaces. Aba de codespaces na barra lateral de configurações do usuário

  3. Em "Dotfiles", selecione "Instalar dotfiles automaticamente" para que Codespaces instale automaticamente seus dotfiles em cada novo codespace que você criar. Instalando dotfiles

    Observação: Esta opção só está disponível se você criou um repositório público de dotfiles para a sua conta de usuário.

Você pode adicionar mais script, preferências e arquivos de configuração ao repositório de dotfiles ou editar arquivos existentes sempre que quiser. As alterações nas configurações só serão selecionadas por novos codespaces.

Outras configurações disponíveis

Você também pode personalizar Codespaces usando outras Configurações de codespace:

Leia mais

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.