Compartilhar via


Introdução ao Git no Azure Repos

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

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

Observação

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 do GitHub, obtenha a URL conforme descrito em Clonar um repositório.

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

Observação

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu do Git para gerenciar o fluxo de trabalho do Git com menos comutação de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio fornecem informações sobre como 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 estar habilitados nas configurações do projeto do Azure DevOps. Se o hub do Repositório e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço do Azure DevOps para reabilitar o Repositório.

  • Para exibir o 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 exibir o código.

  • Para clonar ou contribuir com o código para 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?

    Observação

    Para projetos públicos, os usuários que receberam acesso de Stakeholder têm acesso total ao Azure Repos.

  • Os repositórios devem estar habilitados nas configurações do projeto do Azure DevOps. Se o hub do Repositório e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço do Azure DevOps para reabilitar o Repositório.

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

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

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

Obter o código

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

Se você preferir criar um repositório local sem clonar, consulte Criar um novo Repositório do 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, as Alterações do Git e através dos menus de contexto no Gerenciador de Soluções. O Visual Studio 2019, versão 16.8, também oferece a interface do usuário do Git do Team Explorer. Para obter mais informações, consulte a guia Visual Studio 2019 – Team Explorer.

  1. No menu Git na barra de menus, escolha Clonar Repositório...

    Captura de tela da opção ‘Clonar Repositório’ no menu Git no Visual Studio.

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

    Captura de tela da janela ‘Clonar um Repositório’ no Visual Studio.

  3. Selecione Clonar. Depois de clonar um Repositório do Git, o Visual Studio detecta 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.

Observação

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

Confirmar seu trabalho

Os branches do Git isolam suas alterações de outros trabalhos no projeto. O fluxo de trabalho do Git recomendado usa um novo branch para cada recurso ou correção trabalhada por você. Você faz commits no Repositório do Git local para salvar as alterações nesse branch.

  1. No menu Git na barra de menus, escolha Novo Branch para abrir a janela Criar um novo branch.

    Captura de tela da opção ‘Novo Branch’ no menu Git no Visual Studio.

  2. Na janela Criar um novo branch, insira um nome de branch descritivo para que outras pessoas saibam qual trabalho o branch contém. Por padrão, o Visual Studio cria seu novo branch do branch atual. A caixa de seleção Finalizar branch alterna automaticamente para o branch recém-criado. Selecione Criar.

    Captura de tela da janela

  3. Adicione um arquivo README.md ao repositório clonado. Em 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 acompanha as alterações feitas dentro e fora do Visual Studio.

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

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

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

Observação

Se você tiver vários arquivos e não quiser confirmar todos eles, clique com o botão direito do mouse em cada arquivo e escolha Preparar. Quando você tiver preparado todos os arquivos que deseja confirmar, selecione Commit Staged. Commit Staged substitui Confirmar Tudo quando você prepara manualmente suas alterações.

Captura de tela da opção Preparar na janela 'Alterações do Git' no Visual Studio 2019.

Compartilhar suas alterações

Depois de adicionar um ou mais commits a um branch e estiver pronto para compartilhar essas alterações com outras pessoas, envie seus commits por push para que outras pessoas possam vê-los.

Depois de enviar seus commits por push, você pode criar uma solicitação de pull. Uma solicitação de pull permite que outras pessoas saibam que você gostaria de examinar suas alterações. Após a aprovação, uma solicitação de pull normalmente adiciona suas alterações ao branch padrão do repositório remoto.

  1. Na janela Alterações do Git , selecione o botão de push de seta para cima para efetuar push do commit.

    Captura de tela do botão de push de seta para cima na janela 'Alterações do Git' do Visual Studio.

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

    Captura de tela do link 'saída/entrada' na janela 'Alterações do Git' e o link de push na janela 'Repositório do Git' do Visual Studio.

    Ou você pode efetuar push das alterações no menu Git na barra de menus.

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

  2. Crie uma solicitação de pull para que outras pessoas possam examinar suas alterações. Se você tiver acabado de efetuar push das alterações na janela Alterações do Git, poderá selecionar o link Criar uma Solicitação de Pull para abrir um navegador da Web no qual você pode criar uma nova solicitação de pull no portal da Web do Azure Repos.

    Captura de tela do botão 'Criar uma solicitação de pull' na janela 'Alterações do Git' no Visual Studio.

    Ou, se você tiver acabado de efetuar push das alterações na janela Repositório do Git , poderá selecionar o link Criar uma Solicitação de Pull na parte superior dessa janela.

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

    Ou você pode clicar com o botão direito do mouse em qualquer branch na janela Repositório do Git e selecionar Criar Solicitação de Pull.

    Captura de tela da opção de menu 'Criar uma Solicitação de Pull' no menu de atalho do branch na janela 'Repositório do Git' no Visual Studio.

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

Captura de tela do formulário 'Nova Solicitação de Pull' no portal da Web do Azure Repos.

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

Sincronizar com outras pessoas

Você pode manter seus branches locais sincronizados com seus equivalentes remotos efetuando pull de commits criados por outras pessoas. Embora o Git seja bom em mesclar alterações de entrada com suas alterações, às vezes, talvez seja necessário resolver um conflito de mesclagem. Enquanto você estiver trabalhando em seu branch de recurso, é uma boa ideia alternar periodicamente para o main branch e efetuar pull de novos commits para mantê-lo atualizado com o branch remotomain.

Na janela Alterações do Git , você pode manter seu branch local atualizado com seu equivalente remoto usando os botões Buscar, Pull, Push e Sincronizar.

Captura de tela dos botões Buscar, Pull, Push e Sincronizar na janela 'Alterações do Git' do Visual Studio.

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

  • Buscar baixa commits remotos que não estão no branch local, mas não os mescla.
  • Pull executa uma busca e mescla os commits baixados no branch local.
  • Push carrega seus commits não efetuados por push para o repositório remoto, que os adiciona ao branch remoto correspondente.
  • Sincronizar executa um Pull e, em seguida, um Push.

Você também pode selecionar Buscar, Pull, Push, e Sincronizar no menu Git.

Captura de tela dos botões Buscar, Pull, Push e Sincronizar nas opções no menu Git do Visual Studio.