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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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 do Azure Repos. Você pode usar o Visual Studio para gerenciar repositórios Git do Azure Reposou repositórios GitHub. Esta seção 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 do Azure Repos ou no repositório GitHub
• Revise as alterações de código antes da publicação
• Vincular itens de trabalho às confirmações
• Confirmar e enviar atualizações por push
• Efetuar pull das alterações do branch principal do seu repositório

Para clonar um repositório GitHub, obtenha a URL conforme descrito em Clonar um repositório.

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

Pré-requisitos

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

• 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 crie uma conta gratuitamente.

  • Se você não for um membro do projeto, será adicionado.

• Para clonar ou contribuir com o código para 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?

  Observação

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

Para obter mais informações sobre permissões e acesso, consulte Permissões padrão de branch e repositório Git e Sobre níveis de acesso.

Observação

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem um novo menu do Git para gerenciar o fluxo de trabalho do Git com menos comutação 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 obter mais informações, consulte Comparação lado a lado do Git e do Team Explorer.

Adicionar um projeto ou solução a um 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 sua primeira vez usando o Visual Studio para se conectar ao 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 status no canto inferior direito do Visual Studio e, em seguida, 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, seu código já está 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, em seguida, escolha Criar.

   

Agora você criou um repositório Git local na pasta de solução do Visual Studio e confirmou seu código nesse repositório. Seu Repositório do 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 status no canto inferior direito do Visual Studio e, em seguida, selecione Git. Se você não vir essas opções, seu código já está em um Repositório do Git.

   

   Ou, escolha Git>Criar Repositório do Git na barra de menus para iniciar a janela Criar um Repositório do Git. Se você não vir essa opção, seu código já está em um Repositório do 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, em seguida, escolha Criar.

   

Agora você criou um Repositório do Git local na pasta de solução do Visual Studio e confirmou seu código nesse repositório. Seu Repositório do 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 de 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 do 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 através dos 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 no 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>Enviar por 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 novo repositório GitHub. Selecione 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 atalho 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 no 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>Enviar por push para o serviço Git na barra de menus para iniciar a janela Criar um Repositório do 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ê não tiver um projeto ainda, 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 do Git , escolha Remoto existente e insira a URL de clone do repositório da 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, ainda há suporte para o visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o 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 Team Explorer Git. Para usar o Team Explorer, desmarque Ferramentas>Opções>Versão prévia do recurso>Nova experiência do usuário do Git na barra de menus. Você pode exercer os recursos do Git de qualquer interface de forma 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 de Itens de Trabalho. Para obter uma visão geral dos recursos do Team Explorer, consulte Navegar no Team Explorer do Visual Studio.

1. Na seção Enviar por push para o Azure Dev Ops Services do modo de 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 do 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, ainda há suporte para o visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o 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ê não tiver um projeto ainda, crie um.

2. 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.

   

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 do Azure Repos.

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 visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Revisar alterações de confirmação

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

Visual Studio 2022

1. Para ver o que mudou em uma confirmação, selecione Gerenciar >Branches do Git para abrir a janela Repositório Git.

   

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

   

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

   

Visual Studio 2019 - Menu Git

1. Para ver o que mudou em uma confirmação, selecione Gerenciar >Branches do Git para abrir a janela Repositório Git.

   

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

   

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

   

Visual Studio 2019 - Team Explorer

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

   

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

   

Linha de comando Git

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

> git show

Vincular itens de trabalho às confirmações

Ao desenvolver seu software, você pode capturar quais confirmações 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 às confirmações 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 do Azure Repos. Se você se conectar a um repositório GitHub, ainda poderá vincular a itens de trabalho, mas deverá usar a sintaxe #ABID e ter configurado anteriormente uma conexão de Azure Boards-GitHub.

Visual Studio 2022

Você pode vincular itens de trabalho a confirmações adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação "Corrigir bug #12 Ícones ausentes nas ferramentas de relatório" vincularia o item de trabalho 12 à confirmação quando a confirmação é enviada por push para Azure Repos.

Visual Studio 2019 - Menu Git

Você pode vincular itens de trabalho a confirmações adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação "Corrigir bug #12 Ícones ausentes nas ferramentas de relatório" vincularia o item de trabalho 12 à confirmação quando a confirmação é enviada por push para Azure Repos.

Visual Studio 2019 - Team Explorer

Você pode incluir itens de trabalho em suas confirmações por meio de Itens de Trabalho Relacionados no modo de exibição Alterações do Team Explorer.

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

Linha de comando Git

Você pode vincular itens de trabalho a confirmações adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação "Corrigir bug #12 nas ferramentas de relatório" vincularia o item de trabalho 12 à confirmação quando a confirmação é enviada 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 do repositório git local.

> 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 as alterações, você poderá salvá-las no Git usando uma confirmação e, em seguida, efetuar push da confirmação para Azure Repos.

1. Na janela Alterações do Git , insira uma mensagem que descreva as alterações e selecione Confirmar Tudo. Confirmar Tudo confirma as alterações não preparadas e ignora a área de preparo. Você pode optar por preparar todos os arquivos antes de confirmar selecionando o botão preparar tudo + (mais) na parte superior da seção Alterações na janela Alterações do Git.

   

2. Para efetuar push da confirmação para Azure Repos, selecione o botão de push de seta para cima.

   

   Ou você pode efetuar push da sua confirmação na janela Repositório do Git. Para abrir a janela 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 as alterações, você poderá salvá-las no Git usando uma confirmação e, em seguida, efetuar push da confirmação para Azure Repos.

1. Na janela Alterações do Git , insira uma mensagem que descreva as alterações e selecione Confirmar Tudo. Confirmar Tudo confirma as alterações não preparadas e ignora a área de preparo. Você pode optar por preparar todos os arquivos antes de confirmar selecionando o botão preparar tudo + (mais) na parte superior da seção Alterações na janela Alterações do Git.

   

2. Para efetuar push da confirmação para Azure Repos, selecione o botão de push de seta para cima.

   

   Ou você pode efetuar push da sua confirmação na janela Repositório do Git. Para abrir a janela 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 as alterações, você poderá salvá-las no Git usando uma confirmação e, em seguida, efetuar push da confirmação para Azure Repos.

1. Abra o modo de 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 na barra de status.

   

2. Na janela Alterações do Git , insira uma mensagem que descreva as alterações e selecione Confirmar Tudo. Confirmar Tudo confirma as alterações não preparadas e ignora a área de preparo. Você pode optar por preparar todos os arquivos antes de confirmar selecionando o botão preparar tudo + (mais) na parte superior da seção Alterações na janela Alterações do Git.

   

3. Para efetuar push de uma ou mais confirmações 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 da barra de status de alterações não publicadas ( na barra de status.

   

4. No modo de exibição Sincronização, escolha 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 permite que você saiba que a 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.

   

Linha de comando Git

Para publicar novas confirmações do seu branch local atual no branch correspondente no repositório Git do Azure Repos , execute o seguinte comando no prompt de comando na sua pasta de repositório git local.

> git push

Alterações de pull

Você pode manter seus branches locais sincronizados com seus equivalentes remotos efetuando pull de confirmações criadas por outras pessoas. Enquanto você estiver trabalhando em seu branch de recurso, é uma boa ideia alternar periodicamente para o main branch e efetuar pull de novos commits para mantê-lo atualizado com o branch remotomain.

Observação

No Visual Studio, os links Buscar e Pull 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 as confirmações mais recentes no branch remoto usando o link de busca de seta para baixo e, em seguida, selecionando o link saída/entrada para abrir a janela do Repositório Git. Buscar baixa confirmações remotas que não estão no branch local, mas não as mescla no seu branch local. As confirmações buscadas aparecem na seção Confirmações de Entrada da janela Repositório Git . Você pode clicar duas vezes em uma confirmação buscada para exibir as alterações de arquivo.

   

2. Escolha Pull para mesclar as confirmações remotas buscadas em seu repositório local. 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 as confirmações mais recentes no branch remoto usando o link de busca de seta para baixo e, em seguida, selecionando o link saída/entrada para abrir a janela do Repositório Git. Buscar baixa confirmações remotas que não estão no branch local, mas não as mescla no seu branch local. As confirmações buscadas aparecem na seção Confirmações de Entrada da janela Repositório Git . Você pode clicar duas vezes em uma confirmação buscada para exibir as alterações de arquivo.

   

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

Visual Studio 2019 - Team Explorer

1. Em 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 previamente as alterações mais recentes no branch remoto usando o link Buscar. Buscar baixa commits remotos que não estão no branch local, mas não os mescla. As confirmações buscadas aparecem na seção Confirmações de Entrada do modo de exibição Sincronização. Você pode clicar duas vezes em uma confirmação para visualizar suas alterações de arquivo.

   

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

Linha de comando Git

Para baixar novas confirmações do repositório Git do Azure Repos sem mesclá-las em seu repositório local, execute o seguinte comando no prompt de comando na pasta de repositório git local.

> git fetch

Para baixar e mesclar novas confirmações do repositório Git do 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 credenciais é diferente entre o portal da Web e o Visual Studio?

R: Sua página de credenciais 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?

R: O Team Explorer do Visual Studio e a linha de comando do Git funcionam 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 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 uma compilação do tutorial do Git do Azure Repos

Artigos relacionados

• Novo no Repositório do Git? Saiba mais