{"meta":{"title":"Usando controle de origem no seu codespace","intro":"Depois de fazer alterações em um arquivo no seu codespace, você pode rapidamente fazer um commit das alterações e enviar sua atualização para o repositório remoto.","product":"Codespaces","breadcrumbs":[{"href":"/pt/codespaces","title":"Codespaces"},{"href":"/pt/codespaces/developing-in-a-codespace","title":"Desenvolver em um codespace"},{"href":"/pt/codespaces/developing-in-a-codespace/using-source-control-in-your-codespace","title":"Controle do código-fonte"}],"documentType":"article"},"body":"# Usando controle de origem no seu codespace\n\nDepois de fazer alterações em um arquivo no seu codespace, você pode rapidamente fazer um commit das alterações e enviar sua atualização para o repositório remoto.\n\n## Sobre o controle do código-fonte em GitHub Codespaces\n\nVocê 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.\n\n
\n\nPara obter mais informações sobre o suporte ao Git no Visual Studio Code, consulte [Usando o Controle de Versão em VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support) na documentação do Visual Studio Code.\n\n
\n\n
\n\nO controle do código-fonte no Visual Studio Code cliente Web usa o mesmo fluxo de trabalho que o aplicativo da Visual Studio Code área de trabalho. Para mais informações, consulte [Usando controle de versão no VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support) na documentação do Visual Studio Code.\n\n
\n\nUm fluxo de trabalho típico para atualizar um arquivo usando GitHub Codespaces seria:\n\n* Na branch padrão do seu repositório em GitHub, crie um codespace. Confira [Como criar um codespace para um repositório](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository).\n* No seu espaço de código, crie um novo ramo para trabalhar.\n* Faça suas alterações e salve-as.\n* Confirme a alteração.\n* Abra um pull request.\n\n> \\[!NOTE]\n> Por padrão, GitHub Codespaces usa o protocolo HTTPS para transferir dados de e para um repositório remoto e autentica com um `GITHUB_TOKEN` configurado com acesso de leitura e gravação ao repositório do qual você cria o codespace. Se você está experimentando problemas com a autenticação, confira [Solução de problemas de autenticação para um repositório](/pt/codespaces/troubleshooting/troubleshooting-authentication-to-a-repository).\n\n## Sobre a bifurcação automática\n\nPara criar um codespace para um repositório para o qual você só tem acesso de leitura, você deve ter permissão para fazer um fork do repositório.\n\nVocê 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.\n\nSe você fizer um commit no codespace ou enviar uma nova ramificação, GitHub Codespaces criará um fork do repositório na sua conta e o vinculará ao seu codespace, ou vinculará seu codespace a um fork existente, caso você já tenha um para o repositório. 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.\n\nSe você fizer um commit da linha de comando, verá um prompt perguntando se deseja continuar vinculando seu codespace a um fork novo ou existente. Insira `y` para continuar. Se você fizer commit das alterações na exibição **Controle de Código-Fonte** no VS Code, seu codespace será automaticamente vinculado a um fork sem que isso seja solicitado.\n\n> \\[!NOTE]\n>\n> * Se você excluir o repositório de fork, todos os codespaces vinculados ao fork serão excluídos, mesmo que você os tenha criado originalmente no repositório upstream.\n> * Se você fizer um commit pela linha de comando e recusar o novo fork inserindo `n`, deverá enviar suas alterações pela linha de comando em vez de usar a exibição Controle do Código-Fonte do VS Code. Se você usar a exibição Controle do Código-Fonte, VS Code ainda tentará criar um fork para você ao fazer push.\n\nQuando GitHub Codespaces cria uma bifurcação ou vincula seu codespace a uma bifurcação existente, as coisas a seguir acontecem.\n\n* 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.\n* 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`.\n\nPor padrão, os comandos de controle de versão que você acessa na interface do usuário do editor, como o botão VS Code em \\*\\*\\*\\*, têm como destino o seu fork. Se você estiver trabalhando na linha de comando, poderá usar `origin` para fazer referência à sua 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.\n\n```shell\ngit fetch upstream\n```\n\nApós fazer alterações, você poderá enviá-las por push para uma ramificação de recurso de sua bifurcação.\n\n```shell\ngit push origin my-feature-branch\n```\n\nPara saber mais, confira [Garfos](/pt/pull-requests/reference/forks).\n\n
\n\n## Como publicar um codespace criado com base em um modelo\n\nQuando você cria um codespace a partir de um repositório de modelos ou um modelo na página \"Seus codespaces\", o trabalho que você faz não será armazenado em um repositório GitHub até que você publique seu codespace. Para saber mais, confira [Como criar um codespace com base em um modelo](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template#publishing-to-a-repository-on-github).\n\nSe você estiver trabalhando em um codespace, poderá publicá-lo no cliente Web ou no aplicativo da área de trabalho do VS Code.\n\n1. Na Barra de Atividades, clique na exibição **Controle do Código-Fonte**.\n\n \n\n2. Para preparar as alterações, clique em **+** ao lado do arquivo que você alterou, ou ao lado de **Changes** se tiver alterado vários arquivos e quiser preparar todos eles.\n\n \n\n > \\[!NOTE]\n > 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.\n\n3. Para fazer commit das alterações preparadas, digite uma mensagem de commit descrevendo a alteração que você fez e clique em **Fazer commit**.\n\n \n\n4. Clique em **Publicar Branch**.\n\n \n\n5. 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** .\n\n \n\n O proprietário do novo repositório será a conta do GitHub com a qual você criou o codespace.\n\n6. Opcionalmente, no pop-up exibido no canto inferior direito do editor, clique em **Abrir no GitHub** para exibir o novo repositório no GitHub.\n\n \n\n## Criar ou trocar de branches\n\n1. 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**.\n\n2. Clique no nome do branch na barra de status.\n\n \n\n3. No menu suspenso, clique no branch para o qual deseja alternar ou insira o nome de um novo branch e clique em **Criar novo branch**.\n\n \n\n> \\[!TIP]\n> Se alguém alterou recentemente um arquivo no repositório remoto, essas alterações não aparecerão na ramificação para o qual você alternou até que seja efetuado pull das alterações no seu codespace.\n\n## Confirmando suas alterações\n\n1. Na Barra de Atividades, clique na exibição **Controle do Código-Fonte**.\n\n \n\n2. Para preparar suas alterações, clique ao lado do arquivo que você alterou ou ao lado **de Alterações** se tiver alterado vários arquivos e quiser preparar todos eles.\n\n \n\n3. Na caixa de texto, digite uma mensagem de confirmação descrevendo a alteração feita.\n\n \n\n4. Clique na seta para baixo no lado direito do botão **Confirmar** e selecione **Confirmar e transmitir** no menu suspenso.\n\n \n\n## Baixando as alterações do repositório remoto\n\nVocê pode obter as alterações do repositório remoto no seu codespace a qualquer momento.\n\n1. Na Barra de Atividades, clique na exibição **Controle do Código-Fonte**.\n\n \n\n2. Na parte superior da barra lateral, clique em .\n\n \n\n3. No menu suspenso, clique em **Efetuar pull**.\n\nSe 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 saber mais, confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).\n\n## Configurar o seu codespace para buscar novas alterações automaticamente\n\nÉ 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ê verifique se sua cópia local do repositório está desatualizada; nesse caso, você pode optar por baixar as novas alterações.\n\nSe a operação de busca detectar novas alterações no repositório remoto, você verá o número de novos commits na barra de status. Você pode, em seguida, baixar as alterações para sua cópia local.\n\n1. Clique no botão **Gerenciar** na parte inferior da barra de atividades.\n\n \n\n2. No menu, clique em **Configurações**.\n\n3. Na página Configurações, procure `autofetch`.\n\n \n\n4. Para buscar detalhes das atualizações de todos os repositórios remotos registrados no repositório atual, defina **Git: Busca Automática** como `all`.\n\n \n\n5. Caso deseje alterar o número de segundos entre cada busca automática, edite o valor de **Git: Período de Busca Automática**.\n\n## Abrindo um pull request\n\n1. Depois de ter confirmado alterações na cópia local do repositório, clique no ícone de solicitação de pull na parte superior da barra lateral \"Controle do Código-Fonte\".\n\n \n\n2. 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.\n\n \n\n3. Clique em **Criar**.\n\n## Enviar alterações para o seu repositório remoto\n\nVocê 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 preferir criar um pull request no GitHub.\n\n1. Na parte superior da barra lateral, clique em .\n\n \n\n2. No menu suspenso, clique em **Efetuar push**.\n\n
\n\n
\n\n## Como publicar um codespace criado com base em um modelo\n\nQuando você cria um codespace a partir de um repositório de modelos ou um modelo na página \"Seus codespaces\", o trabalho que você faz não será armazenado em um repositório GitHub até que você publique seu codespace. Para saber mais, confira [Como criar um codespace com base em um modelo](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template#publishing-to-a-repository-on-github).\n\nSe você estiver trabalhando em um codespace, poderá publicá-lo no cliente Web ou no aplicativo da área de trabalho do VS Code.\n\n1. Na Barra de Atividades, clique na exibição **Controle do Código-Fonte**.\n\n \n\n2. Para preparar as alterações, clique em **+** ao lado do arquivo que você alterou, ou ao lado de **Changes** se tiver alterado vários arquivos e quiser preparar todos eles.\n\n \n\n > \\[!NOTE]\n > 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.\n\n3. Para fazer commit das alterações preparadas, digite uma mensagem de commit descrevendo a alteração que você fez e clique em **Fazer commit**.\n\n \n\n4. Clique em **Publicar Branch**.\n\n \n\n5. 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** .\n\n \n\n O proprietário do novo repositório será a conta do GitHub com a qual você criou o codespace.\n\n6. Opcionalmente, no pop-up exibido no canto inferior direito do editor, clique em **Abrir no GitHub** para exibir o novo repositório no GitHub.\n\n \n\n## Criar ou trocar de branches\n\n1. 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**.\n\n2. Clique no nome do branch na barra de status.\n\n \n\n3. No menu suspenso, clique no branch para o qual deseja alternar ou insira o nome de um novo branch e clique em **Criar novo branch**.\n\n \n\n> \\[!TIP]\n> Se alguém alterou recentemente um arquivo no repositório remoto, essas alterações não aparecerão na ramificação para o qual você alternou até que seja efetuado pull das alterações no seu codespace.\n\n## Confirmando suas alterações\n\n1. Na Barra de Atividades, clique na exibição **Controle do Código-Fonte**.\n\n \n\n2. Para preparar suas alterações, clique ao lado do arquivo que você alterou ou ao lado **de Alterações** se tiver alterado vários arquivos e quiser preparar todos eles.\n\n \n\n3. Na caixa de texto, digite uma mensagem de confirmação descrevendo a alteração feita.\n\n \n\n4. Clique na seta para baixo no lado direito do botão **Confirmar** e selecione **Confirmar e transmitir** no menu suspenso.\n\n \n\n## Baixando as alterações do repositório remoto\n\nVocê pode obter as alterações do repositório remoto no seu codespace a qualquer momento.\n\n1. Na Barra de Atividades, clique na exibição **Controle do Código-Fonte**.\n\n \n\n2. Na parte superior da barra lateral, clique em .\n\n \n\n3. No menu suspenso, clique em **Efetuar pull**.\n\nSe 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 saber mais, confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).\n\n## Configurar o seu codespace para buscar novas alterações automaticamente\n\nÉ 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ê verifique se sua cópia local do repositório está desatualizada; nesse caso, você pode optar por baixar as novas alterações.\n\nSe a operação de busca detectar novas alterações no repositório remoto, você verá o número de novos commits na barra de status. Você pode, em seguida, baixar as alterações para sua cópia local.\n\n1. Clique no botão **Gerenciar** na parte inferior da barra de atividades.\n\n \n\n2. No menu, clique em **Configurações**.\n\n3. Na página Configurações, procure `autofetch`.\n\n \n\n4. Para buscar detalhes das atualizações de todos os repositórios remotos registrados no repositório atual, defina **Git: Busca Automática** como `all`.\n\n \n\n5. Caso deseje alterar o número de segundos entre cada busca automática, edite o valor de **Git: Período de Busca Automática**.\n\n## Abrindo um pull request\n\n1. Depois de ter confirmado alterações na cópia local do repositório, clique no ícone de solicitação de pull na parte superior da barra lateral \"Controle do Código-Fonte\".\n\n \n\n2. 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.\n\n \n\n3. Clique em **Criar**.\n\n## Enviar alterações para o seu repositório remoto\n\nVocê 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 preferir criar um pull request no GitHub.\n\n1. Na parte superior da barra lateral, clique em .\n\n \n\n2. No menu suspenso, clique em **Efetuar push**.\n\n