Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Usando controle de origem no seu codespace

Depois de fazer alterações em um arquivo no seu código, você pode fazer um commit rápido das alterações e fazer push da sua atualização para o repositório remoto.

Observação: o uso dos GitHub Codespaces com IDEs do JetBrains está em versão beta pública e sujeito a alterações no momento.

Sobre o controle do código-fonte no GitHub Codespaces

Você pode executar todas as ações do Git necessárias diretamente no seu codespace. Por exemplo, é possível obter alterações de um repositório remoto, mudar de branch, criar um branch, fazer commit, efetuar push e criar uma solicitação de pull. Você pode usar o terminal integrado dentro do seu codespace para inserir nos comandos do Git, ou você pode clicar em ícones e opções de menu para realizar todas as tarefas mais comuns do Git. Este guia explica como usar a interface gráfica de usuário para controle de origem.

Para obter mais informações sobre o suporte do Git no Visual Studio Code, confira "Como usar o controle de versão no VS Code" na documentação do Visual Studio Code.

O controle do código-fonte no cliente Web do Visual Studio Code usa o mesmo fluxo de trabalho que o aplicativo da área de trabalho do Visual Studio Code. Para obter mais informações, confira "Como usar o controle de versão no VS Code" na documentação do Visual Studio Code.

Um fluxo de trabalho típico para atualizar um arquivo que usa GitHub Codespaces seria:

  • A partir do branch padrão do seu repositório em GitHub, crie um codespace. Confira "Como criar um codespace para um repositório".
  • No seu código, crie uma nova agência para trabalhar.
  • Faça suas alterações e salve-as.
  • Confirme a alteração.
  • Abra um pull request.

Sobre a bifurcação automática

Você pode criar um codespace para qualquer repositório para o qual tenha acesso de gravação. Se você só tiver acesso de leitura a um repositório, poderá criar um codespace para esse repositório, desde que possa bifurcá-lo.

Você não precisa bifurcar o repositório antes de criar o codespace. Por exemplo, você poderá criar um codespace do repositório para examinar o projeto e fazer alterações experimentais e, em seguida, excluir o codespace se não precisar mais dele.

Se você fizer commit do codespace, GitHub Codespaces criará uma bifurcação do repositório em sua conta e a vinculará ao seu codespace ou, se você já tiver uma bifurcação para o repositório, vinculará seu codespace a ela. Em seguida, você pode enviar suas alterações por push para a bifurcação e criar uma solicitação de pull para propor as alterações no repositório upstream.

Nota: Se você excluir o repositório de bifurcação, todos os codespaces vinculados à bifurcação serão excluídos, mesmo que você os tenha criado originalmente no repositório upstream.

Se você fizer um commit da linha de comando, verá um prompt perguntando se deseja continuar vinculando seu codespace a uma bifurcação nova ou existente. Insira y para continuar. Se você confirmar alterações da exibição Controle do código-fonte no VS Code ou na barra de navegação em um IDE JetBrains, seu codespace será vinculado automaticamente a uma bifurcação, sem apresentação de nenhum prompt.

Quando GitHub Codespaces cria uma bifurcação ou vincula seu codespace a uma bifurcação existente, os eventos a seguir acontecem.

  • O token de acesso associado ao seu codespace é atualizado para incluir as permissões read e write à sua bifurcação, além da permissão read para o repositório upstream.
  • Nas configurações do Git, o repositório upstream é reatribuído ao nome upstream e a bifurcação é adicionada como um novo repositório remoto com o nome origin.

Por padrão, os comandos de controle do código-fonte que você acessa da interface do usuário do editor, como o botão Sincronizar Alterações no VS Code, são direcionados à sua bifurcação. Se você estiver trabalhando na linha de comando, poderá usar origin para fazer referência à bifurcação e upstream para fazer referência ao repositório upstream. Por exemplo, você pode buscar alterações do repositório upstream para garantir que seu codespace esteja atualizado com as alterações mais recentes no projeto.

$ git fetch upstream

Após fazer alterações, você poderá enviá-las por push para uma ramificação de recurso de sua bifurcação.

$ git push origin my-feature-branch

Para obter mais informações, confira "Sobre os forks".

Como publicar um codespace criado com base em um modelo

Quando você cria um codespace com base em um repositório de modelos ou um modelo na página "Seus codespaces", o trabalho feito não é armazenado em um repositório no GitHub até que você publique o codespace. Para saber mais, confira "Como criar um codespace com base em um modelo".

Se você estiver trabalhando em um codespace, poderá publicá-lo no cliente Web ou no aplicativo da área de trabalho do VS Code.

  1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte. Exibição Controle do Código-Fonte

  2. Para preparar as alterações, clique em + ao lado do arquivo que você alterou ou ao lado de Alterações se tiver alterado vários arquivos e quiser preparar todos eles.

    Barra lateral do controle do código-fonte com o botão de preparo realçado

    Observação: se você começar com o modelo em branco do GitHub, não verá uma lista de alterações, a menos que já tenha inicializado o diretório como um repositório Git. Para publicar codespaces criados por meio do modelo em branco, clique em Publicar no GitHub na exibição Controle do Código-Fonte e pule para a etapa 5.

  3. Para fazer commit das alterações preparadas, digite uma mensagem de commit descrevendo a alteração que você fez e clique em Fazer commit.

    Barra lateral do controle do código-fonte com uma mensagem de commit

  4. Clique em Publicar Branch.

    Captura de tela do botão "Publicar Branch" no VS Code

  5. Na lista suspensa "Nome do Repositório", digite um nome para o novo repositório e selecione Publicar no repositório privado do GitHub ou Publicar no repositório público do GitHub .

    Captura de tela da lista suspensa "Nome do Repositório" no VS Code

    O proprietário do novo repositório será a conta do GitHub com a qual você criou o codespace.

  6. Opcionalmente, no pop-up exibido no canto inferior direito do editor, clique em Abrir no GitHub para exibir o novo repositório no GitHub.com.

    Captura de tela do pop-up "Abrir no GitHub" no VS Code

Criar ou trocar de branches

  1. Se o branch atual não for mostrado na barra de status, na parte inferior do seu codespace, clique com o botão direito do mouse na barra de status e selecione Controle do código-fonte.
  2. Clique no nome do branch na barra de status. O branch na barra de status
  3. No menu suspenso, clique no branch para o qual deseja alternar ou insira o nome de um novo branch e clique em Criar branch. Escolha no menu do branch

Dica: se alguém alterar um arquivo no repositório remoto, essas alterações não aparecerão no branch para o qual você mudou, até que seja efetuado pull das alterações para o codespace.

Fazendo commit das suas alterações

  1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte. Exibição Controle do Código-Fonte
  2. Para preparar as alterações, clique em + ao lado do arquivo que você alterou ou ao lado de Alterações se tiver alterado vários arquivos e quiser preparar todos eles. Barra lateral do controle do código-fonte com o botão de preparo realçado
  3. Digite uma mensagem do commit que descreve a alteração que você fez. Barra lateral do controle do código-fonte com uma mensagem de commit
  4. Para fazer commit das alterações preparadas, clique na marca de seleção na parte superior da barra lateral do controle do código-fonte. Clique no ícone da tag de verificação

Fazer pull das alterações do repositório remoto

Você pode fazer pull das alterações do repositório remoto para seu codespace a qualquer momento.

  1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte. Exibição Controle do Código-Fonte
  2. Na parte superior da barra lateral, clique nas reticências ( ). Botão de reticências para Exibir e Mais Ações
  3. No menu suspenso, clique em Efetuar pull.

Se a configuração do contêiner dev foi alterada desde que você criou o codespace, você pode aplicar as alterações reconstruindo o contêiner para o codespace. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento".

Configurar o seu codespace para buscar novas alterações automaticamente

É possível definir seu codespace para obter automaticamente os detalhes de quaisquer novos commits que tenham sido criados no repositório remoto. Isso permite que você veja se sua cópia local do repositório está desatualizada. Nesse caso, você pode optar por fazer pull das novas alterações.

Se a operação de busca detectarem novas alterações no repositório remoto, você verá o número de novos commits na barra de status. Você pode fazer pull das alterações para a sua cópia local.

  1. Clique no botão Gerenciar na parte inferior da barra de atividades. Botão Gerenciar
  2. No menu, clique em Configurações.
  3. Na página Configurações, procure autofetch. Pesquisa por busca automática
  4. Para buscar detalhes das atualizações de todos os repositórios remotos registrados no repositório atual, defina Git: Busca Automática como all. Habilitar a busca automática do Git
  5. Caso deseje alterar o número de segundos entre cada busca automática, edite o valor de Git: Período de Busca Automática.

Abrindo um pull request

  1. Depois de fazer commit das alterações na cópia local do repositório, clique no ícone Criar Solicitação de Pull. Barra lateral do controle do código-fonte com o botão de preparo realçado
  2. Verifique se o branch local e o repositório do qual você está fazendo merge, o branch remoto e o repositório no qual você está fazendo merge estão corretos. Em seguida, dê ao pull request um título e uma descrição. Barra lateral do controle do código-fonte com o botão de preparo realçado
  3. Clique em Criar.

Fazer push das alterações para o seu repositório remoto

Você pode enviar por push as alterações salvas e confirmadas. Isso aplica essas alterações ao branch upstream no repositório remoto. Você pode querer fazer isso se ainda não estiver pronto para criar um pull request, ou se você preferir criar um pull request em GitHub.

  1. Na parte superior da barra lateral, clique nas reticências ( ). Botão de reticências para Exibir e Mais Ações
  2. No menu suspenso, clique em Efetuar push.

Como publicar um codespace criado com base em um modelo

Quando você cria um codespace com base em um repositório de modelos ou um modelo na página "Seus codespaces", o trabalho feito não é armazenado em um repositório no GitHub até que você publique o codespace. Para saber mais, confira "Como criar um codespace com base em um modelo".

Se você estiver trabalhando em um codespace, poderá publicá-lo no cliente Web ou no aplicativo da área de trabalho do VS Code.

  1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte. Exibição Controle do Código-Fonte

  2. Para preparar as alterações, clique em + ao lado do arquivo que você alterou ou ao lado de Alterações se tiver alterado vários arquivos e quiser preparar todos eles.

    Barra lateral do controle do código-fonte com o botão de preparo realçado

    Observação: se você começar com o modelo em branco do GitHub, não verá uma lista de alterações, a menos que já tenha inicializado o diretório como um repositório Git. Para publicar codespaces criados por meio do modelo em branco, clique em Publicar no GitHub na exibição Controle do Código-Fonte e pule para a etapa 5.

  3. Para fazer commit das alterações preparadas, digite uma mensagem de commit descrevendo a alteração que você fez e clique em Fazer commit.

    Barra lateral do controle do código-fonte com uma mensagem de commit

  4. Clique em Publicar Branch.

    Captura de tela do botão "Publicar Branch" no VS Code

  5. Na lista suspensa "Nome do Repositório", digite um nome para o novo repositório e selecione Publicar no repositório privado do GitHub ou Publicar no repositório público do GitHub .

    Captura de tela da lista suspensa "Nome do Repositório" no VS Code

    O proprietário do novo repositório será a conta do GitHub com a qual você criou o codespace.

  6. Opcionalmente, no pop-up exibido no canto inferior direito do editor, clique em Abrir no GitHub para exibir o novo repositório no GitHub.com.

    Captura de tela do pop-up "Abrir no GitHub" no VS Code

Criar ou trocar de branches

  1. Se o branch atual não for mostrado na barra de status, na parte inferior do seu codespace, clique com o botão direito do mouse na barra de status e selecione Controle do código-fonte.
  2. Clique no nome do branch na barra de status. O branch na barra de status
  3. No menu suspenso, clique no branch para o qual deseja alternar ou insira o nome de um novo branch e clique em Criar branch. Escolha no menu do branch

Dica: se alguém alterar um arquivo no repositório remoto, essas alterações não aparecerão no branch para o qual você mudou, até que seja efetuado pull das alterações para o codespace.

Fazendo commit das suas alterações

  1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte. Exibição Controle do Código-Fonte
  2. Para preparar as alterações, clique em + ao lado do arquivo que você alterou ou ao lado de Alterações se tiver alterado vários arquivos e quiser preparar todos eles. Barra lateral do controle do código-fonte com o botão de preparo realçado
  3. Digite uma mensagem do commit que descreve a alteração que você fez. Barra lateral do controle do código-fonte com uma mensagem de commit
  4. Para fazer commit das alterações preparadas, clique na marca de seleção na parte superior da barra lateral do controle do código-fonte. Clique no ícone da tag de verificação

Fazer pull das alterações do repositório remoto

Você pode fazer pull das alterações do repositório remoto para seu codespace a qualquer momento.

  1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte. Exibição Controle do Código-Fonte
  2. Na parte superior da barra lateral, clique nas reticências ( ). Botão de reticências para Exibir e Mais Ações
  3. No menu suspenso, clique em Efetuar pull.

Se a configuração do contêiner dev foi alterada desde que você criou o codespace, você pode aplicar as alterações reconstruindo o contêiner para o codespace. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento".

Configurar o seu codespace para buscar novas alterações automaticamente

É possível definir seu codespace para obter automaticamente os detalhes de quaisquer novos commits que tenham sido criados no repositório remoto. Isso permite que você veja se sua cópia local do repositório está desatualizada. Nesse caso, você pode optar por fazer pull das novas alterações.

Se a operação de busca detectarem novas alterações no repositório remoto, você verá o número de novos commits na barra de status. Você pode fazer pull das alterações para a sua cópia local.

  1. Clique no botão Gerenciar na parte inferior da barra de atividades. Botão Gerenciar
  2. No menu, clique em Configurações.
  3. Na página Configurações, procure autofetch. Pesquisa por busca automática
  4. Para buscar detalhes das atualizações de todos os repositórios remotos registrados no repositório atual, defina Git: Busca Automática como all. Habilitar a busca automática do Git
  5. Caso deseje alterar o número de segundos entre cada busca automática, edite o valor de Git: Período de Busca Automática.

Abrindo um pull request

  1. Depois de fazer commit das alterações na cópia local do repositório, clique no ícone Criar Solicitação de Pull. Barra lateral do controle do código-fonte com o botão de preparo realçado
  2. Verifique se o branch local e o repositório do qual você está fazendo merge, o branch remoto e o repositório no qual você está fazendo merge estão corretos. Em seguida, dê ao pull request um título e uma descrição. Barra lateral do controle do código-fonte com o botão de preparo realçado
  3. Clique em Criar.

Fazer push das alterações para o seu repositório remoto

Você pode enviar por push as alterações salvas e confirmadas. Isso aplica essas alterações ao branch upstream no repositório remoto. Você pode querer fazer isso se ainda não estiver pronto para criar um pull request, ou se você preferir criar um pull request em GitHub.

  1. Na parte superior da barra lateral, clique nas reticências ( ). Botão de reticências para Exibir e Mais Ações
  2. No menu suspenso, clique em Efetuar push.

Criar ou trocar de branches

  1. Clique no nome do branch no lado direito da barra de status.

    Captura de tela do nome do branch na barra de status

  2. No menu pop-up, siga um destes procedimentos:

    • Para criar um branch com base no branch atual, clique no nome do branch atual e escolha Novo Branch.

      Captura de tela da opção de novo branch

      Insira um nome para o novo branch e clique em Criar.

      Captura de tela da caixa de diálogo Criar branch

    • Para fazer check-out de um branch existente, comece a digitar o nome do branch. Clique no branch na lista e depois em Check-out.

      Captura de tela da opção de check-out

      Dica: se alguém alterar um arquivo no repositório remoto, essas alterações não aparecerão no branch para o qual você mudou, até que seja efetuado pull das alterações para o codespace.

Fazendo commit das suas alterações

  1. No lado direito da barra de navegação, clique na marca de seleção.

    Captura de tela da marca de seleção de commit

  2. Na caixa de diálogo Fazer Commit das Alterações, insira uma mensagem de commit.

  3. Clique em Confirmar.

    Como alternativa, clique na seta para baixo ao lado de Fazer commit e clique Fazer commit e enviar por push.

    Captura de tela do botão Fazer commit e do botão de push

Fazer pull das alterações do repositório remoto

Você pode efetuar pull de alterações do mesmo branch no repositório remoto e aplicar essas alterações à cópia do repositório em que está trabalhando no codespace.

  1. No lado direito da barra de navegação, clique na seta que aponta para baixo.

    Captura de tela do botão de seta para baixo de atualização do projeto

  2. Na caixa de diálogo Atualizar Projeto, escolha se deseja mesclar ou trocar base das alterações de entrada.

    Captura de tela da caixa de diálogo Atualizar Projeto

  3. Clique em OK.

Fazer push das alterações para o seu repositório remoto

Você pode enviar por push as alterações salvas e confirmadas. Isso aplica essas alterações ao branch upstream no repositório remoto. Você pode querer fazer isso se ainda não estiver pronto para criar um pull request, ou se você preferir criar um pull request em GitHub.

  1. No lado direito da barra de navegação, clique na seta que aponta para cima.

    Captura de tela da seta para cima dos commits com push

  2. Na caixa de diálogo Efetuar Push de Commits, clique em Efetuar Push.