Introdução ao Git no Azure Repos

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2019 | Visual Studio 2022

Comece a desenvolver seu código usando repositórios do Azure e Git. Você pode usar comandos do Visual Studio ou do Git para clonar um repositório, definir ramificações locais, confirmar e enviar alterações por push e sincronizar com outras pessoas. Se você precisar criar ou importar um repositório, consulte Criar um novo repositório Git em seu projeto ou Importar um repositório Git.

Nota

Este artigo descreve como usar o Visual Studio para gerenciar repositórios Git do Azure Repos. Usando procedimentos semelhantes, você pode usar o Visual Studio para gerenciar repositórios do GitHub. Para clonar um repositório GitHub, obtenha a URL conforme descrito em Clonando um repositório.

Para obter uma visão geral do fluxo de trabalho do Git, consulte o tutorial do Azure Repos Git.

Nota

O Visual Studio 2019 versão 16.8 e posterior fornecem um menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos neste artigo na guia Visual Studio descrevem como usar a experiência do Git e também o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

Pré-requisitos

Categoria	Requerimentos
Acesso ao projeto	Membro de um projeto .
Permissões	- Ver código em projetos privados: Acesso pelo menos Básico. - Clone ou contribua para o código em projetos privados: Membro do grupo de segurança Contributors ou permissões correspondentes no projeto. - Definir permissões de ramo ou repositório: Gerir permissões para o ramo ou repositório. - Alterar ramificação padrão: Editar políticas e permissões para o repositório. - Importar um repositório: Membro do grupo de segurança Administradores de Projeto ou com permissão de Criar repositório ao nível do projeto Git definida como Permitir. Para obter mais informações, consulte Definir permissões do repositório Git.
Serviços	Repos ativado.
Ferramentas	Opcional. Utilize os comandos az repos: Azure DevOps CLI.

Nota

Em projetos públicos, os usuários com acesso Partes Interessadas têm acesso total aos repositórios do Azure, incluindo visualização, clonagem e contribuição para o código.

Para obter mais informações sobre permissões e acesso, consulte Permissões padrão de repositório Git e ramificações e Sobre níveis de acesso.

Obtenha o seu código

Você pode clonar um repositório Git remoto para criar uma cópia local dele. A clonagem cria uma cópia do código-fonte para você trabalhar e informações de controle de versão para que o Git possa gerenciar o código-fonte.

Se preferir criar um repositório local sem clonagem, consulte Criar um novo repositório Git. Depois de criar seu repositório local, você pode continuar a confirmar, compartilhar e sincronizar seu trabalho.

Visual Studio 2022

O Visual Studio 2022 fornece uma experiência de controle de versão do Git usando o menu Git, Alterações do Git e por meio de menus de contexto no Gerenciador de Soluções. O Visual Studio 2019 versão 16.8 também oferece a interface de usuário do Team Explorer Git. Para obter mais informações, consulte a guia Visual Studio 2019 - Team Explorer .

1. No menu Git na barra de menus, escolha Clone Repository...

   

2. Na janela Clonar um repositório, insira o local de repositório remoto e o caminho da pasta para o repositório clonado. Se você não souber o local de repositório remoto, selecione Azure DevOps em Procurar opções de repositório .

   

3. Selecione Clonar. Depois de clonar um repositório Git, o Visual Studio deteta o repositório e o adiciona à sua lista de repositórios locais no menu Git.

   

Nota

Com os Serviços de DevOps do Azure, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, o formato anterior que faz referência ao visualstudio.com formato ainda é suportado. Para obter mais informações, consulte Apresentando o Azure DevOps, Alternar organizações existentes para usar a nova URL de nome de domínio.

Visual Studio 2019 - Menu Git

O Visual Studio 2019 fornece uma experiência de controle de versão do Git usando o menu Git, Alterações do Git e por meio de menus de contexto no Gerenciador de Soluções.

1. No menu Git na barra de menus, escolha Clone Repository...

   

2. Na janela Clonar um repositório, insira o local de repositório remoto e o caminho da pasta para o repositório clonado. Se você não souber o local de repositório remoto, selecione Azure DevOps em Procurar opções de repositório .

   

3. Selecione Clonar. Depois de clonar um repositório Git, o Visual Studio deteta o repositório e o adiciona à sua lista de repositórios locais no menu Git.

   

Nota

Com os Serviços de DevOps do Azure, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, o formato anterior que faz referência ao visualstudio.com formato ainda é suportado. Para obter mais informações, consulte Apresentando o Azure DevOps, Alternar organizações existentes para usar a nova URL de nome de domínio.

Visual Studio 2019 - Explorador de Equipa

O Visual Studio 2019 versão 16.8 e versões posteriores fornece uma experiência de controle de versão do Git enquanto mantém a interface do usuário do Team Explorer Git. Você pode exercitar os recursos do Git a partir de qualquer interface de forma intercambiável.

Nota

Uma vantagem de se conectar a um projeto através do Team Explorer é que você ganha acesso ao hub Itens de Trabalho. Para obter uma visão geral dos recursos do Team Explorer , consulte Navegar no Visual Studio Team Explorer.

1. No Team Explorer, selecione Conectar para abrir a página Conectar e escolha Gerenciar Conexões>Conectar ao Projeto.

   

2. Na janela Conectar a um projeto, escolha o repositório que deseja clonar e selecione Clonar. Se você não vir seu repositório, selecione Adicionar Servidor de DevOps do Azure para adicionar um servidor que hospede um repositório. Você pode filtrar a lista para encontrar seu repo.

   

3. Verifique o local do repositório clonado no computador e selecione Clonar.

Nota

Com os Serviços de DevOps do Azure, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, o formato anterior que faz referência ao visualstudio.com formato ainda é suportado. Para obter mais informações, consulte Apresentando o Azure DevOps, Alternar organizações existentes para usar a nova URL de nome de domínio.

Linha de comando Git

1. Baixe e instale o Git e o Git Credential Manager para sua plataforma.

2. Abra o portal Web dos Serviços de DevOps do Azure no seu browser acedendo a https://<your account name>.visualstudio.com.

3. Abra o portal da Web dos Serviços de DevOps do Azure em seu navegador navegando e https://<your account name>.visualstudio.com localizando seu repositório Git. Copie o URL do clone do pop-up Clone .

   

   Nota

   Com os Serviços de DevOps do Azure, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, o formato anterior que faz referência ao visualstudio.com formato ainda é suportado. Para obter mais informações, consulte Apresentando o Azure DevOps, Alternar organizações existentes para usar a nova URL de nome de domínio.

4. No prompt de comando, vá para a pasta onde deseja que o código seja armazenado no computador local.

5. No prompt de comando, execute git clone seguido pela URL de clone, conforme mostrado no exemplo a seguir.

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   O Git baixa e cria sua própria cópia do código em uma nova pasta para você.

Comprometa o seu trabalho

As ramificações do Git isolam suas alterações de outros trabalhos no projeto. O fluxo de trabalho Git recomendado é usar uma nova ramificação para cada recurso ou correção em que você trabalha. Você faz confirmações em seu repositório Git local para salvar suas alterações nessa ramificação.

Visual Studio 2022

1. No menu Git na barra de menus, escolha Nova ramificação... para abrir a janela Criar uma nova ramificação.

   

2. Na janela Criar uma nova ramificação, insira um nome de ramificação descritivo para que outras pessoas saibam qual trabalho a ramificação contém. Por padrão, o Visual Studio cria sua nova ramificação a partir da ramificação atual. A caixa de seleção Checkout branch alterna automaticamente você para a ramificação recém-criada. Selecione Criar.

   

3. Adicione um arquivo README.md ao seu repositório clonado. No Gerenciador de Soluções, você pode procurar o conteúdo do repositório usando o Modo de Exibição de Pasta ou abrir soluções do Visual Studio no repositório. O Git controla as alterações feitas dentro e fora do Visual Studio.

4. Quando estiver satisfeito com suas alterações, salve-as no Git usando uma confirmação. Na janela Alterações do Git, insira uma mensagem que descreva as alterações e selecione Confirmar tudo. Confirmar tudo confirma alterações não organizadas e ignora a área de preparação. Você pode optar por preparar todos os arquivos antes de confirmar selecionando o botão stage all + (plus) na parte superior da seção Changes na janela Git Changes .

   

   Selecione o link de informações de confirmação para obter mais detalhes sobre a confirmação.

   

Nota

Se você tiver vários arquivos e não quiser confirmá-los todos, clique com o botão direito do mouse em cada arquivo e escolha Palco. Quando tiver preparado todos os arquivos que deseja confirmar, selecione Confirmar em etapas. Confirmar em etapas substitui Confirmar tudo quando você prepara manualmente as alterações.

Visual Studio 2019 - Menu Git

1. No menu Git na barra de menus, escolha Nova ramificação... para abrir a janela Criar uma nova ramificação.

   

2. Na janela Criar uma nova ramificação, insira um nome de ramificação descritivo para que outras pessoas saibam qual trabalho a ramificação contém. Por padrão, o Visual Studio cria sua nova ramificação a partir da ramificação atual. A caixa de seleção Checkout branch alterna automaticamente você para a ramificação recém-criada. Selecione Criar.

   

3. Adicione um arquivo README.md ao seu repositório clonado. No Gerenciador de Soluções, você pode procurar o conteúdo do repositório usando o Modo de Exibição de Pasta ou abrir soluções do Visual Studio no repositório. O Git controla as alterações feitas dentro e fora do Visual Studio.

4. Quando estiver satisfeito com suas alterações, salve-as no Git usando uma confirmação. Na janela Alterações do Git, insira uma mensagem que descreva as alterações e selecione Confirmar tudo. Confirmar tudo confirma alterações não organizadas e ignora a área de preparação. Você pode optar por preparar todos os arquivos antes de confirmar selecionando o botão stage all + (plus) na parte superior da seção Changes na janela Git Changes .

   

   Selecione o link de informações de confirmação para obter mais detalhes sobre a confirmação.

   

Nota

Se você tiver vários arquivos e não quiser confirmá-los todos, clique com o botão direito do mouse em cada arquivo e escolha Palco. Quando tiver preparado todos os arquivos que deseja confirmar, selecione Confirmar em etapas. Confirmar em etapas substitui Confirmar tudo quando você prepara manualmente as alterações.

Visual Studio 2019 - Explorador de Equipa

1. No Team Explorer, selecione o botão Início e escolha Ramos.

   

2. Clique com o botão direito do mouse na ramificação padrão, geralmente chamada mainde e, em seguida, escolha Nova ramificação local de...

   

3. Insira um nome de ramificação descritivo para que outras pessoas saibam qual trabalho a ramificação contém. Selecione Criar ramificação.

   

4. Adicione um arquivo README.md ao seu repositório clonado. No modo de exibição Início do Team Explorer, você pode navegar pelo conteúdo do repositório usando Mostrar Modo de Exibição de Pasta ou abrir soluções do Visual Studio no repositório. O Git controla as alterações feitas dentro e fora do Visual Studio.

5. Quando estiver satisfeito com suas alterações, salve-as no Git usando uma confirmação. Abra o modo de exibição Alterações do Team Explorer selecionando o botão Página Inicial e escolhendo Alterações.

   

6. Insira uma mensagem que descreva a confirmação e selecione Confirmar tudo.

   

Nota

Se você tiver vários arquivos e não quiser confirmá-los todos, clique com o botão direito do mouse em cada arquivo e escolha Palco. Quando tiver preparado todos os arquivos que deseja confirmar, selecione Confirmar em etapas. Confirmar em etapas substitui Confirmar tudo quando você prepara manualmente as alterações.

Linha de comando Git

1. Crie uma ramificação onde você faça suas alterações no código. Se você estiver colaborando com alguém usando uma ramificação que ela criou, pule para a etapa a seguir git checkout .

    > git branch ReadMeFix
   

   Escolha um nome de ramo descritivo para o seu trabalho para lembrar você e outras pessoas que tipo de trabalho é no ramo.

2. Confira sua filial para que você possa começar a trabalhar nela.

    > git checkout ReadMeFix
   

   Você também pode usar o comando para começar a checkout trabalhar em uma ramificação na qual outros membros da equipe já estão trabalhando.

3. Faça alterações usando suas ferramentas favoritas no código.

4. Quando estiver satisfeito com as alterações, mesmo que não esteja pronto para compartilhar o trabalho, salve-as no Git usando uma confirmação. Suas alterações não serão compartilhadas até que você as envie, conforme descrito na seção a seguir.

    > git commit -a -m "Descriptive message"
   

   Este comando salva suas alterações localmente em uma nova confirmação no Git. Certifique-se de dar à confirmação uma mensagem curta que descreva suas alterações após -m.

Partilhe as suas alterações

Depois de adicionar uma ou mais confirmações a uma ramificação e estiver pronto para compartilhar essas alterações com outras pessoas, envie suas confirmações para que outras pessoas possam vê-las.

Depois de enviar suas confirmações, você pode criar uma solicitação pull. Uma solicitação pull permite que outras pessoas saibam que você gostaria que suas alterações fossem revisadas. Após a aprovação, uma solicitação pull normalmente adiciona suas alterações à ramificação padrão do repositório remoto.

Visual Studio 2022

1. Na janela Alterações do Git, selecione o botão de seta para cima para pressionar sua confirmação.

   

   Ou, você pode enviar suas alterações por push a partir da janela Repositório Git. Para abrir a janela Repositório Git, selecione o link de entrada/saída na janela Alterações do Git.

   

   Ou, você pode enviar suas alterações a partir do menu Git na barra de menus.

   

2. Crie uma solicitação pull para que outras pessoas possam revisar suas alterações. Se você acabou de enviar suas alterações da janela Alterações do Git, pode selecionar o link Criar uma solicitação pull para abrir um navegador da Web onde você pode criar uma nova solicitação pull no portal da Web do Azure Repos.

   

   Ou, se você acabou de enviar suas alterações da janela Repositório Git, você pode selecionar o link Criar uma solicitação pull na parte superior dessa janela.

   

   Ou, você pode clicar com o botão direito do mouse em qualquer ramificação na janela Repositório Git e selecionar Criar solicitação pull.

   

Quando a solicitação pull for aberta no portal da Web do Azure Repos, verifique suas ramificações de origem e destino. Neste exemplo, queremos mesclar confirmações da add-readme-file ramificação para a main ramificação. Insira um título e uma descrição opcional, especifique quaisquer revisores, associe opcionalmente quaisquer itens de trabalho e selecione Criar.

Para obter mais informações sobre solicitações pull, consulte o tutorial Pull request .

Visual Studio 2019 - Menu Git

1. Na janela Alterações do Git, selecione o botão de seta para cima para pressionar sua confirmação.

   

   Ou, você pode enviar suas alterações por push a partir da janela Repositório Git. Para abrir a janela Repositório Git, selecione o link de entrada/saída na janela Alterações do Git.

   

   Ou, você pode enviar suas alterações a partir do menu Git na barra de menus.

   

2. Crie uma solicitação pull para que outras pessoas possam revisar suas alterações. Se você acabou de enviar suas alterações da janela Alterações do Git, pode selecionar o link Criar uma solicitação pull para abrir um navegador da Web onde você pode criar uma nova solicitação pull no portal da Web do Azure Repos.

   

   Ou, se você acabou de enviar suas alterações da janela Repositório Git, você pode selecionar o link Criar uma solicitação pull na parte superior dessa janela.

   

   Ou, você pode clicar com o botão direito do mouse em qualquer ramificação na janela Repositório Git e selecionar Criar solicitação pull.

   

Quando a solicitação pull for aberta no portal da Web do Azure Repos, verifique suas ramificações de origem e destino. Neste exemplo, queremos mesclar confirmações da add-readme-file ramificação para a main ramificação. Insira um título e uma descrição opcional, especifique quaisquer revisores, associe opcionalmente quaisquer itens de trabalho e selecione Criar.

Para obter mais informações sobre solicitações pull, consulte o tutorial Pull request .

Visual Studio 2019 - Explorador de Equipa

1. No Team Explorer, selecione Início e, em seguida, escolha Sincronizar para abrir a Sincronização.

   

   Você também pode ir para o modo de exibição Sincronização em Alterações escolhendo Sincronizar imediatamente após fazer uma confirmação.

   

2. Na visualização Sincronização, escolha Enviar por push para carregar sua confirmação para o repositório remoto. Se este for seu primeiro push para o repositório, você verá a mensagem: The current branch does not track a remote branch..., que informa que sua confirmação foi enviada por push para uma nova ramificação no repositório remoto e que futuras confirmações enviadas da ramificação atual serão carregadas para essa ramificação remota.

   

3. Crie uma solicitação pull para que outras pessoas possam revisar suas alterações. Abra Pull Requests no Team Explorer selecionando Home e escolhendo Pull Requests.

   

4. Em Pull Requests, você pode visualizar pull requests abertos por você, atribuídos a você, e você pode criar novas pull requests. Selecione Nova solicitação pull para abrir um navegador da Web onde você pode criar uma nova solicitação pull no portal da Web do Azure Repos.

   

Quando a solicitação pull for aberta no portal da Web do Azure Repos, verifique suas ramificações de origem e destino. Neste exemplo, queremos mesclar confirmações da add-readme-file ramificação para a main ramificação. Insira um título e uma descrição opcional, especifique quaisquer revisores, associe opcionalmente quaisquer itens de trabalho e selecione Criar.

Para obter mais informações sobre solicitações pull, consulte o tutorial Pull request .

Linha de comando Git

1. Empurre sua ramificação para que outras pessoas possam ver as alterações que você salvou.

    > git push -u origin ReadMeFix
   

2. Abra o projeto no portal da Web e navegue até o repositório na guia Código . Selecione Criar uma solicitação pull para criar uma solicitação pull para a ramificação que você enviou.

   

3. Verifique suas filiais. Neste exemplo, queremos mesclar as confirmações da ReadMeFix ramificação para a main ramificação. Insira um título e uma descrição opcional, especifique quaisquer revisores, associe opcionalmente quaisquer itens de trabalho e selecione Criar.

   

4. Assim que as alterações forem aprovadas, conclua o pull request. Uma solicitação pull completa adiciona suas alterações da ramificação para a ramificação principal do código.

   Para obter mais informações sobre solicitações pull, consulte o tutorial pull request .

Sincronizar com outras pessoas

Você pode manter suas filiais locais sincronizadas com suas contrapartes remotas puxando confirmações criadas por outras pessoas. Embora o Git seja bom em mesclar alterações de entrada com suas alterações, às vezes você pode ter que resolver um conflito de mesclagem. Enquanto você estiver trabalhando em sua ramificação de recurso, é uma boa ideia alternar periodicamente para sua main ramificação e extrair novas confirmações para mantê-la atualizada com a ramificação remota main .

Visual Studio 2022

Na janela Alterações do Git, você pode manter sua filial local atualizada com sua contraparte remota usando os botões Buscar, Puxar, Pressionar e Sincronizar.

Da esquerda para a direita na captura de tela anterior, os controles de botão são:

• Buscar confirmações remotas de downloads que não estão em sua filial local, mas não as mescla.
• Pull executa uma busca e, em seguida, mescla as confirmações baixadas em sua ramificação local.
• O Push carrega suas confirmações não enviadas por push para o repositório remoto, que as adiciona à ramificação remota correspondente.
• A sincronização executa um Pull e, em seguida, um Push.

Você também pode selecionar Fetch, Pull, Push e Sync no menu Git.

Visual Studio 2019 - Menu Git

Na janela Alterações do Git, você pode manter sua filial local atualizada com sua contraparte remota usando os botões Buscar, Puxar, Pressionar e Sincronizar.

Da esquerda para a direita na captura de tela anterior, os controles de botão são:

• Buscar confirmações remotas de downloads que não estão em sua filial local, mas não as mescla.
• Pull executa uma busca e, em seguida, mescla as confirmações baixadas em sua ramificação local.
• O Push carrega suas confirmações não enviadas por push para o repositório remoto, que as adiciona à ramificação remota correspondente.
• A sincronização executa um Pull e, em seguida, um Push.

Você também pode selecionar Fetch, Pull, Push e Sync no menu Git.

Visual Studio 2019 - Explorador de Equipa

1. No Team Explorer, selecione Início e escolha Sincronizar para abrir a Sincronização.

   

2. Você pode baixar as alterações mais recentes em sua filial usando o link Pull . Há dois links Pull , um perto da parte superior e outro na seção Incoming Commits (Confirmações de entrada). Você pode usar qualquer um deles porque ambos fazem a mesma coisa.

   

Linha de comando Git

1. Mude para a ramificação onde pretende transferir as alterações que outras pessoas fizeram.

    > git checkout ReadMeFix
   

   Neste exemplo, você extrai as alterações feitas por outras pessoas em sua equipe para a ramificação para sua ReadMeFix cópia local da ramificação.

2. Puxe as alterações feitas por outras pessoas para a sua filial local.

    > git pull
   

   O Git baixa as alterações e as mescla com suas próprias alterações em sua filial local.

Artigos relacionados

• Perguntas frequentes sobre o Git
• Experiência do Git no Visual Studio
• Comparação lado a lado do Git e do Team Explorer