Introdução com o Git no Azure Repos
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server | 2019 TFS 2018
Visual Studio 2022 | | Visual Studio 2019 Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013
Introdução com o desenvolvimento de seu código usando repositórios Azure Repos e Git. Você pode usar comandos Visual Studio ou Git para clonar um repositório, definir branches 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.
Observação
Este artigo descreve como usar Visual Studio para gerenciar Azure Repos repositórios Git. Usando procedimentos semelhantes, você pode usar Visual Studio para gerenciar GitHub repositórios. Para clonar um repositório GitHub, obtenha a URL conforme descrito na Clonagem de um repositório.
Para obter uma visão geral do fluxo de trabalho do Git, consulte Azure Repos tutorial do Git.
Observação
Visual Studio versão 16.8 de 2019 e versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio 2019 fornecem informações sobre como usar a experiência do Git, bem como o Team Explorer. Para saber mais, confira a comparação lado a lado do Git e do Team Explorer.
Pré-requisitos
Repos deve ser habilitado nas configurações do projeto Azure DevOps. Se o hub de Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de Azure DevOps para reencável Repos.
Para exibir o código em projetos privados, você deve ser membro de um projeto de Azure DevOps com nível de acesso básico ou superior. Para projetos públicos, todos podem exibir o código.
Se você não tiver um projeto, crie um ou inscreva-se gratuitamente.
Se você não for membro do projeto, será 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 o código. Para saber mais, confira o que é um projeto público?
Observação
Para projetos públicos, os usuários que receberam acesso ao Stakeholder têm acesso total a Azure Repos.
Repos deve ser habilitado nas configurações do projeto Azure DevOps. Se o hub de Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de Azure DevOps para reencável Repos.
Para exibir o código, você deve ser membro do projeto Azure DevOps com acesso básico ou superior. Se você não for 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 deseja alterar.
Para exibir o código, você deve ser membro de um projeto de Azure DevOps com acesso básico ou superior. Se você não for 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.
Para saber mais sobre permissões e acesso, consulte o repositório Git padrão e as permissões de branch e sobre os níveis de acesso.
Obter o 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 com 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 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 versão 16.8 de 2019 e versões posteriores fornece uma experiência de controle de versão do Git, mantendo a interface do usuário git do Team Explorer. Você pode exercitar os recursos do Git de qualquer interface intercambiável. Abaixo, fornecemos uma comparação lado a lado para clonar um repositório.
Observação
Uma vantagem de se conectar a um projeto por meio do Team Explorer é que você obtém acesso ao hub de Itens de Trabalho. Para obter uma visão geral dos recursos do Team Explorer, consulte Navegar no Visual Studio Team Explorer.
Visual Studio Git
- No menu Git na barra de menus, escolha Clonar Repositório...
- 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.
- Selecione Clonar. Depois de clonar um repositório Git, Visual Studio detectará o repositório e o adicionará à sua lista de Repositórios Locais no menu Git.
Team Explorer para Visual Studio
- No Team Explorer, selecione Conexão para abrir a página Conexão e escolha Gerenciar Conexões>Conexão para Project.
- No Conexão para uma janela Project, escolha o repositório que você deseja clonar e selecione Clonar. Se você não vir seu repositório, selecione Adicionar Azure DevOps Server para adicionar um servidor que hospeda um repositório. Você pode filtrar a lista para localizar seu repositório.
- Verifique o local do repositório clonado no computador e selecione Clonar.
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 formato anterior que faz referência ao visualstudio.com
formato. Para obter mais informações, consulte Introdução a 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 é usar um novo branch para cada recurso ou corrigir o trabalho. Você faz confirmações em seu repositório Git local para salvar suas alterações nesse branch.
Visual Studio Git
- No menu Git na barra de menus, escolha Novo Branch... para abrir a janela Criar uma nova ramificação .
- Na janela Criar uma nova ramificação , insira um nome de branch descritivo para que outras pessoas saibam qual trabalho o branch contém. Por padrão, Visual Studio cria seu novo branch do branch atual. A caixa de seleção do branch checkout alterna automaticamente você para o branch recém-criado. Selecione Criar.
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 de Visual Studio no repositório. O Git rastreia as alterações feitas dentro e fora de 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. Commit All confirma alterações não ofuscadas e ignora a área de preparo. Você pode optar por preparar todos os arquivos antes de se comprometer selecionando o botão todos + (mais) na parte superior da seção Alterações na janela Alterações do Git .
Selecione o link de informações de confirmação para obter mais detalhes sobre a confirmação.
Team Explorer para Visual Studio
- No Team Explorer, selecione o botão Página Inicial e escolha Branches.
- Clique com o botão direito do mouse no branch padrão, geralmente nomeado
main
, e escolha Novo Branch Local de...
- Insira um nome de branch descritivo para que outras pessoas saibam o trabalho que o branch contém. Selecione Criar Branch.
Adicione um arquivo README.md ao repositório clonado. No modo de exibição Home do Team Explorer, você pode procurar o conteúdo do repositório usando Mostrar Exibição de Pasta ou abrir Visual Studio soluções no repositório. O Git rastreia as alterações feitas dentro e fora de Visual Studio.
Quando estiver satisfeito com suas alterações, salve-as no Git usando uma confirmação. Abra o modo de exibição Alterações do Team Explorer selecionando o botão Página Inicial e escolhendo Alterações.
- Insira uma mensagem que descreva a confirmação e selecione Confirmar Tudo.
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 Estágio. Quando você tiver preparado todos os arquivos que deseja confirmar, selecione Commit Staged. Commit Staged substitui Commit All ao preparar manualmente suas alterações.
Compartilhar suas alterações
Depois de adicionar uma ou mais confirmações a um branch e você estiver pronto para compartilhar essas alterações com outras pessoas, envie suas confirmações por push para que outras pessoas possam vê-las.
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.
Visual Studio Git
- Na janela Alterações do Git , selecione o botão de push de seta para cima para pressionar sua confirmação.
Ou você pode efetuar push das alterações da janela do Repositório Git . Para abrir a janela repositório Git , selecione o link de saída/entrada na janela Alterações do Git .
Ou você pode enviar suas alterações por push do menu Git na barra de menus.
- Crie uma solicitação de pull para que outras pessoas possam examinar suas alterações. Se você acabou de enviar suas alterações por push da janela Alterações do Git, poderá selecionar o link Criar uma Solicitação de Pull para abrir um navegador da Web em que você pode criar uma nova solicitação de pull no portal da Web Azure Repos.
Ou, se você acabou de enviar suas alterações por push da janela do Repositório Git , poderá selecionar o link Criar uma Solicitação de Pull na parte superior dessa janela.
Ou, você pode clicar com o botão direito do mouse em qualquer branch na janela do Repositório Git e selecionar Criar Solicitação de Pull.
Team Explorer para Visual Studio
- No Team Explorer, selecione Página Inicial e escolha Sincronizar para abrir a Sincronização.
Você também pode ir para o modo de exibição sincronização de Alterações escolhendo Sincronizar imediatamente após fazer uma confirmação.
- No modo de exibição Sincronização , escolha Push para carregar sua confirmação no repositório remoto. Se este for o primeiro push para o repositório, você verá a mensagem:
The current branch does not track a remote branch...
, o que permite que você saiba que sua confirmação foi enviada por push para um novo branch no repositório remoto e que as confirmações futuras enviadas por push do branch atual serão carregadas para esse branch remoto.
- Crie uma solicitação de pull para que outras pessoas possam examinar suas alterações. Abra solicitações de pull no Team Explorer selecionando Página Inicial e escolhendo Solicitações de Pull.
- Em Solicitações de Pull, você pode exibir solicitações de pull abertas por você, atribuídas a você e pode criar novas solicitações de pull. Selecione Nova Solicitação de Pull para abrir um navegador da Web em que você pode criar uma nova solicitação de pull no portal da Web Azure Repos.
Quando a solicitação de pull for aberta no portal da Web Azure Repos, verifique suas ramificações de origem e de destino. Neste exemplo, queremos mesclar commits do add-readme-file
branch para o main
branch. Insira um título e uma descrição opcional, especifique todos os revisores, associe opcionalmente quaisquer itens de trabalho e selecione Criar.
Para obter mais informações sobre solicitações de pull, consulte o tutorial de solicitação pull .
Sincronizar com outras pessoas
Você pode manter seus branches locais em sincronia com seus equivalentes remotos 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 no branch de recursos, é uma boa ideia alternar periodicamente para o branch main
e efetuar pull de novas confirmações para mantê-lo atualizado com o branch remoto main
.
Visual Studio Git
Na janela Alterações do Git , você pode manter sua ramificação local atual com seu equivalente remoto 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:
- Fetch baixa confirmações remotas que não estão no branch local, mas não as mescla.
- O Pull executa uma busca e mescla as confirmações baixadas no branch local.
- O push carrega suas confirmações não pressionadas no repositório remoto, o que as adiciona ao branch remoto correspondente.
- A sincronização executa um Pull e, em seguida, um Push.
Você também pode selecionar Buscar, Puxar, Empurrar e Sincronizar no menu Git.
Team Explorer para Visual Studio
- No Team Explorer, selecione Página Inicial e escolha Sincronizar para abrir a Sincronização.
- Você pode baixar as alterações mais recentes em sua ramificação usando o link Pull . Há dois links pull , um próximo à parte superior e outro na seção Confirmações de Entrada . Você pode usar qualquer um porque ambos fazem a mesma coisa.