Skip to content

Latest commit

 

History

History
404 lines (249 loc) · 21.6 KB

create-project.md

File metadata and controls

404 lines (249 loc) · 21.6 KB
title titleSuffix ms.custom description ms.assetid ms.technology ms.topic ms.author author monikerRange ms.date
Create a project
Azure DevOps
seodec18, contperf-fy20q4, devx-track-azurecli
Learn how to create a new project where your team can plan, track progress, and collaborate on building software solutions.
21F3C364-34F4-41B0-9EFC-6D4A141D81E0
devops-accounts
how-to
chcomley
chcomley
<= azure-devops
07/22/2020

Create a project in Azure DevOps

[!INCLUDE version-lt-eq-azure-devops]

You create an Azure DevOps project to establish a repository for source code and to plan and track work. You can manage and structure each project to support your business needs. Each project you create provides boundaries to isolate data from other projects. To learn more about projects and when to create one, see About projects and scaling your organization.

[!INCLUDE version-selector]

If you don't want to create a project in Azure DevOps, you can create Azure DevOps Projects.

::: moniker range="< azure-devops"

Note

If you don't want to manage an on-premises server, you can sign up for Azure DevOps Services and create a project. ::: moniker-end

Prerequisites

::: moniker range="azure-devops"

  • You need an organization before you can create a project. If you haven't created an organization yet, create one by following the instructions in Sign up, sign in to Azure DevOps, which also creates a project. Or see Create an organization or project collection.
  • You must be a member of the Project Collection Administrators group or have the collection-level Create new projects permission set to Allow. If you're the Organization owner, you're automatically added to the Project Collection Administrators group. For more information, see Change project collection-level permissions. ::: moniker-end

::: moniker range=" < azure-devops"

  • You create a project within a project collection. If you haven't created a project collection yet, do that now. For more information, see Create a project collection.
  • You must be a member of the Project Collection Administrators group or have the Create new projects permission set to Allow. For more information, see Change project collection-level permissions.

::: moniker-end

::: moniker range="azure-devops"

Important

To create a public project, or to make a private project public, see Create a public project in your organization or Change the project visibility, public or private. Additional policy settings must be enabled to work with public projects.

::: moniker-end

Create a project

::: moniker range="azure-devops"

You can create up to 1000 projects within an organization defined in Azure DevOps Services. For additional project limits, see Work tracking, process, and project limits.

::: moniker-end

::: moniker range=" < azure-devops"

Important

When you create a project from the web portal, several process template files are ignored. Specifically, the files that would create a Report Manager site aren't supported. You can add reports later by following the instructions provided in Add reports to a teams project.

There isn't any limit on the number of projects that you can create within a project collection, however for performance purposes, we recommend you limit the number to 300 or fewer. To learn more, see Work tracking, process, and project limits.

::: moniker-end

Browser

::: moniker range=">= azure-devops-2020"

  1. Select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the organization, and then select New project.

    [!div class="mx-imgBorder"]
    Screenshot of Open Projects.

  3. Enter information into the form provided. Provide a name for your project. Your project name can't contain special characters, such as / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ], can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters. Enter an optional description. Choose the visibility, initial source control type, and work item process. For more information, see Choosing the right version control for your project and Choose a process.

    [!div class="mx-imgBorder"]
    Create new project form

    Select visibility of either public or private. When you choose public visibility, anyone on the internet can view your project. With private visibility, only people who you give access to can view your project. For more information about public projects, see Create a public project in your organization. If the Public option isn't available, you need to change the policy.

  4. Select Create. The welcome page appears.

    [!div class="mx-imgBorder"]
    Project creation confirmation dialog.

    Select one of the following options to continue:

::: moniker-end

::: moniker range="azure-devops-2019"

  1. Select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the organization, and then select Create project.

    [!div class="mx-imgBorder"]
    Screenshot of Open Projects, current page.

  3. Enter information into the form provided. Provide a name for your project. Your project name can't contain special characters, such as / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ], can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters. Enter an optional description. Choose the visibility, initial source control type, and work item process. For more information, see Choosing the right version control for your project and Choose a process.

    [!div class="mx-imgBorder"]
    Create new project form, latest Azure DevOps

    Select your project visibility of either public or private. When you choose public visibility, anyone on the internet can view your project. With private visibility, only people who you give access to can view your project. For more information about public projects, see Create a public project in your organization. If the Public option isn't available, you need to change the policy.

  4. Select Create. The welcome page appears.

    [!div class="mx-imgBorder"]
    Project creation confirmation dialog, current page.

    Select one of the following options to continue:

::: moniker-end

::: moniker range="tfs-2018"

  1. Select Azure DevOps logo Azure DevOps to open the Projects page. Then, select New project.

    [!div class="mx-imgBorder"]
    Choose new project, horizontal navigation

  2. Complete the form provided. Provide a name for your new project, initial source control type, work item process.

    On completion, the project summary displays. For more information, see Share your project, view project activity.

    [!div class="mx-imgBorder"]
    New Project 2017

::: moniker-end

Team Explorer

::: moniker range="> tfs-2018"

You can't create a project from Team Explorer for TFS-2018 and later versions, including Azure DevOps Services.

::: moniker-end

Azure DevOps CLI

::: moniker range="azure-devops"

You can create a project using the az devops project create command. To get started, see Get started with Azure DevOps CLI.

[!div class="tabbedCodeSnippets"]

az devops project create --name
                         [--description]
                         [--open]
                         [--org]
                         [--process]
                         [--source-control {git, tfvc}]
                         [--visibility {private, public}]

Parameters

  • name: Required. Name of the project to create.
  • description: Optional. Short description of the project. Enclose the description in quotes.
  • open: Optional. Once the command creates a project, it opens in the default web browser.
  • org: Optional. Azure DevOps organization URL. Required if not configured as default or picked up by using git config. You can configure the default organization using az devops configure -d organization=ORG_URL. Example: https://dev.azure.com/MyOrganizationName/.
  • process: Optional. The process model to use, such as Agile, Basic, Scrum, CMMI, or other custom process model. Agile is the default. To learn more, see About process customization and inherited processes.
  • source-control: Optional. Type of source control repository to create for the project: git (default) or tfvc. If not, name or ID of the project. Example: --project "Fabrikam Fiber".
  • visibility: Optional. Project visibility. Accepted values: private (default), public.

Example

The following command creates a new project named MyFirstProject under the Fabrikam organization. The project has the Agile process, and git source control. For other output format options, see Output formats for Azure CLI commands.

[!div class="tabbedCodeSnippets"]

az devops project create --name MyFirstProject --description "Test project 1" --org https://dev.azure.com/fabrikam/ --process Agile --source-control  git --output table
ID                                    Name             Visibility    Process    Source Control
------------------------------------  ---------------  ------------  ---------  ----------------
be87c31a-fbb3-4377-b207-57a8caf65e31  MyFirstProject1  Private       Agile      Git

::: moniker-end

[!INCLUDE temp]

::: moniker range=">= tfs-2018 <= azure-devops-2019"

Note

For TFS 2018 and later versions, use the web portal. Creating a project from Visual Studio/Team Explorer is not supported for TFS 2018 and later versions, including Azure DevOps Server 2019 and Azure DevOps Services.

TFS 2018 and later versions no longer support native integration with SharePoint products. If you're planning to upgrade to TFS 2018, read About SharePoint integration to learn about the options available to you.

::: moniker-end

List and connect to projects

Browser

::: moniker range=">= azure-devops-2020"

Connect to a project, collection, or server from your web browser.

  1. To view the projects defined for an organization, select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the organization to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Select any project to connect to that project.

    [!div class="mx-imgBorder"]
    Screenshot of Open Projects, then select Create Project, preview page.

  3. Or, choose Organization settings and then select Projects to list all projects.

    [!div class="mx-imgBorder"]
    Choose Organization settings and then select Projects to list all projects.

    You can choose a project to open project settings for that project on this page. For more information, see About settings at the user, team, project, or organization-level. Or, you can rename a project or delete a project.

::: moniker-end

::: moniker range=">= tfs-2018 <= azure-devops-2019"

  1. To view the projects defined for a collection, select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the collection to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Choose any project to connect to that project.

    [!div class="mx-imgBorder"]
    Select any project to connect to that project, previous versions.

  3. Or, select Admin settings and then choose Projects to list all projects.

    [!div class="mx-imgBorder"]
    Select Admin settings and then choose Projects.

    You can choose a project to open project settings for that project on this page. For more information, see About settings at the user, team, project, or organization-level. Or, you can rename a project or delete a project.

::: moniker-end

Team Explorer

From Team Explorer, you can view a list of projects by connecting to an organization or server. For more information, see Connect to a project.

Visual Studio 2019

[!div class="mx-imgBorder"]
Connect to a project dialog

Visual Studio 2017

[!div class="mx-imgBorder"]
Connect to a project dialog 2017.

Visual Studio 2015

[!div class="mx-imgBorder"]
Connect to a project dialog 2015.

Azure DevOps CLI

::: moniker range="azure-devops"

List projects

You can list projects defined for an organization using the az devops project list command. To get started using Azure DevOps CLI, see Get started with Azure DevOps CLI.

[!div class="tabbedCodeSnippets"]

az devops project list [--org]
                       [--skip]
                       [--top]

Parameters

  • org: Optional. Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.
  • skip: Optional. Number of results to skip.
  • top: Optional. Maximum number of results to list.

Example

The following command lists the projects defined under the Fabrikam organization. For other output format options, see Output formats for Azure CLI commands.

[!div class="tabbedCodeSnippets"]

az devops project list --org https://dev.azure.com/fabrikam/ --output table
ID                                    Name                Visibility
------------------------------------  ------------------  ------------
647c53b6-01aa-462a-adb7-da81d5620167  Agile 11            Private
c5dd744a-574b-4308-925f-386415dc6efc  CMMI                Private
d4195a58-96a9-4753-bbf9-4c0a4ef178e0  Demo 11             Private
80bb92c7-49b2-43db-9843-3baf8f64b85d  Design Agile        Private
5444a5d2-6bd9-4ad1-a25d-eea59855c2a9  Fabrikam Fiber      Private
36946972-3a77-4bb4-875e-2f66a0f4652c  Fabrikam Test       Private
29bb9642-45f2-42bf-b391-f8701999c5fc  My Basic Project    Private
7aafdbeb-8de1-4e84-978f-d0ee4595b90e  MyFirstProject      Private
aba0ed07-3174-4793-9f2c-d2c5fa6b44d7  MyPublicProject     Public
36ca09d1-9de0-4e3e-8277-e10b5cb96f7c  Scrum 2.0           Private

Show project information, and open in web portal

You can list project information and optionally open the project in the web portal using the az devops project show command.

[!div class="tabbedCodeSnippets"]

az devops project show --project
                       [--open]
                       [--org]

Parameters

  • project: Required. Name or ID of the project. Example: --project "Fabrikam Fiber".
  • open: Optional. Open the project in the default web browser.
  • org: Optional. Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up by using git config. Example: https://dev.azure.com/MyOrganizationName/.

Example

The following command lists information for MyFirstProject under the Fabrikam organization and opens it in the web portal. For other output format options, see Output formats for Azure CLI commands.

[!div class="tabbedCodeSnippets"]

az devops project show --project MyFirstProject --open --org https://dev.azure.com/fabrikam/ --output table
ID                                    Name            Visibility    Process            Source Control
------------------------------------  --------------  ------------  -----------------  ----------------
40751c1d-236b-418d-9df4-d5cc7c0e7bd6  MyFirstProject  Private       Scrum - Inherited  Git

::: moniker-end

[!INCLUDE temp]

::: moniker range="<= azure-devops"

Add a repository to your project

From the admin context of the web portal, you can add additional repositories to a project. Add either Git (distributed) or TFVC (centralized) repositories. You can create many Git repositories, but only a single TFVC repository for a project. Additional steps to address permissions may be required. For more information, see Use Git and TFVC repos in the same project.

::: moniker-end

Next steps

[!div class="nextstepaction"] Structure your project

Related articles