Introdução ao Git no Azure Repos

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

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 versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações para usar a experiência do Git, bem como o Team Explorer. Para obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

Pré-requisitos

  • Os repositórios devem ser habilitados em suas configurações de projeto do Azure DevOps. Se o hub Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de DevOps do Azure para reativar Repos.

  • Para exibir código em projetos privados, você deve ser membro de um projeto do Azure DevOps com nível de acesso Básico ou superior. Para projetos públicos, todos podem visualizar o código.

  • Para clonar ou contribuir com o código de um projeto privado, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes definidas. Para projetos públicos, qualquer pessoa pode clonar e contribuir com código. Para obter mais informações, consulte O que é um projeto público?

    Nota

    Para projetos públicos, os usuários com acesso de Partes Interessadas têm acesso total aos Repositórios do Azure.

  • Os repositórios devem ser habilitados em suas configurações de projeto do Azure DevOps. Se o hub Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de DevOps do Azure para reativar Repos.

  • Para exibir o código, você deve ser membro do projeto DevOps do Azure com acesso Básico ou superior. Se você não for um membro do projeto, seja adicionado.

  • Para clonar ou contribuir para o código, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes no projeto que deseja alterar.

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.

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

    Captura de tela da opção 'Clone Repository' no menu Git no Visual Studio.

  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 .

    Captura de tela da janela 'Clone Repository' no Visual Studio.

  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.

    Captura de tela da opção 'Repositórios locais' no menu Git no Visual Studio.

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.

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.

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

    Captura de tela da opção 'Nova ramificação' no menu Git no Visual Studio.

  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.

    Captura de tela da janela 'Criar uma nova ramificação' no Visual Studio.

  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 .

    Captura de tela do botão 'Confirmar tudo' na janela 'Alterações do Git' no Visual Studio.

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

    Captura de tela mostrando o link de informações de confirmação no Visual Studio.

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.

Captura de tela da opção Palco na janela 'Git Changes' no Visual Studio 2019.

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.

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

    Captura de tela do botão de seta para cima na janela 'Git Changes' do Visual Studio.

    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.

    Captura de tela do link 'saída/entrada' na janela 'Git Changes' e o link Push na janela 'Git Repository' do Visual Studio.

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

    Captura de tela da opção Push no menu Git no Visual Studio.

  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.

    Captura de tela do link 'Criar uma solicitação pull' na janela 'Git Changes' no Visual Studio.

    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.

    Captura de tela do link 'Criar uma solicitação pull' na janela 'Repositório Git' no Visual Studio.

    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.

    Captura de tela da opção de menu 'Criar uma solicitação pull' no menu de contexto da ramificação na janela 'Repositório Git' no Visual Studio.

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.

Captura de ecrã do formulário 'Novo pedido pull' no portal Web do Azure Repos.

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 .

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.

Captura de tela dos botões Buscar, Puxar, Pressionar e Sincronizar na janela 'Git Changes' do Visual Studio.

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.

Captura de tela das opções Buscar, Puxar, Empurrar e Sincronizar no menu Git no Visual Studio.