Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Personalizar os codespaces para a sua conta

O Espaços de código usa o repositório dotfiles no GitHub para personalizar cada novo codespace que você criar.

Qualquer pessoa pode criar um repositório dotfiles para personalizar o Espaços de código para sua conta de usuário.

Os espaços de códigos estão disponíveis para contas de usuário usando GitHub Free ou GitHub Pro. Para obter mais informações, consulte os "produtos do GitHub".

Nota: Espaços de código está atualmente em versão beta e sujeito a alterações. Durante o período beta, GitHub não faz nenhuma garantia sobre a disponibilidade de Espaços de código. Para obter mais informações sobre fontes de publicação, consulte "About Espaços de código."

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 conselhos e tutoriais sobre o que incluir no repositório dotfiles, consulte GitHub gerencia dotfiles.

Se sua conta de usuário no GitHub possui um repositório público denominado dotfiles, o GitHub usa este repositório automaticamente para personalizar seu ambiente de codespace. 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.

A personalização do código usando seu repositório dotfiles 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. Sua personalização dotfiles é aplicada antes da configuração de código padrão de um repositório. Para obter mais informações, consulte "Configurar o Espaços de código para o seu projeto".

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
  • setup.sh
  • 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.

Para obter mais informações, consulte Personalizar na documentação do Visual Studio Code.

Observação: Atualmente, o Espaços de código 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 Espaços de código para seu projeto".

Further reading

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato