Compartilhe seu código com o Git

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

Compartilhe seu código com outras pessoas no Azure DevOps quando você usa um repositório Git.

Pré-requisitos

Você deve ter uma organização e um projeto no Azure DevOps. Quando você cria um projeto, o Azure DevOps cria automaticamente um repositório vazio em Repos.

1. Instale as ferramentas de linha de comando do Git

Instale uma das seguintes ferramentas de linha de comando do Git:

• Git para Windows e Git Credential Manager.
• Para instalar no macOS ou Linux, confira o capítulo Instalando o Git no livro de código aberto Pro Git . Para macOS e Linux, recomendamos que você configure a autenticação SSH.

2. Clone o repositório para o seu computador

Para trabalhar com um repositório Git, clone-o para o computador, o que cria uma cópia local completa do repositório. Seu código pode estar em um dos vários lugares.

1. Conclua a etapa a seguir aplicável ao seu cenário:

   • Se você ainda não tiver nenhum código, primeiro crie um novo repositório Git em seu projeto e, em seguida, conclua a próxima etapa.
   • Se o código estiver em outro repositório Git, como um repositório GitHub ou uma instância diferente do Azure Repo, importe-o para um repositório Git vazio novo ou existente e conclua a próxima etapa.
   • Se o código estiver no computador local e ainda não estiver no controle de versão, crie um novo repositório Git em seu projeto ou adicione seu código a um repositório existente.

2. No navegador da Web, abra o projeto de equipe da sua organização e selecione Arquivos de>repositório.

   

3. Selecione Clonar no canto superior direito da janela Código e copie a URL.

   

4. Abra a janela de comando do Git (Git Bash no Git para Windows). Vá para a pasta onde você deseja que o código do repositório seja armazenado em seu computador e execute git clone, seguido pelo caminho copiado da URL de clonagem na etapa anterior. Consulte o seguinte exemplo:

   git clone https://FabrikamFiber01@dev.azure.com/FabrikamFiber01/FabrikamFiber01-01/_git/FabrikamFiber01-01
   

   O Git baixa uma cópia do código, incluindo todas as confirmações e ramificações do repositório, em uma nova pasta para você trabalhar.

5. Alterne o diretório para o repositório clonado.

   cd fabrikam-web
   

   Mantenha esta janela de comando aberta para trabalhar em uma ramificação.

3. Trabalhe em uma filial

As ramificações do Git isolam suas alterações de outros trabalhos que estão sendo feitos no projeto. Recomendamos usar o fluxo de trabalho do Git, que usa uma nova ramificação para cada recurso ou correção em que você trabalha. Para nossos exemplos, usamos o ramo, users/jamal/feature1.

1. Crie uma ramificação com o branch comando.

   git branch users/jamal/feature1
   

   Esse comando cria uma referência no Git para a nova ramificação. Ele também cria um ponteiro de volta para a confirmação pai para que o Git possa manter um histórico de alterações à medida que você adiciona confirmações à ramificação.

   Se você estiver trabalhando com um repositório clonado anteriormente, verifique se fez check-out da ramificação correta (git checkout main) e se ela está atualizada (git pull origin main) antes de criar a nova ramificação.

2. Use checkout para alternar para essa ramificação.

   git checkout users/jamal/feature1
   

   O Git altera os arquivos no computador para corresponder à confirmação mais recente na ramificação com check-out.

   Dica

   Quando você cria uma ramificação a partir da linha de comando, a ramificação é baseada na ramificação com check-out no momento. Quando você clona o repositório, é feito check-out da ramificação padrão (normalmente main). Como você clonou, sua cópia local do main tem as alterações mais recentes.

   git checkout main
   git pull origin main
   git branch users/jamal/feature1
   git checkout users/jamal/feature1
   

   Você pode substituir os três primeiros comandos no exemplo anterior pelo comando a seguir, que cria uma nova ramificação nomeada users/jamal/feature1 com base na ramificação mais recente main .

   git pull origin main:users/jamal/feature1
   

   Volte para a janela do Git Bash que você usou na seção anterior. Execute os comandos a seguir para criar e fazer check-out de uma nova ramificação com base na ramificação principal.

   git pull origin main:users/jamal/feature1
   git checkout feature1
   

4. Trabalhe com o código

Nas etapas a seguir, fazemos uma alteração nos arquivos em seu computador, confirmamos as alterações localmente e, em seguida, enviamos a confirmação para o repositório armazenado no servidor.

1. Navegue até a pasta no computador onde você clonou o repositório, abra o README.md arquivo no editor de sua escolha e faça algumas alterações. Em seguida, salve e feche o arquivo.

2. Na janela de comando do Git, vá para o contoso-demo diretório digitando o seguinte comando:

   cd contoso-demo
   

3. Confirme suas alterações inserindo os seguintes comandos na janela de comando do Git:

   git add .
   git commit -m "My first commit"
   

   O git add . comando prepara todos os arquivos novos ou alterados e git commit -m cria uma confirmação com a mensagem de confirmação especificada.

   Verifique em qual ramificação você está trabalhando antes de confirmar, para que você não confirme alterações na ramificação errada. O Git sempre adiciona os novos commits ao branch local atual.

4. Envie suas alterações para o repositório Git no servidor. Digite o seguinte comando na janela de comando do Git:

   git push origin users/jamal/feature1
   

Seu código agora é compartilhado com o repositório remoto, em uma ramificação chamada users/jamal/feature1. Para mesclar o código da ramificação de trabalho na main ramificação, use uma solicitação pull.

5. Mescle suas alterações com uma solicitação pull

As solicitações de pull combinam a revisão e a mesclagem do código em um único processo de colaboração. Depois de terminar de corrigir um bug ou novo recurso em uma ramificação, crie uma nova solicitação pull. Adicione os membros da equipe à solicitação pull para que eles possam revisar e votar em suas alterações. Use solicitações de pull para examinar os trabalhos em andamento e obter comentários antecipados em relação às alterações. Não há compromisso de mesclar as alterações porque você pode abandonar a solicitação pull a qualquer momento.

O exemplo a seguir mostra as etapas básicas de criação e conclusão de uma solicitação pull.

1. Abra o projeto de equipe para sua organização no navegador da Web e selecione Arquivos de>repositório. Se você manteve seu navegador aberto depois de obter o URL do clone, você pode simplesmente voltar para ele.

2. Selecione Criar uma solicitação pull no canto superior direito da janela Arquivos . Se você não vir uma mensagem como Você atualizou usuários/jamal/feature1 agora, atualize seu navegador.

   

   Novas solicitações pull são configuradas para mesclar sua ramificação na ramificação padrão, que neste exemplo é main. O título e a descrição são pré-preenchidos com sua mensagem de confirmação.

   

   Você pode adicionar revisores e vincular itens de trabalho à sua solicitação pull.

   Você pode revisar os arquivos incluídos na solicitação pull na parte inferior da janela Nova solicitação pull .

   

3. Selecione Criar.

   Exiba os detalhes da sua solicitação pull na guia Visão geral . Você também pode exibir os arquivos alterados, atualizações e confirmações em sua solicitação pull a partir das outras guias.

4. Selecione Concluir para iniciar o processo de conclusão da solicitação pull.

   

5. Selecione Concluir mesclagem para concluir a solicitação pull e mesclar seu código na main ramificação.

   

   Observação

   Este exemplo mostra as etapas básicas de criação e conclusão de uma solicitação pull. Para obter mais informações, consulte Criar, exibir e gerenciar solicitações pull.

Suas alterações agora são mescladas na main ramificação e sua users/jamal/feature1 ramificação é excluída no repositório remoto.

Exibir histórico

1. Volte para o portal da Web e selecione Histórico na página Código para exibir sua nova confirmação.

   

2. Alterne para a guia Arquivos e selecione o arquivo LEIA-ME para exibir suas alterações.

   

Limpar

Volte para o prompt de comando do Git Bash e execute o seguinte comando para excluir sua cópia local da ramificação.

git checkout main
git pull origin main
git branch -d users/jamal/feature1

Esta ação conclui as seguintes tarefas:

• O git checkout main comando alterna você para a main ramificação.
• O git pull origin main comando puxa para baixo a versão mais recente do código na ramificação principal, incluindo suas alterações e o fato de que users/jamal/feature1 foi mesclado.
• O git branch -d users/jamal/feature1 comando exclui sua cópia local dessa ramificação.

Próximas etapas

Configurar a integração contínua e a entrega

Artigos relacionados

• Principais conceitos para novos usuários no Azure Pipelines
• O que é o Azure Repos?
• Saiba mais sobre como trabalhar com um repositório Git
• O que é controle do código-fonte?