Skip to main content

Personalizar os codespaces para a sua conta

Você pode personalizar Codespaces usando um repositório dotfiles em GitHub Enterprise Cloud 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 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 as configurações que você deseja 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 orientação e tutoriais sobre o que incluir no repositório dotfile, consulte o GitHub faz 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.

Você pode configurar Codespaces para usar Dotfiles de qualquer repositório que você tiver, selecionando esse repositório nas suas Configurações pessoais de Codespaces.

Ao criar um novo codespace, o GitHub clona seu repositórios selecionado para o ambiente do codespace e procura 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, todos os arquivos ou pastas no repositório de dotfiles selecionados que começam com . têm um link simbólico para o ~ do codespace ou $HOME.

Quaisquer alterações nos seus dotfiles selecionados 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 "Introdução a contêineres de desenvolvimento".

Habilitando o repositório de dotfiles para Codespaces

Você pode usar o repositório de Dotfiles selecionado para personalizar seu ambiente de Codespaces. Depois de escolher o seu repositório de dotfiles, você poderá adicionar seus scripts, preferências e configurações. Em seguida, você deverá habilitar os seus dotfiles na sua página pessoal de configurações de Codespaces.

Aviso: Dotfiles têm a capacidade de executar scripts arbitrários, que podem conter codespace inesperado ou malicioso. Antes de instalar o repositório de um dotfiles, recomendamos verificar os scripts para garantir que eles não executam nenhuma ação inesperada.

  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. In the "Code, planning, and automation" section of the sidebar, click Codespaces.

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

  4. Escolha o repositório no qual você deseja instalar dotfiles. Selecionando um repositório de dotfiles

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.

Se o seu código não consegue pegar as configurações nos dotfiles, consulte "Solução de problemas para Codespaces".

Outras configurações disponíveis

Você também pode personalizar Codespaces usando as configurações adicionais de Codespacesde:

Leia mais