Compartilhar seu código com o Azure Repos e o Visual Studio

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

Compartilhe sua solução do Visual Studio com outras pessoas hospedando seu código em um repositório git Azure Repos. Você pode usar o Visual Studio para gerenciar Azure Repos repositórios Git ou repositórios GitHub. Este artigo fornece procedimentos para as seguintes tarefas:

• Adicionar um projeto ou solução a um repositório Git local
• Publicar seu código em um repositório Git Azure Repos ou no repositório GitHub
• Examinar as alterações de código antes da publicação
• Vincular itens de trabalho aos commits
• Confirmar e enviar atualizações por push
• Efetuar pull de alterações do branch principal do repositório

Para clonar um repositório GitHub, obtenha a URL de clone, conforme descrito em Clonando um repositório.

Para obter uma visão geral do fluxo de trabalho do Git, consulte Azure Repos tutorial do Git.

Pré-requisitos

• Os repositórios devem estar habilitados nas configurações do projeto do Azure DevOps. Se o hub repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço do Azure DevOps para reabilitar repositórios.

• Para exibir o 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 exibir o código.

  • Se você não tiver um projeto, crie um ou inscreva-se gratuitamente.

  • Se você não for um 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 código. Para saber mais, confira O que é um projeto público?

  Observação

  Para projetos públicos, os usuários que receberam acesso de Stakeholder têm acesso total a Azure Repos.

• Os repositórios devem estar habilitados nas configurações do projeto do Azure DevOps. Se o hub repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço do Azure DevOps para reabilitar repositórios.

• Para exibir o código, você deve ser membro do projeto do Azure DevOps com acesso Básico ou superior. Se você não for um 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 do Azure DevOps com acesso Básico ou superior. Se você não for um 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, confira Permissões padrão de repositório Git e branch e Sobre níveis de acesso.

Observação

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 sobre como usar a experiência do Git, bem como o Team Explorer. Para saber mais, confira Comparação lado a lado do Git e do Team Explorer.

Adicionar um projeto ou solução a um novo repositório Git local

A primeira etapa para compartilhar sua solução do Visual Studio com outras pessoas usando o Git é criar um repositório Git local para seu código. Se for a primeira vez que você usa o Visual Studio para se conectar a Azure Repos, consulte Conectar-se a um projeto do Visual Studio para obter detalhes.

Visual Studio 2022

1. Crie um novo repositório Git local para sua solução do Visual Studio clicando com o botão direito do mouse no nome da solução em Gerenciador de Soluções e selecionando Criar Repositório Git. Ou escolha Adicionar ao Controle do Código-Fonte na barra de status no canto inferior direito do Visual Studio e selecione Git. Se você não vir essas opções, seu código já está em um repositório Git.

   

   Ou escolha Git > Criar Repositório Git na barra de menus para iniciar a janela Criar um repositório Git . Se você não vir essa opção, o código já estará em um repositório Git.

   

2. Esta etapa só se aplica à experiência de controle de versão do Git do Visual Studio: na janela Criar um repositório Git , escolha Somente local, verifique se o caminho local está correto e escolha Criar.

   

Agora você criou um repositório Git local na pasta da solução do Visual Studio e comprometeu seu código nesse repositório. Seu repositório Git local contém a solução do Visual Studio e os recursos do Git.

Visual Studio 2019 – menu Git

1. Crie um novo repositório Git local para sua solução do Visual Studio clicando com o botão direito do mouse no nome da solução em Gerenciador de Soluções e selecionando Criar Repositório Git. Ou escolha Adicionar ao Controle do Código-Fonte na barra de status no canto inferior direito do Visual Studio e selecione Git. Se você não vir essas opções, seu código já está em um repositório Git.

   

   Ou escolha Git > Criar Repositório Git na barra de menus para iniciar a janela Criar um repositório Git . Se você não vir essa opção, o código já estará em um repositório Git.

   

2. Esta etapa só se aplica à experiência de controle de versão do Git do Visual Studio: na janela Criar um repositório Git , escolha Somente local, verifique se o caminho local está correto e escolha Criar.

   

Agora você criou um repositório Git local na pasta da solução do Visual Studio e comprometeu seu código nesse repositório. Seu repositório Git local contém a solução do Visual Studio e os recursos do Git.

Visual Studio 2019 – Team Explorer

Essas tarefas não têm suporte por meio do Team Explorer.

Linha de comando Git

1. Baixe e instale o Git. Quando solicitado durante a instalação, habilite o Gerenciador de Credenciais do Git.

2. No prompt de comando, vá para a pasta raiz que contém sua solução do Visual Studio e execute os comandos a seguir. Esses comandos criam um repositório Git local na pasta da solução do Visual Studio e confirmam seu código nesse repositório.

   > git init
   > git commit -am "first commit"
   > git branch -m main
   

   Seu repositório Git local agora contém a solução do Visual Studio e os recursos do Git.

   

Publicar seu código

Você pode compartilhar seu trabalho com outras pessoas publicando seu repositório Git local em um repositório git Azure Repos.

Visual Studio 2022

O Visual Studio 2022 fornece uma experiência de controle de versão do Git usando o menu Git, as Alterações do Git e os menus de contexto no Gerenciador de Soluções. O Visual Studio 2019 versão 16.8 também oferece a interface do usuário do Git do Team Explorer . Para obter mais informações, consulte a guia Visual Studio 2019 – Team Explorer .

1. Conecte-se a um repositório do Azure DevOps clicando com o botão direito do mouse no nome da solução em Gerenciador de Soluções e selecionando Enviar por push para o serviço Git para iniciar a janela Criar um repositório Git.

   

   Ou escolha Git > Push para o serviço Git na barra de menus para iniciar a janela Criar um repositório Git .

   

2. Na caixa de diálogo Criar um repositório Git , selecione GitHub. Insira todos os valores necessários em Criar um repositório GitHub. Em seguida, selecione Enviar por push.

   

   Você pode verificar se o repositório foi criado acessando o GitHub e pesquisando o nome do repositório em sua conta.

Visual Studio 2019 – menu Git

O Visual Studio 2019 fornece uma experiência de controle de versão do Git usando o menu Git, as Alterações do Git e os menus de contexto no Gerenciador de Soluções.

1. Conecte-se a um repositório do Azure DevOps clicando com o botão direito do mouse no nome da solução em Gerenciador de Soluções e selecionando Enviar por push para o serviço Git para iniciar a janela Criar um repositório Git.

   

   Ou escolha Git > Push para o serviço Git na barra de menus para iniciar a janela Criar um repositório Git .

   

2. Abra um navegador e navegue até o projeto do Azure DevOps usando uma URL na forma de https://dev.azure.com/<OrganizationName>/<ProjectName>. Se você ainda não tiver um projeto, crie um.

3. No projeto do Azure DevOps, crie um repositório Git vazio sem um arquivo README. Copie a URL de clone do pop-up Clonar Repositório .

   

4. Na janela Criar um repositório Git , escolha Existente remoto e insira a URL de clone do repositório na etapa anterior e escolha Push. Para obter mais informações sobre como criar um novo repositório do Azure DevOps, consulte Criar um novo repositório Git em seu projeto.

   

5. A janela Alterações do Git mostra uma mensagem de confirmação de que seu código agora está em um repositório do Azure DevOps.

   

Observação

Com Azure DevOps Services, 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 tem suporte. Para obter mais informações, consulte Introdução ao Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Visual Studio 2019 – Team Explorer

O Visual Studio 2019 versão 16.8 e versões posteriores fornece uma experiência de controle de versão do Git, mantendo a interface do usuário do Git do Team Explorer . Para usar o Team Explorer, desmarque Ferramentas>Opções>Visualizar Recursos>Nova experiência do usuário do Git na barra de menus. Você pode exercitar os recursos do Git de qualquer interface intercambiável. Abaixo, fornecemos uma comparação lado a lado para publicar seu código.

Observação

Uma vantagem de se conectar a um projeto por meio do Team Explorer é que você obtém acesso ao hub Itens de Trabalho. Para obter uma visão geral dos recursos do Team Explorer , consulte Navegar no Visual Studio Team Explorer.

1. Na seção Enviar por push para o Azure Dev Ops Services da exibição Sincronização no Team Explorer, selecione o botão Publicar Repositório Git .

   

2. Escolha a organização e o nome do repositório do Azure DevOps e selecione Publicar Repositório.

   

   Esta etapa cria um novo projeto com o mesmo nome que você selecionou para o repositório. Para criar o repositório em um projeto existente, selecione Avançado ao lado do nome do Repositório e escolha um projeto.
   
   

3. Seu código agora está em um repositório Git Azure Repos. Você pode exibir seu código na Web selecionando Vê-lo na Web.

   

Observação

Com Azure DevOps Services, 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 tem suporte. Para obter mais informações, consulte Introdução ao Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Linha de comando Git

1. Abra um navegador e navegue até o projeto do Azure DevOps usando uma URL na forma de https://dev.azure.com/<OrganizationName>/<ProjectName>. Se você ainda não tiver um projeto, crie um.

2. Em seu projeto do Azure DevOps, crie um repositório Git vazio sem um arquivo README. Copie a URL de clone do pop-up Clonar Repositório .

   

3. Para publicar sua confirmação local em repositórios do Azure, execute os comandos a seguir no prompt de comando na pasta de repositório git local, usando a URL de clone da etapa anterior.

   > git remote add origin <clone URL>
   > git push -u origin main
   

   Seu código agora é publicado no main branch de um repositório git Azure Repos.

Observação

Com Azure DevOps Services, 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 tem suporte. Para obter mais informações, consulte Introdução ao Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Examinar alterações de commit

É uma boa prática revisar as alterações de código em seu commit antes da publicação. O Visual Studio fornece uma exibição dif que ajuda você a ver todas as alterações feitas desde o commit anterior.

Visual Studio 2022

1. Para ver o que mudou em um commit, selecioneGerenciar Branches do Git> para abrir a janela do Repositório Git.

   

2. Na janela Repositório Git , selecione seu branch, clique com o botão direito do mouse no commit e, em seguida, escolha Exibir Detalhes de Confirmação para abrir a janela Confirmar .

   

3. Na janela Confirmar , você pode clicar com o botão direito do mouse em qualquer arquivo e selecionar Comparar com Anterior para exibir as alterações de arquivo feitas pelo commit.

   

Visual Studio 2019 – menu Git

1. Para ver o que mudou em um commit, selecioneGerenciar Branches do Git> para abrir a janela do Repositório Git.

   

2. Na janela Repositório Git , selecione seu branch, clique com o botão direito do mouse no commit e, em seguida, escolha Exibir Detalhes de Confirmação para abrir a janela Confirmar .

   

3. Na janela Confirmar , você pode clicar com o botão direito do mouse em qualquer arquivo e selecionar Comparar com Anterior para exibir as alterações de arquivo feitas pelo commit.

   

Visual Studio 2019 – Team Explorer

1. Para ver o que mudou em um commit, vá para a página Sincronização no Team Explorer, clique com o botão direito do mouse em qualquer confirmação e, em seguida, escolha Exibir Detalhes de Confirmação para abrir a janela Detalhes do Git .

   

2. Na janela Confirmar Detalhes , você pode clicar com o botão direito do mouse em qualquer arquivo e selecionar Comparar com Anterior para exibir as alterações de arquivo feitas pelo commit.

   

Linha de comando Git

Para mostrar uma exibição dif do último commit no branch atual, execute o comando a seguir no prompt de comando na pasta local do repositório git.

> git show

Vincular itens de trabalho aos seus commits

Ao desenvolver seu software, você pode capturar quais commits dão suporte à conclusão de itens de trabalho, como tarefas do Azure DevOps ou correções de bugs. A trilha de auditoria de itens de trabalho vinculados a commits permite que sua equipe entenda como tarefas e bugs foram resolvidos.

Observação

Há suporte para a sintaxe #ID quando você se conecta a um repositório git Azure Repos. Se você se conectar a um repositório GitHub, ainda poderá vincular a itens de trabalho, mas deve usar a sintaxe #ABID e já configurou uma conexão de Boards-GitHub do Azure.

Visual Studio 2022

Você pode vincular itens de trabalho a commits adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação "Corrigir bug nº 12 Ícones ausentes nas ferramentas de relatório" vincularia o item de trabalho 12 ao commit quando o commit for enviado por push para Azure Repos.

Visual Studio 2019 – menu Git

Você pode vincular itens de trabalho a commits adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação "Corrigir bug nº 12 Ícones ausentes nas ferramentas de relatório" vincularia o item de trabalho 12 ao commit quando o commit for enviado por push para Azure Repos.

Visual Studio 2019 – Team Explorer

Você pode incluir itens de trabalho em seus commits por meio de Itens de Trabalho Relacionados na exibição Alterações do Team Explorer.

Você também pode vincular itens de trabalho a commits adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação "Corrigir bug nº 12 nas ferramentas de relatório" vincularia o item de trabalho 12 ao commit quando o commit for enviado por push para Azure Repos.

Linha de comando Git

Você pode vincular itens de trabalho a commits adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação "Corrigir bug nº 12 nas ferramentas de relatório" vincularia o item de trabalho 12 ao commit quando o commit for enviado por push para Azure Repos. Para testar, faça algumas alterações de código e execute os comandos a seguir no prompt de comando na pasta local do repositório git.

> git commit -am "Fix bug #<work item ID>"
> git push

Alterações de confirmação por push

Visual Studio 2022

Ao escrever seu código, suas alterações são rastreadas automaticamente pelo Visual Studio. Quando estiver satisfeito com suas alterações, você poderá salvá-las no Git usando um commit e, em seguida, enviar seu commit por push para Azure Repos.

1. Na janela Alterações do Git , insira uma mensagem que descreva as alterações e escolha Confirmar Tudo. Commit All commits unstaged changes and skips the staging area. Você pode optar por preparar todos os arquivos antes de se comprometer selecionando o botão preparar tudo + (mais) na parte superior da seção Alterações da janela Alterações do Git .

   

2. Para efetuar push do commit para Azure Repos, selecione o botão de push de seta para cima.

   

   Ou você pode efetuar push do commit da janela do Repositório Git . Para abrir a janela do Repositório Git , selecione o link de saída/entrada na janela Alterações do Git .

   

   Ou você pode escolher Git > Push na barra de menus.

   

Visual Studio 2019 – menu Git

Ao escrever seu código, suas alterações são rastreadas automaticamente pelo Visual Studio. Quando estiver satisfeito com suas alterações, você poderá salvá-las no Git usando um commit e, em seguida, enviar seu commit por push para Azure Repos.

1. Na janela Alterações do Git , insira uma mensagem que descreva as alterações e escolha Confirmar Tudo. Commit All commits unstaged changes and skips the staging area. Você pode optar por preparar todos os arquivos antes de se comprometer selecionando o botão preparar tudo + (mais) na parte superior da seção Alterações da janela Alterações do Git .

   

2. Para efetuar push do commit para Azure Repos, selecione o botão de push de seta para cima.

   

   Ou você pode efetuar push do commit da janela do Repositório Git . Para abrir a janela do Repositório Git , selecione o link de saída/entrada na janela Alterações do Git .

   

   Ou você pode escolher Git > Push na barra de menus.

   

Visual Studio 2019 – Team Explorer

Ao escrever seu código, suas alterações são rastreadas automaticamente pelo Visual Studio. Quando estiver satisfeito com suas alterações, você poderá salvá-las no Git usando um commit e, em seguida, enviar seu commit por push para Azure Repos.

1. Abra a exibição Alterações do Team Explorer selecionando o botão Página Inicial e escolhendo Alterações. Ou selecione o ícone de alterações pendentes ícone na barra de status.

   

2. Na janela Alterações do Git , insira uma mensagem que descreva as alterações e escolha Confirmar Tudo. Commit All commits unstaged changes and skips the staging area. Você pode optar por preparar todos os arquivos antes de se comprometer selecionando o botão preparar tudo + (mais) na parte superior da seção Alterações na janela Alterações do Git .

   

3. Para enviar por push um ou mais commits para Azure Repos, selecione Página Inicial e, em seguida, escolha Sincronizar para abrir o modo de exibição Sincronização no Team Explorer. Ou selecione o ícone de barra de status de alterações não publicadas ( na barra de status.

   

4. No modo de exibição Sincronização , escolha Enviar por push para carregar sua confirmação no repositório remoto. Se este for seu primeiro push para o repositório, você verá a mensagem: The current branch does not track a remote branch..., que informa que seu commit foi enviado 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 nesse branch remoto.

   

Linha de comando Git

Para publicar novos commits do branch local atual no branch correspondente no repositório git Azure Repos, execute o comando a seguir no prompt de comando na pasta local do repositório git.

> git push

Alterações de pull

Você pode manter seus branches locais sincronizados com seus equivalentes remotos puxando commits criados por outras pessoas. Enquanto você estiver trabalhando no branch de recursos, é uma boa ideia alternar periodicamente para o main branch e efetuar pull de novos commits para mantê-lo atualizado com o branch remoto main .

Observação

No Visual Studio, os links Buscar e Puxar podem ser encontrados em diferentes modos de exibição e no menu Git na barra de menus. Todos esses links fazem a mesma coisa: buscar ou efetuar pull do repositório remoto para o branch atual do repositório local.

Visual Studio 2022

1. Na janela Alterações do Git , você pode verificar se há confirmações mais recentes no branch remoto usando o link de busca de seta para baixo e, em seguida, selecionar o link de saída/entrada para abrir a janela do Repositório Git . O Fetch baixa commits remotos que não estão em sua ramificação local, mas não os mesclam em sua ramificação local. Confirmações buscadas aparecem na seção Confirmações de Entrada da janela Repositório Git . Você pode clicar duas vezes em um commit buscado para exibir as alterações de arquivo.

   

2. Escolha Pull para mesclar as confirmações remotas buscadas em seu repositório local. O Pull executa uma busca e mescla os commits baixados no branch local.

Visual Studio 2019 – menu Git

1. Na janela Alterações do Git , você pode verificar se há confirmações mais recentes no branch remoto usando o link de busca de seta para baixo e, em seguida, selecionar o link de saída/entrada para abrir a janela do Repositório Git . O Fetch baixa commits remotos que não estão em sua ramificação local, mas não os mesclam em sua ramificação local. Confirmações buscadas aparecem na seção Confirmações de Entrada da janela Repositório Git . Você pode clicar duas vezes em um commit buscado para exibir as alterações de arquivo.

   

2. Escolha Pull para mesclar as confirmações remotas buscadas em seu repositório local. O Pull executa uma busca e mescla os commits baixados no branch local.

Visual Studio 2019 – Team Explorer

1. No Team Explorer, selecione Página Inicial e escolha Sincronizar para abrir o modo de exibição Sincronização .

   

2. No modo de exibição Sincronização , você pode visualizar as alterações mais recentes no branch remoto usando o link Buscar . O Fetch baixa commits remotos que não estão no branch local, mas não os mescla. Confirmações buscadas aparecem na seção Confirmações de Entrada do modo de exibição Sincronização . Você pode clicar duas vezes em um commit para exibir as alterações de arquivo.

   

3. Escolha Pull para mesclar as confirmações remotas buscadas em seu repositório local. O Pull executa uma busca e mescla os commits baixados no branch local.

Linha de comando Git

Para baixar novos commits do repositório git Azure Repos sem mesclá-los em seu repositório local, execute o comando a seguir no prompt de comando na pasta local do repositório git.

> git fetch

Para baixar e mesclar novos commits do repositório git Azure Repos no branch atual do repositório local, execute o comando a seguir.

> git pull

Perguntas frequentes

P: Por que a página de entrada é diferente entre o portal da Web e o Visual Studio?

Um: Sua página de entrada depende se você usou uma conta Microsoft ou uma conta corporativa com o Azure DevOps. Sempre entre com o nome de usuário e a senha que você usa para o Azure DevOps.

P: Posso usar o prompt de comando do Git com o Visual Studio?

Um: O Team Explorer do Visual Studio e a linha de comando do Git funcionam muito bem juntos. As alterações em seus repositórios feitas em qualquer ferramenta serão refletidas na outra. Instale a versão mais recente do Git para Windows, que tem ferramentas para ajudá-lo a se conectar aos seus repositórios Azure DevOps Services/TFS.

Consulte o tutorial Azure Repos Git e a referência de comando para obter ajuda adicional usando o Git na linha de comando.

Próximas etapas

Configurar umtutorial de build Azure Repos Git

Artigos relacionados

• Novo nos repositórios Git? Saiba mais