Criar um novo repositório Git em seu projeto

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server | 2019 TFS 2018

Azure DevOps Services e projetos TFS contêm repositórios Git, itens de trabalho, builds e versões. Você pode usar repositórios Git em seus projetos para gerenciar seu código-fonte à medida que seu projeto cresce. Este guia mostra como criar um repositório Git usando o portal da Web para Azure DevOps Services (hospedado no Azure) ou Team Foundation Server (TFS – local).

Pré-requisitos

Criar um repositório usando o portal da Web

  1. Abra a página Repos em seu projeto navegando atéhttps://dev.azure.com/OrganizationName, passe o mouse sobre o nome do projeto e selecione o ícone Repos. Você pode selecioná-lo na lista Todos os projetos ou na lista Projetos Recentes se tiver acessado recentemente.

    Screenshot of organization or collection page that lists projects.

  2. Na lista suspensa do repositório, selecione Novo repositório.

    Screenshot of repository menu, select New repository.

  3. Na caixa de diálogo Criar um novo repositório , verifique se o Git é o tipo de repositório e insira um nome para o novo repositório. Para restrições de nomenclatura, consulte Restrições de nomenclatura, Azure Repos (git).

    Screenshot of Create a new repository dialog.

    Você também pode adicionar um README e criar um .gitignore para o tipo de código que planeja gerenciar no repositório. Um README contém informações sobre o código em seu repositório. O arquivo .gitignore informa ao Git quais tipos de arquivos devem ser ignorados, como arquivos de build temporários do seu ambiente de desenvolvimento.

  4. Quando estiver satisfeito com o nome e as escolhas do repositório, selecione Criar.

    Um novo repositório Git vazio agora é criado em seu projeto.

    • Se você criou um repositório vazio sem arquivos README ou .gitignore, verá instruções sobre como clonar o repositório no computador. Você também verá instruções sobre como enviar código por push em um repositório existente para o recém-criado.
    • Neste exemplo, você criou um README e um .gitignore. Agora você verá uma visão geral dos arquivos em seu repositório. Você pode clonar o repositório usando o link Clonar no canto superior direito da página para começar a trabalhar com uma cópia local do repositório imediatamente.
  1. Navegue até seu projeto navegando https://dev.azure.com/<your organization name> até e selecionando o nome do seu projeto. Você pode selecioná-lo na lista Todos os projetos ou na lista Projetos Recentes na parte superior se tiver acessado recentemente.

    Screenshot of collection page that lists projects, TFS 2018 version.

  2. Na área Project no portal da Web, selecione Código e selecione a lista suspensa ao lado do nome do repositório atual e escolha Novo Repositório.

    Screenshot of Code page, Repository menu selection, Choose new repository, TFS 2018 version.

  3. Na caixa de diálogo Criar um novo repositório , verifique se o Git é o tipo de repositório e insira um nome para o novo repositório. Para restrições de nomenclatura, consulte Restrições de nomenclatura, Azure Repos (git).

    Screenshot of Create a new repoistory dialog, TFS 2018 version.

    Você também pode adicionar um README e criar um .gitignore para o tipo de código que planeja gerenciar no repositório. Um README contém informações sobre o código em seu repositório. O arquivo .gitignore informa ao Git quais tipos de arquivos devem ser ignorados, como arquivos de build temporários do seu ambiente de desenvolvimento.

  4. Quando estiver satisfeito com o nome e as escolhas do repositório, selecione Criar.

    Um novo repositório Git vazio agora é criado em seu projeto.

    • Se você criou um repositório vazio sem arquivos README ou .gitignore, verá instruções sobre como clonar o repositório no computador. Você também verá instruções sobre como enviar código por push em um repositório existente para o recém-criado.
    • Neste exemplo. você criou um README e um .gitignore. Agora você verá uma visão geral dos arquivos em seu repositório. Você pode clonar o repositório usando o link Clonar no canto superior direito da página para começar a trabalhar com uma cópia local do repositório imediatamente.

Clonar o repositório no computador

Para trabalhar com um repositório Git, clone-o no computador. A clonagem de um repositório cria uma cópia local completa do repositório para você trabalhar. A clonagem também baixa todas as confirmações e branches no repositório e configura uma relação nomeada com o repositório no servidor. Use essa relação para interagir com o repositório existente, efetuando push e efetuando pull de alterações para compartilhar código com sua equipe.

  1. No navegador da Web, abra o projeto de equipe para sua organização em Azure DevOps e selecione Repos>Files. Se você não tiver um projeto de equipe, crie um agora.

    Screenshot of Repos>Files.

  2. Selecione Clonar no canto superior direito da janela Arquivos e copie a URL do clone.

    Clone respository dialog.

  3. Abra a janela de comando git (Git Bash no Git para Windows). Em seguida, navegue até a pasta em que você deseja que o código do repositório seja armazenado em seu computador. Execute git clone seguido pelo caminho copiado da URL do Clone na seção anterior, conforme mostrado no exemplo a seguir.

    git clone https://dev.azure.com/fabrikam-fiber/MyFirstProject/_git/
    

    O Git baixa uma cópia do código em uma nova pasta para você trabalhar. O download inclui todas as confirmações e branches do repositório.

  4. Alterne seu diretório para o repositório que você clonou.

    cd fabrikam-fiber
    

    Mantenha essa janela de comando aberta, pois você a usará nas etapas a seguir.

  1. Selecione Clonar no canto superior direito da janela Código e copie a URL do Clone.

    Screenshot of Clone repo dialog, TFS 2018 version.

  2. Abra a janela de comando git (Git Bash no Git para Windows), navegue até a pasta onde você deseja que o código do repositório armazenado em seu computador e execute git clone seguido pelo caminho copiado da URL de Clone na etapa anterior, conforme mostrado no exemplo a seguir.

    git clone https://fabrikam-fiber.visualstudio.com/DefaultCollection/MyFirstProject/_git/
    

    Depois de executar o comando anterior, o Git baixa uma cópia do código em uma nova pasta para você trabalhar. Esse download inclui todas as confirmações e branches do repositório.

    Mantenha essa janela de comando aberta, pois você a usará nas etapas a seguir.

Trabalhar com o código

Nesta etapa, faremos uma alteração nos arquivos em seu computador, confirmaremos as alterações localmente, enviaremos a confirmação para o repositório no servidor e exibiremos as alterações lá.

  1. Navegue até a pasta no computador em que você clonou o repositório e abra o README.md arquivo em seu editor de escolha.

  2. Faça algumas alterações, por exemplo, adicione This is my first edit. ao arquivo e salve e feche o arquivo.

  3. Na janela de comando do Git, navegue até o fabrikam-fiber diretório inserindo o seguinte comando:

    cd fabrikam-fiber
    
  4. Confirme suas alterações inserindo o seguinte comando na janela de comando do Git:

    git commit -a -m "My first commit"
    

    Ao usar git commit, -a significa confirmar todos os arquivos alterados e -m especifica uma mensagem de confirmação.

  5. Envie suas alterações para o repositório Git inserindo o seguinte comando na janela de comando do Git:

    git push
    
  6. Volte para o portal da Web e selecione Histórico na exibição código para exibir sua nova confirmação. O novo repositório tem duas confirmações. A primeira é a confirmação em que o README e o .gitignore foram adicionados quando o repositório foi criado. A segunda é a confirmação que você acabou de fazer.

    Screenshot of View commit history.

  7. Alterne para a guia Arquivos e selecione o arquivo README para exibir suas alterações.

    Screenshot of Files page, View changed file.

Próximas etapas