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 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.
Se não tiver um projeto, crie um ou inscreva-se gratuitamente.
Se você não for um membro do projeto, seja adicionado.
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.
- Visual Studio 2022
- Visual Studio 2019 - Menu Git
- Visual Studio 2019 - Explorador de Equipa
- Linha de comando Git
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 .
No menu Git na barra de menus, escolha Clone Repository...
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 .
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.
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.
- Visual Studio 2022
- Visual Studio 2019 - Menu Git
- Visual Studio 2019 - Explorador de Equipa
- Linha de comando Git
No menu Git na barra de menus, escolha Nova ramificação... para abrir a janela Criar uma nova ramificação.
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.
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.
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 .
Selecione o link de informações de confirmação para obter mais detalhes sobre a confirmação.
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.
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.
- Visual Studio 2022
- Visual Studio 2019 - Menu Git
- Visual Studio 2019 - Explorador de Equipa
- Linha de comando Git
Na janela Alterações do Git, selecione o botão de seta para cima para pressionar sua confirmação.
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.
Ou, você pode enviar suas alterações a partir do menu Git na barra de menus.
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.
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.
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.
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.
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
.
- Visual Studio 2022
- Visual Studio 2019 - Menu Git
- Visual Studio 2019 - Explorador de Equipa
- Linha de comando Git
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.
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.