Compartilhar seu código com o Git

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Compartilhe seu código com outras pessoas no Azure DevOps ao usar um repositório Git.

Pré-requisitos

1. Clonar o repositório em seu computador

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

1. Conclua a etapa a seguir que se aplica 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, em seguida, 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 da equipe de sua organização e selecione Repositórios>Arquivos.

   

3. Selecione Clonar.

   

4. Copie a URL.

   

5. Abra a janela de comando do Git (Git Bash no Git para Windows). Vá para a pasta onde deseja que o código do repositório seja armazenado em seu computador e execute git clone, seguido pelo caminho copiado de Clonar URL 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.

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

   cd fabrikam-web
   

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

2. Trabalhar em um ramo

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 a ramificação, users/jamal/feature1.

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

   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 principal para que o Git possa manter um histórico de alterações à medida que você adiciona confirmações na 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 sua nova ramificação.

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

   git checkout users/jamal/feature1
   

   O Git altera os arquivos em seu computador para que correspondam para a confirmação mais recente na ramificação que fez check-out.

   Dica

   Quando você cria uma ramificação a partir da linha de comando, a ramificação é baseada na ramificação que fez check-out no momento. Quando você clona o repositório, a ramificação padrão (normalmente main) é verificada. 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 main mais recente.

   git pull origin main:users/jamal/feature1
   

   Volte para a janela do Git Bash que você usou na seção anterior. Execute os seguintes comandos 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
   

3. Trabalhar 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 em seu computador onde você clonou o repositório, abra o arquivo README.md em seu editor favorito e realize as alterações. Em seguida, Salve e feche o arquivo.

2. Na janela de comando do Git, vá até o diretório contoso-demo 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 comando git add . 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 não confirmar as 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 ramificação main, use uma solicitação de pull.

4. Mesclar suas alterações com uma solicitação de pull

As solicitações de pull combinam a revisão e a mesclagem do código em um único processo de colaboração. Quando terminar de corrigir um bug ou um novo recurso em uma ramificação, crie uma nova solicitação de pull. Adicione os membros da equipe à solicitação de pull para que eles possam revisar e votar nas 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 de pull a qualquer momento.

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

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

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

   

   Novas solicitações de 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 de pull.

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

   

3. Selecione Criar.

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

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

   

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

   

   Observação

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

Suas alterações agora são mescladas na ramificação main e sua ramificação users/jamal/feature1 é 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 LEIAME para exibir suas alterações.

   

Limpeza

Para excluir sua cópia local da ramificação, volte para o prompt de comando do Git Bash e execute o seguinte comando:

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

Essa ação conclui as seguintes tarefas:

• O comando git checkout main alterna para a ramificação main.
• O comando git pull origin main efetua pull da 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 comando git branch -d users/jamal/feature1 exclui sua cópia local dessa ramificação.

Próximas etapas

Conteúdo relacionado

• Entender os principais conceitos para novos usuários do Azure Pipelines
• Descobrir o que é o Azure Repos
• Saiba como trabalhar com um repositório Git
• Explorar o que é o controle de origem