Compartilhe seu código com Azure Repos e Visual Studio

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Compartilhe sua Visual Studio com outras pessoas hospedando seu código em um Azure Repos Git. Você pode usar Visual Studio para gerenciar Azure Repos repositórios Git ou GitHub repositórios. 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 repositório GitHub git
  • Revise as alterações de código antes da publicação
  • Vincular itens de trabalho aos commits
  • Confirmações e atualizações por push
  • Alterações de pull do branch principal do repositório

Para clonar um GitHub, obter a URL, conforme descrito em Clonando um repositório.

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

Pré-requisitos

  • Repos deve ser habilitado nas configurações Azure DevOps projeto. Se o hub Repos e as páginas associadas não são exibidos, consulte Ativar ou desativar um serviço Azure DevOps para reativar Repos .

  • Para exibir o código, você deve ser membro de um projeto Azure DevOps com acesso Básico ou superior.

  • Para clonar ou contribuir com o código, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes.

    Observação

    Para projetos públicos, os usuários que concederam acesso aos Stakeholders têm acesso completo ao Azure Repos.

  • Repos deve ser habilitado nas configurações Azure DevOps projeto. Se o hub Repos e as páginas associadas não são exibidos, consulte Ativar ou desativar um serviço Azure DevOps para reativar Repos .

  • Para exibir o código, você deve ser um membro do projeto 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 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, consulte Permissões padrão de branch e repositório Git e Sobre níveis de acesso.

Observaçã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 alternamento de contexto do que 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 Team Explorer. Para saber mais, confira Comparação lado a lado do Git e Team Explorer.

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

A primeira etapa para compartilhar sua 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 Conexão a um projeto do Visual Studio para obter detalhes.

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 Team Explorer Git. Você pode praticar recursos do Git de qualquer interface de forma intercambiável. Abaixo, fornecemos uma comparação lado a lado para criar um repositório Git.

Observação

Uma vantagem de se conectar a um projeto por meio Team Explorer você tem acesso ao hub Itens de Trabalho. Para ter uma visão geral Team Explorer recursos, consulte Navegar no Visual Studio Team Explorer.

  1. Crie um repositório Git local para sua solução 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, em seguida, selecione Git. Se você não vir essas opções, seu código já está em um repositório Git.

    Screenshot of the 'Create Git repository' option in the Solution Explorer context menu in Visual Studio 2019.

    Ou escolha Git Create Git Repository 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.

    Screenshot of the 'Create Git Repository' option in the Git menu from the menu bar of Visual Studio 2019.

Visual Studio Git

  1. Na janela Criar um repositório Git, escolha Somente Local, verifique se o caminho Local está correto e escolha Criar.

Screenshot of the 'Create a Git repository' window with the 'Local only' option selected in Visual Studio 2019.

Team Explorer para Visual Studio

Team Explorer não inicia a janela Criar um repositório Git e pressupo que você deseja um repositório Git local.

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

Screenshot of the Git folder, Git ignore file, and Git attributes file in Windows file explorer.

Publicar seu código

A próxima etapa para compartilhar sua solução Visual Studio usando Git e Azure Repos é publicar do repositório Git local em um repositório Git Azure Repos que outras pessoas possam acessar.

Visual Studio Git

  1. Conexão para um repositório Azure DevOps, clique com o botão direito do mouse no nome da solução no Gerenciador de Soluçõese, em seguida, selecione Push para o serviço Git para iniciar a janela Criar um repositório Git.

Screenshot of the 'Push to Git service' menu option in the Git menu on the menu bar in Visual Studio 2019.

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

Screenshot of the 'Push to Git service' option in the in Visual Studio 2019 context menu.

  1. Abra um navegador e navegue até seu projeto 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 Azure DevOps, crie um repositório Git vazio sem um arquivo LEIAME. Copie a URL de clone do pop-up Clonar Repositório.

Screenshot of the 'Clone Repository' popup from the Azure DevOps project site.

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

Screenshot of the 'Create a Git repository' window, with the URL of an empty Azure repo, in Visual Studio 2019.

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

Screenshot of the 'Git Changes' window, with a confirmation message that your code is in 'Azure DevOps' repo, in Visual Studio 2019.

Team Explorer para Visual Studio

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

Screenshot of the 'Push' view of 'Team Explorer' in Visual Studio 2019.

  1. Escolha sua Azure DevOps, a organização e o nome do repositório e, em seguida, selecione Publicar Repositório.

Screenshot of the Azure DevOps account, organization, and repo name options and the 'Publish Repository' button in the 'Synchronization' view of 'Team Explorer' in Visual Studio 2019.

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

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

Screenshot of the 'See it on the web' link in the 'Home' view of 'Team Explorer' in Visual Studio 2019.

Observação

Project URLs foram alteradas com o lançamento do Azure DevOps Services e agora têm o formato , mas você ainda dev.azure.com/{your organization}/{your project} pode usar o formato visualstudio.com existente. Para obter mais informações, consulte Visual Studio Team Services agora está Azure DevOps Services.

Revisar alterações de confirmação

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

Visual Studio Git

  1. Para ver o que mudou em uma confirmação, abra a janela Repositório Git escolhendo Gerenciar Branches do Git na barra de menus.

Screenshot of in Visual Studio 2019.

  1. Na janela Repositório Git, selecione o branch, clique com o botão direito do mouse no commit e escolha Exibir Detalhes da Confirmação para abrir a janela Confirmação.

Screenshot of the 'View Commit Details' menu option for a commit in the 'Git Repository' window in Visual Studio 2019.

  1. Na janela Confirmação, 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 pela confirmação.

Screenshot of the 'Compare with Previous' option in the Commit pane in Visual Studio 2019.

Team Explorer para Visual Studio

  1. Para ver o que mudou em uma confirmação, acesse 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 ajanela Detalhes do Git.

Screenshot of a commit in the Synchronization view of Team Explorer in Visual Studio 2019.

  1. Na janela Detalhes da Confirmação, 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 pela confirmação.

Screenshot of the 'Compare with Previous' option in the 'Commit Details' window in Visual Studio 2019.

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

Observação

A sintaxe #ID é suportada quando você se conecta a um Azure Repos Git. Se você se conectar a um repositório GitHub, ainda poderá vincular a itens de trabalho ,mas deverá usar a sintaxe #ABID e configurar anteriormente uma conexão do Azure Boards-GitHub.

Visual Studio Git

Você pode vincular itens de trabalho a confirmações adicionando #ID à mensagem de confirmação. Por exemplo, a mensagem de confirmação " Corrigirbug nº 12nas ferramentas de relatório " vincularia o item de trabalho 12 à confirmação quando a confirmação for enviada por Azure Repos .

Screenshot of a work item linked to a commit in the 'Git Changes' window in Visual Studio 2019.

Team Explorer para Visual Studio

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

Screenshot of a work item linked to a commit in the Changes view of Team Explorer in Visual Studio 2019.

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

Alterações de commit por push

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 uma commit e, em seguida, efetuar push do commit para Azure Repos.

Visual Studio Git

  1. Na janela Alterações do Git, insira uma mensagem que descreva as alterações e, em seguida, escolha Commit All. Commit All confirma alterações sem marca e ignora a área de preparação. Você pode escolher o estágio de todos os arquivos antes de se comprometer selecionando o botão de estágio all + (plus) na parte superior da seção Alterações da janela Alterações git.

Screenshot of the 'Commit All' button in the 'Git Changes' window in Visual Studio 2019.

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

Screenshot of the up-arrow push button in the 'Git Changes' window of Visual Studio 2019.

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

Screenshot of the 'outgoing / incoming' link in the 'Git Changes' window, and the Push link in the 'Git Repository' window of Visual Studio 2019.

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

Screenshot of the Push option from the Git menu in Visual Studio 2019.

Team Explorer para Visual Studio

  1. Abra a exibição Alterações do Team Explorer selecionando o botão Página Início e escolhendo Alterações. Ou selecione o ícone de alterações Visual Studio Pending Changes Status Bar icon pendentes na barra de status.

Screenshot of the Changes option in Team Explorer in Visual Studio 2019.

  1. Na janela Alterações do Git, insira uma mensagem que descreva as alterações e, em seguida, escolha Commit All. Commit All confirma alterações sem marca e ignora a área de preparação. Você pode escolher o estágio de todos os arquivos antes de se comprometer selecionando o botão de estágio all + (plus) na parte superior da seção Alterações na janela Alterações git.

Screenshot of the 'Screenshot of commit message text and 'Commit All' button in Visual Studio 2019.

  1. Para fazer push de uma ou mais confirmações para Azure Repos, selecione Página Team Explorer e, em seguida, escolha Sincronizar para abrir a exibição Sincronização Team Explorer. Ou selecione o ícone da barra de status de alterações não publicadas ( Visual Studio unpublished changes status bar icon na barra de status.

Screenshot of the Sync option in Team Explorer in Visual Studio 2019.

  1. Na exibição Sincronização, escolha Push para carregar sua confirmação no repo remoto. Se esse for seu primeiro push para o repo, você verá a mensagem: , que permite que você saiba que seu commit foi enviado por push para um novo branch no repo remoto e que futuras confirmações enviadas por push do branch atual serão carregadas nesse branch The current branch does not track a remote branch... remoto.

Screenshot of the Push link in the Synchronization view of Team Explorer in Visual Studio 2019.

Alterações de pull

Você pode manter seus branches locais em sincronia com suas contrapartes remotas e efetuar commits criados por outras pessoas. Enquanto você estiver trabalhando no branch de recursos, é uma boa ideia alternar periodicamente para o branch e efetuar pull de novas confirmações para mantê-lo atualizado com o mainmain branch remoto.

Observação

Os links Fetch e Pull podem ser encontrados em diferentes exibições e no menu Git na barra de menus. Todos esses links fazem a mesma coisa– buscar ou pull do repo remoto para o branch atual do repo local.

Visual Studio 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 de saída/entrada para abrir a janela Repositório Git. A busca baixa confirmações remotas que não estão no branch local, mas não as mescla no 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 commit buscada para exibir suas alterações de arquivo.

Screenshot of the Fetch, Pull, Push and Sync buttons in the 'Git Changes' window of Visual Studio 2019.

  1. Escolha Pull para mesclar as confirmações remotas buscadas no seu repo local. Pull executa uma busca e, em seguida, mescla as confirmações baixadas em seu branch local.

Team Explorer para Visual Studio

  1. No Team Explorer, selecione Página Página Central e selecione Sincronizar para abrir a exibição Sincronização.

Screenshot of the Sync option in 'Team Explorer' in Visual Studio 2019.

  1. Na exibição Sincronização, você pode visualizar as alterações mais recentes no branch remoto usando o link Buscar. A busca baixa confirmações remotas que não estão no branch local, mas não as mescla. As confirmações buscadas aparecem na seção Confirmações de Entrada da exibição Sincronização. Você pode clicar duas vezes em uma commit para exibir suas alterações de arquivo.

Screenshot of the Pull link in the Synchronization view of Team Explorer in Visual Studio 2019.

  1. Escolha Pull para mesclar as confirmações remotas buscadas no seu repo local. Pull executa uma busca e, em seguida, mescla as confirmações baixadas em seu branch local.

Perguntas frequentes

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

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

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

R: Visual Studio o Team Explorer e a linha de comando do Git funcionam muito bem juntos. As alterações feitas em seus repos em uma das ferramentas 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.

Confira 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 um build para seu código e saber mais sobre como usar o Git no tutorial Azure Repos Git.