Compartilhar via


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.

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

  • 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, 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 quiser alterar.

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.

  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.

    Captura de tela da opção ‘Criar Repositório Git’ no menu de atalho do Gerenciador de Soluções no Visual Studio 2022.

    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.

    Captura de tela da opção Criar Repositório Git no menu Git na barra de menus do Visual Studio 2022.

  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.

    Captura de tela da janela

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.

Captura de tela da pasta Git, arquivo Git ignore e arquivo de atributos Git no Explorador de Arquivos do Windows.

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.

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.

    Captura de tela da opção ‘Enviar por push para o serviço Git’ no menu de atalho do Gerenciador de Soluções no Visual Studio 2022.

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

    Captura de tela da opção ‘Enviar por push para o serviço Git’ no menu de atalho do Visual Studio 2022.

  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.

    Captura de tela da caixa de diálogo ‘Criar um repositório Git’ no Visual Studio 2022.

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

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.

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

    Captura de tela do Visual Studio 2019.

  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 .

    Captura de tela da opção de menu 'Exibir Detalhes de Confirmação' para uma confirmação na janela 'Repositório Git' no Visual Studio.

  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.

    Captura de tela da opção 'Comparar com o Anterior' no painel Confirmação no Visual Studio.

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.

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.

Captura de tela de um item de trabalho vinculado a uma confirmação na janela 'Alterações do Git' no Visual Studio.

Alterações de confirmação por push

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.

    Captura de tela do botão 'Confirmar Tudo' na janela 'Alterações do Git' no Visual Studio.

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

    Captura de tela do botão de push de seta para cima na janela 'Alterações do Git' do Visual Studio.

    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.

    Captura de tela do link 'saída/entrada' na janela 'Alterações do Git' e o link de push na janela 'Repositório Git' do Visual Studio.

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

    Captura de tela da opção Push no menu Git no Visual Studio.

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.

  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.

    Captura de tela dos botões Buscar, Pull, Push e Sincronizar na janela 'Alterações do Git' do Visual Studio.

  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.

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