# devops pipeline create

Create a DevOps Center pipeline.

## Description for devops pipeline create

Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you create the pipeline, add stages, and activate the pipeline.

## Flags

| Flag Name (Long)          | Flag Name (Short) | Description                                                                                                                                                      |
| ------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--api-version`           | N/A               | **Type:** Value<br><br>Override the api version used for api requests made by this command                                                                       |
| `--bitbucket-project-key` | N/A               | **Type:** Value<br><br>Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.              |
| `--bitbucket-workspace`   | N/A               | **Type:** Value<br><br>Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.                    |
| `--create-repo`           | N/A               | **Type:** Boolean<br><br>Create a repository if it doesn't exist.                                                                                                |
| `--flags-dir`             | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                                      |
| `--json`                  | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                                  |
| `--name`                  | `-n`              | **Type:** Value<br>**Required**<br><br>Name of the pipeline.                                                                                                     |
| `--project-id`            | N/A               | **Type:** Value<br><br>ID of a project to associate with the pipeline. Repeat the flag to associate multiple projects.                                           |
| `--repo`                  | `-r`              | **Type:** Value<br>**Required**<br><br>URL of an existing repository or the name of a repository to create.                                                      |
| `--repo-owner`            | N/A               | **Type:** Value<br><br>Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.                  |
| `--repo-type`             | N/A               | **Type:** Value<br>**Valid Values:** `github`, `bitbucket`<br><br>Type of the source code repository. Required when creating a repository using '--create-repo'. |
| `--stage`                 | `-s`              | **Type:** Value<br><br>Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.      |
| `--target-org`            | `-o`              | **Type:** Value<br>**Required**<br><br>Username or alias of the target org. Not required if the `target-org` configuration variable is already set.              |

## Examples for devops pipeline create

Create a pipeline and associate it with an existing GitHub repository:

```shell
sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo
```

Create a pipeline and associate it with a new GitHub repository:

```shell
sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo my-new-repo --repo-type github --repo-owner myorg --create-repo
```

Create a pipeline and create a new Bitbucket repository:

```shell
sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo my-new-repo --repo-type bitbucket --bitbucket-workspace myworkspace --bitbucket-project-key PROJ --create-repo
```

Create a pipeline and associate it with an existing Bitbucket repository:

```shell
sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://bitbucket.org/myworkspace/myrepo
```

Create a pipeline with custom stage names instead of the default stages:

```shell
sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo --stage Dev --stage QA --stage Prod
```

Create a pipeline and associate one or more projects with it:

```shell
sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo --project-id 0Hn000000000001 --project-id 0Hn000000000002
```
