Compartilhar seu código usando 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

Categoria	Requisitos
Acesso ao projeto	Membro do projeto.
Ferramenta de linha de comando do Git	Uma das seguintes ferramentas de linha de comando do Git: - Git para Windows e Git Credential Manager. - Git para macOS ou Linux. Para macOS e Linux, recomendamos que você configure a autenticação SSH.

1. Clonar o repositório em seu computador

Para trabalhar com um repositório Git, clone-o no computador. Essa ação 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 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 todos os commits e branches do repositório em uma nova pasta com a qual você irá 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

Os branches do Git isolam suas alterações de outros trabalhos no projeto. Use o fluxo de trabalho git, que usa um novo branch para cada recurso ou correção em que você trabalha. Para os exemplos neste artigo, o branch users/jamal/feature1 é usado.

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 você verificou o branch certo (git checkout main) e se ele está atualizado (git pull origin main) antes de criar seu novo branch.

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

   Ao criar uma ramificação a partir da linha de comando, você baseia a nova ramificação na ramificação atualmente verificada. Ao clonar o repositório, você faz check-out do branch padrão (normalmente main). Como você clonou, sua cópia local de 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, você faz uma alteração nos arquivos no computador, confirma as alterações localmente e, em seguida, envia a confirmação para o repositório armazenado no servidor.

1. Navegue até a pasta no computador em que você clonou o repositório. Abra o README.md arquivo em seu editor de escolha e faça algumas alterações. Em seguida, Salve e feche o arquivo.

2. Na janela de comando do Git, vá até o diretório fabrikam-web digitando o seguinte comando:

   cd fabrikam-web
   

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
   

Você compartilhou seu código no repositório remoto, em um branch chamado 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. Depois de terminar de corrigir um bug ou adicionar 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

Configurar integração & entregas contínuas

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