Create a new Git repo in your project

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

Azure DevOps Services and TFS projects contain Git repositories, work items, builds, and releases. You can use Git repos in your projects to manage your source code as your project grows. This guide shows you how to create a Git repo using the web portal for either Azure DevOps Services (hosted on Azure) or Team Foundation Server (TFS - on-premises).

Prerequisites

Create a repo using the web portal

  1. Open the Repos page in your project by browsing to https://dev.azure.com/OrganizationName, hover your mouse over the name of your project, and select the Repos icon. You can select it from the All projects list, or from the Recent projects list if you've accessed it recently.

    Screenshot of organization or collection page that lists projects.

  2. From the repo drop-down, select New repository.

    Screenshot of repository menu, select New repository.

  3. In the Create a new repository dialog, verify that Git is the repository type and enter a name for your new repository. For naming restrictions, see Naming restrictions, Azure Repos (git).

    Screenshot of Create a new repository dialog.

    You can also add a README and create a .gitignore for the type of code you plan to manage in the repo. A README contains information about the code in your repo. The .gitignore file tells Git which types of files to ignore, such as temporary build files from your development environment.

  4. When you're happy with the repo name and choices, select Create.

    A new empty Git repo is now created in your project.

    • If you created an empty repo with no README or .gitignore files, you'll see instructions on how to clone the repo to your computer. You'll also see instructions on how to push code in an existing repo into the newly created one.
    • In this example, you created a README and a .gitignore. You'll now see an overview of the files in your repo. You can clone the repo using the Clone link on the upper right of the page to get working with a local copy of the repo immediately.
  1. Navigate to your project by browsing to https://dev.azure.com/<your organization name> and selecting the name of your project. You can select it from the All projects list, or from the Recent projects list at the top if you've accessed it recently.

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

  2. In the Project area in the web portal, select Code, then select the drop-down next to the current repo name and choose New Repository.

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

  3. In the Create a new repository dialog, verify that Git is the repo type and enter a name for your new repo. For naming restrictions, see Naming restrictions, Azure Repos (git).

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

    You can also add a README and create a .gitignore for the type of code you plan to manage in the repo. A README contains information about the code in your repo. The .gitignore file tells Git which types of files to ignore, such as temporary build files from your development environment.

  4. When you're happy with the repo name and choices, select Create.

    A new empty Git repo is now created in your project.

    • If you created an empty repo with no README or .gitignore files, you'll see instructions on how to clone the repo to your computer. You'll also see instructions on how to push code in an existing repo into the newly created one.
    • In this example. you created a README and a .gitignore. You'll now see an overview of the files in your repo. You can clone the repo using the Clone link on the upper right of the page to get working with a local copy of the repo immediately.

Clone the repo to your computer

To work with a Git repo, you clone it to your computer. Cloning a repo creates a complete local copy of the repo for you to work with. Cloning also downloads all commits and branches in the repo and sets up a named relationship with the repo on the server. Use this relationship to interact with the existing repo, pushing and pulling changes to share code with your team.

  1. From your web browser, open the team project for your organization in Azure DevOps and select Repos > Files. If you don't have a team project, create one now.

    Screenshot of Repos>Files.

  2. Select Clone in the upper-right corner of the Files window and copy the clone URL.

    Clone respository dialog.

  3. Open the Git command window (Git Bash on Git for Windows). Then, browse to the folder where you want the code from the repo stored on your computer. Run git clone followed by the path copied from the Clone URL in the previous section, as shown in the following example.

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

    Git downloads a copy of the code into a new folder for you to work with. The download includes all commits and branches from the repo.

  4. Switch your directory to the repository that you cloned.

    cd fabrikam-fiber
    

    Keep this command window open, because you'll use it in the following steps.

  1. Select Clone in the upper-right corner of the Code window and copy the Clone URL.

    Screenshot of Clone repo dialog, TFS 2018 version.

  2. Open the Git command window (Git Bash on Git for Windows), navigate to the folder where you want the code from the repo stored on your computer, and run git clone followed by the path copied from the Clone URL in the previous step, as shown in the following example.

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

    After running the previous command, Git downloads a copy of the code into a new folder for you to work with. This download includes all commits and branches from the repo.

    Keep this command window open, as you'll use it in the following steps.

Work with the code

In this step, we'll make a change to the files on your computer, commit the changes locally, push the commit up to the repo on the server, and view the changes there.

  1. Browse to the folder on your computer where you cloned the repo and open the README.md file in your editor of choice.

  2. Make some changes, for example add This is my first edit. to the file, and save and close the file.

  3. In the Git command window, navigate to the fabrikam-fiber directory by entering the following command:

    cd fabrikam-fiber
    
  4. Commit your changes by entering the following command in the Git command window:

    git commit -a -m "My first commit"
    

    When using git commit, -a means to commit all changed files, and -m specifies a commit message.

  5. Push your changes up to the Git repo by entering the following command into the Git command window:

    git push
    
  6. Switch back to the web portal and select History from the Code view to view your new commit. The new repo has two commits. The first is the commit where the README and .gitignore were added when the repo was created. The second is the commit you just made.

    Screenshot of View commit history.

  7. Switch to the Files tab and select the README file to view your changes.

    Screenshot of Files page, View changed file.

Next steps