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

Serviços de DevOps do Azure | 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 Repos ou repositórios do GitHub. Este artigo fornece procedimentos para as seguintes tarefas:

• Adicionar um projeto ou solução a um repositório Git local
• Publique seu código em um repositório Git do Azure Repos ou repositório GitHub
• Revise suas alterações de código antes de publicar
• Vincular itens de trabalho aos seus compromissos
• Confirmar e enviar atualizações por push
• Extraia alterações da ramificação principal do repositório

Para clonar um repositório GitHub, obtenha a URL do clone 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.

Pré-requisitos

Categoria	Requerimentos
Acesso ao projeto	Membro de um projeto .
Permissões	- Ver código em projetos privados: Acesso pelo menos Básico. - Clone ou contribua para o código em projetos privados: Membro do grupo de segurança Contributors ou permissões correspondentes no projeto. - Definir permissões de ramo ou repositório: Gerir permissões para o ramo ou repositório. - Alterar ramificação padrão: Editar políticas e permissões para o repositório. - Importar um repositório: Membro do grupo de segurança Administradores de Projeto ou com permissão de Criar repositório ao nível do projeto Git definida como Permitir. Para obter mais informações, consulte Definir permissões do repositório Git.
Serviços	Repos ativado.
Ferramentas	Opcional. Utilize os comandos az repos: Azure DevOps CLI.

Nota

Em projetos públicos, os usuários com acesso Partes Interessadas têm acesso total aos repositórios do Azure, incluindo visualização, clonagem e contribuição para o código.

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.

Nota

O Visual Studio 2019 versão 16.8 e posterior fornecem um menu Git para gerenciar o fluxo de trabalho do Git com menos alternância de contexto do que o Team Explorer. Os procedimentos neste artigo na guia Visual Studio descrevem como usar a experiência do Git e também 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 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 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 no 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 > Create Git Repository na barra de menus para iniciar a janela Create a Git repository . 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 Visual Studio Git: 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 de solução do Visual Studio e confirmou seu código nesse repositório. Seu repositório Git local contém sua solução do Visual Studio e 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 no 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 > Create Git Repository na barra de menus para iniciar a janela Create a Git repository . 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 Visual Studio Git: 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 de solução do Visual Studio e confirmou seu código nesse repositório. Seu repositório Git local contém sua solução do Visual Studio e recursos do Git.

Visual Studio 2019 - Explorador de Equipa

Estas tarefas não são suportadas através do Team Explorer.

Linha de comando Git

1. Baixe e instale o Git. Quando solicitado durante a instalação, habilite o Git Credential Manager.

2. No prompt de comando, vá para a pasta raiz que contém sua solução do Visual Studio e execute os seguintes comandos. 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 sua solução do Visual Studio e recursos do Git.

   

Publique o 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, 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 .

1. Conecte-se a um repositório de DevOps do Azure 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 > Push to Git service na barra de menus para iniciar a janela de Criar um repositório Git.

   

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

   

   Você pode verificar se o repositório foi criado acessando o GitHub e procurando pelo 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, Alterações do Git e por meio de menus de contexto no Gerenciador de Soluções.

1. Conecte-se a um repositório de DevOps do Azure 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 > Push to Git service na barra de menus para iniciar a janela de Criar um repositório Git.

   

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

3. Em seu projeto de DevOps do Azure, crie um repositório Git vazio sem um arquivo LEIA-ME. Copie a URL do clone da janela de Clone Repository.

   

4. Na janela Criar um repositório Git, escolha Remoto existente e insira o URL de clone do repositório da etapa anterior, e em seguida, escolha Enviar. Para obter mais informações sobre como criar um novo repositório de DevOps do Azure, 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 está agora em um repositório de DevOps do Azure.

   

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 mais informações, consulte Introdução ao Azure DevOps, alterar as organizações existentes para usarem a nova URL do nome de domínio.

Visual Studio 2019 - Explorador de Equipa

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

Nota

Uma vantagem de se conectar a um projeto através do Team Explorer é que você ganha 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 secção Push para Azure DevOps Services da vista de Sincronização no Team Explorer, selecione o botão Publicar repositório Git.

   

2. Escolha sua organização do Azure DevOps e o nome do repositório 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 . Pode ver o código na Web, selecionando Ver na Web.

   

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 mais informações, consulte Introdução ao Azure DevOps, alterar as organizações existentes para usarem a nova URL do nome de domínio.

Linha de comando Git

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

2. Em seu projeto de DevOps do Azure, crie um repositório Git vazio sem um arquivo LEIA-ME. Copie a URL do clone da janela de Clone Repository.

   

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

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

   Seu código agora é publicado na main ramificação de um repositório Git do Azure Repos .

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 mais informações, consulte Introdução ao Azure DevOps, alterar as organizações existentes para usarem a nova URL do nome de domínio.

Rever alterações de confirmação

É uma boa prática rever as alterações de código no seu commit antes de publicar. O Visual Studio fornece uma exibição de comparação que ajuda o utilizador a ver todas as alterações feitas desde o commit anterior.

Visual Studio 2022

1. Para ver o que mudou num commit, selecione Git>Gerir Ramos para abrir a janela Repositório Git.

   

2. Na janela do Repositório Git, selecione o seu ramo, clique com o botão direito do rato no commit e escolha Ver detalhes do commit para abrir a janela de Commit.

   

3. Na janela Commit, pode clicar com o botão direito em qualquer arquivo e selecionar Comparar com Anterior para visualizar as alterações de arquivo feitas pelo commit.

   

Visual Studio 2019 - Menu Git

1. Para ver o que mudou num commit, selecione Git>Gerir Ramos para abrir a janela Repositório Git.

   

2. Na janela do Repositório Git, selecione o seu ramo, clique com o botão direito do rato no commit e escolha Ver detalhes do commit para abrir a janela de Commit.

   

3. Na janela Commit, pode clicar com o botão direito em qualquer arquivo e selecionar Comparar com Anterior para visualizar as alterações de arquivo feitas pelo commit.

   

Visual Studio 2019 - Explorador de Equipa

1. Para ver o que mudou num commit, vá para a página Sincronização no Team Explorer, clique com o botão direito sobre qualquer commit e escolha Ver detalhes do commit para abrir a janela Detalhes do Git.

   

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

   

Linha de comando Git

Para mostrar uma visualização de diferença do último commit no seu branch atual, execute o seguinte comando na linha de comandos na pasta local do repositório git.

> git show

Vincular itens de trabalho aos seus compromissos

À medida que desenvolve seu software, você pode capturar quais confirmações dão suporte à conclusão de itens de trabalho, como tarefas de DevOps do Azure ou correções de bugs. O registo de auditoria de itens de trabalho vinculados a commits permite que a sua equipa entenda como as tarefas e bugs foram resolvidos.

Nota

A sintaxe #ID é suportada quando você se conecta a um repositório Git do Azure Repos. Se te ligares a um repositório GitHub, ainda podes ligar a itens de trabalho, mas deves usar a sintaxe #ABID e ter configurado previamente uma ligação Azure Boards-GitHub.

Visual Studio 2022

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

Visual Studio 2019 - Menu Git

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

Visual Studio 2019 - Explorador de Equipa

Você pode incluir itens de trabalho nas suas confirmações por meio de Itens de Trabalho Relacionados na vista Alterações do Team Explorer.

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

Linha de comando Git

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

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

Enviar alterações de confirmação por push

Visual Studio 2022

À medida que escreve o código, as alterações são automaticamente controladas pelo Visual Studio. Quando estiver satisfeito com suas alterações, você poderá salvá-las no Git usando uma confirmação e, em seguida, enviar sua confirmação para o Azure Repos.

1. Na janela Alterações do Git, insira uma mensagem que descreva as alterações e escolha 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 da janela Git Changes .

   

2. Para enviar o seu commit para o Azure Repos, selecione o botão de seta para cima.

   

   Ou, pode enviar o seu commit na 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

À medida que escreve o código, as alterações são automaticamente controladas pelo Visual Studio. Quando estiver satisfeito com suas alterações, você poderá salvá-las no Git usando uma confirmação e, em seguida, enviar sua confirmação para o Azure Repos.

1. Na janela Alterações do Git, insira uma mensagem que descreva as alterações e escolha 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 da janela Git Changes .

   

2. Para enviar o seu commit para o Azure Repos, selecione o botão de seta para cima.

   

   Ou, pode enviar o seu commit na 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 - Explorador de Equipa

À medida que escreve o código, as alterações são automaticamente controladas pelo Visual Studio. Quando estiver satisfeito com suas alterações, você poderá salvá-las no Git usando uma confirmação e, em seguida, enviar sua confirmação para o 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 escolha Confirmar tudo. Confirmar tudo confirma alterações não organizadas e ignora a área de preparação. Pode optar por preparar todos os ficheiros antes de confirmar, selecionando o botão "preparar tudo +" na parte superior da secção "Alterações" na janela Git Changes.

   

3. Para enviar um ou mais commits para os Azure Repos, selecione Home e escolha Sincronizar para abrir a vista de Sincronização no Team Explorer. Ou selecione o ícone da barra de status de alterações não publicadas ( na barra de status.

   

4. Na visualização Sincronização, escolha Enviar por push para carregar sua confirmação para o 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 sua confirmação foi enviada por push para uma nova ramificação no repositório remoto e que futuras confirmações enviadas da ramificação atual serão carregadas para essa ramificação remota.

   

Linha de comando Git

Para publicar novos commits da sua ramificação local atual para a ramificação correspondente no repositório Git do Azure Repos execute o seguinte comando na linha de comandos na pasta do seu repositório git local.

> git push

Puxar alterações

Você pode manter suas filiais locais sincronizadas com suas contrapartes remotas puxando confirmações criadas por outras pessoas. Enquanto estiveres a trabalhar no teu ramo de funcionalidades, é uma boa ideia alternar periodicamente para o teu ramo main e buscar novos commits para mantê-lo atualizado com o ramo remoto main.

Nota

No Visual Studio, os links Fetch 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 puxar do repositório remoto para a ramificação atual do repositório local.

Visual Studio 2022

1. Na janela Alterações do Git, pode verificar os commits mais recentes na ramificação remota usando o link de obtenção com seta para baixo e, em seguida, selecionando o link de saída/entrada para abrir a janela Repositório Git. Buscar confirmações remotas de downloads que não estão em sua ramificação local, mas não as mesclará em sua ramificação local. As confirmações buscadas aparecem na seção Confirmações de entrada da janela Repositório Git. Você pode clicar duas vezes num _commit_ recuperado para exibir as alterações nos seus ficheiros.

   

2. Escolha Pull para integrar os commits remotos obtidos no seu repositório local. Pull executa uma busca e, em seguida, mescla as confirmações baixadas em sua ramificação local.

Visual Studio 2019 - Menu Git

1. Na janela Alterações do Git, pode verificar os commits mais recentes na ramificação remota usando o link de obtenção com seta para baixo e, em seguida, selecionando o link de saída/entrada para abrir a janela Repositório Git. Buscar confirmações remotas de downloads que não estão em sua ramificação local, mas não as mesclará em sua ramificação local. As confirmações buscadas aparecem na seção Confirmações de entrada da janela Repositório Git. Você pode clicar duas vezes num _commit_ recuperado para exibir as alterações nos seus ficheiros.

   

2. Escolha Pull para integrar os commits remotos obtidos no seu repositório local. Pull executa uma busca e, em seguida, mescla as confirmações baixadas em sua ramificação local.

Visual Studio 2019 - Explorador de Equipa

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 na ramificação remota usando o link Buscar. Buscar faz o download de commits remotos que não estão no seu ramo local, mas não os mescla. As confirmações obtidas aparecem na secção de Confirmações de Entrada da vista de Sincronização. Você pode clicar duas vezes em uma confirmação para exibir suas alterações no arquivo.

   

3. Escolha Pull para integrar os commits remotos obtidos no seu repositório local. Pull executa uma busca e, em seguida, mescla as confirmações baixadas em sua ramificação local.

Linha de comando Git

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

> git fetch

Para baixar e integrar novos commits do repositório Git do Azure Repos no branch atual do seu repositório local, execute o conjunto de comandos a seguir.

> git pull

Perguntas frequentes

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

R: A sua página de início de sessão depende se utilizou uma conta Microsoft ou uma conta profissional com o Azure DevOps. Sempre entre com as credenciais 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 muito bem juntos. As alterações aos seus repositórios feitas em qualquer uma das ferramentas serão refletidas na outra. Certifique-se de instalar a versão mais recente do Git para Windows, que tem ferramentas para ajudá-lo a se conectar aos seus repositórios do Azure DevOps Services/TFS.

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

Próximos passos

Configurar uma buildTutorial do Azure Repos Git

Artigos relacionados

• Novo em repositórios Git? Mais informações