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.

Configurar codespaces para seu projeto

Você pode definir uma configuração-padrão para cada novo codespace do seu repositório para garantir que os colaboradores tenham todas as ferramentas e configurações de que precisam em seu ambiente de desenvolvimento on-line.

As pessoas com permissões de gravação em um repositório podem criar ou editar a configuração-padrão do codespace.

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".

Neste artigo

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."

Sobre configurações-padrão do codespace

Você pode criar uma configuração padrão de codespace para o seu repositório que determina o ambiente de cada novo codespace que alguém criar para esse repositório. A configuração pode incluir frameworks, ferramentas, extensões e redirecionamento de portas.

Você também pode personalizar aspectos do ambiente dos espaços de códigos para qualquer espaço de código que sua conta criar. A personalização pode incluir preferências de shell e ferramentas adicionais. Sua personalização dotfiles é aplicada antes da configuração de código padrão de um repositório. Para obter mais informações, consulte "Personalizar Espaços de código para a sua conta".

É possível criar uma configuração-padrão do codespace usando uma configuração de contêiner pré-criada para seu tipo de projeto, ou você pode criar uma configuração personalizada específica para as necessidades do seu projeto.

O Espaços de código usa as configurações contidas em um arquivo denominado devcontainer.json na raiz do repositório ou na pasta .devcontainer. Você pode usar devcontainer.json para definir as configurações-padrão para todo o ambiente de código, incluindo o editor de Visual Studio Code, mas você também pode definir configurações específicas do editor em um arquivo denominado .vscode/settings.json.

As alterações na configuração do codespace de um repositório aplicam-se apenas a cada novo codespace e não afetam nenhum codespace existente.

Usar uma configuração de contêiner pré-criado

Você pode usar qualquer configuração de contêiner pré-criada para Visual Studio Code, que está disponível no repositório vscode-dev-containers. As definições de contêiner pré-criadas incluem uma configuração comum para um tipo específico de projeto e podem ajudá-lo rapidamente a começar com uma configuração que já tem as opções de contêiner apropriadas, configurações do Visual Studio Code, e extensões do Visual Studio Code, que devem ser instaladas.

  1. Clonar ou fazer o download do repositório vscode-dev-containers.
  2. No repositório vscode-dev-containers, acesse a pasta contêineres e, em seguida, escolha uma configuração de contêiner para as necessidades de seu projeto. We'll use the Node.js & JavaScript container configuration as an example.
  3. From the Node.js & JavaScript folder, copy the .devcontainer folder to the root of your project's repository.
  4. Faça commit e push da nova configuração para o repositório do seu projeto no GitHub.

Cada novo codespace criado a partir de um branch que contém a pasta .devcontainer será configurado de acordo com o conteúdo da pasta. Para obter mais informações, consulte "Criar um codespace".

Crianr uma configuração personalizada de codespace

Se nenhuma das configurações pré-criadas atenderem às suas necessidades, você poderá criar uma configuração personalizada adicionando um arquivo devcontainer.json à raiz do seu repositório ou a uma pasta .devcontainer. No arquivo, você pode usar chaves de configuração compatíveis para especificar os aspectos do ambiente do código, como quais extensões do Visual Studio Code serão instaladas.

Ao configurar as configurações de editor para Visual Studio Code, há três escopos disponíveis: Workspace, Remote [Codespaces], e User. Se uma configuração for definida em vários escopos, as configurações do Workspace têm prioridade e, em seguida Remote [Codespaces], depois User.

Você pode definir as configurações de editor-padrão para Visual Studio Code em dois lugares.

  • As configurações do editor definidas em .vscode/settings.json são aplicadas como configurações do escopo do espaço de trabalho no codespace.
  • Configurações do editor definidas na chave Configurações no devcontainer.json são aplicadas como configuração de escopo Remote [Codespaces] nesse codespace.

Chaves de configuração de codespace compatíveis

Você pode usar as chaves de configuração compatíveis com Espaços de código em devcontainer.json.

Configurações gerais

  • name
  • settings
  • extensões
  • forwardPorts
  • devPort
  • postCreateCommand

Docker, arquivo Docker ou configurações de imagem

  • image
  • Arquivo docker
  • context
  • containerEnv
  • remoteEnv
  • containerUser
  • remoteUser
  • updateRemoteUserUID
  • mounts
  • workspaceMount
  • workspaceFolder
  • runArgs
  • overrideCommand
  • shutdownAction
  • dockerComposeFile

Para obter mais informações sobre as configurações disponíveis para devcontainer.json, consulte referência do devcontainer.json na documentação do Visual Studio Code.

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato