Create a repository

To access the Secure Source Manager instance through its web interface, copy the following URL into your browser address bar.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Replace the following:

• INSTANCE_ID with the instance name.
• PROJECT_NUMBER with the instance's Google Cloud project number. For information on identifying projects, see Identifying projects.
• LOCATION with the instance's region.

Authenticate using your Secure Source Manager credentials if needed.

Click the + Create new repository icon in the top right of the navigation menu.

Fill out the repository details:

1. Repository ID: Enter a name for the repository.

2. Description: Optional. Description of the repository.

3. Initialize repository: Optional. Select this option if you want to initialize the repository and add .gitignore, license, and README files.

4. .gitignore: Optional. Choose which files to not track using the drop-down menu templates.

5. license: Optional. Select a common license from the drop-down menu.

6. Default branch: Name of the default branch.

Click Submit.

Create a repository using the gcloud CLI by running the following command:

gcloud alpha source-manager repos create REPOSITORY_ID \
    --region=LOCATION \
    --project=PROJECT_ID \
    --instance=INSTANCE_ID \
    --description=DESCRIPTION \
    --default-branch=BRANCH \
    --gitignores=GITIGNORES \
    --license=LICENSE \
    --readme=README

Replace the following:

• REPOSITORY_ID with the name for your repository.

• LOCATION with the region where you want to create the repository. For information on supported locations, see Locations.

• PROJECT_ID with the project ID of the Secure Source Manager instance you want to create the repository in.

• INSTANCE_ID with the instance ID of the instance you are creating the repository in. To list the Secure Source Manager instances in your project, see List and view instances.

• DESCRIPTION with a description of the repository. This is optional and can be omitted.

• BRANCH with the default branch name. This is optional and can be omitted. Default branch name when not set is main.

• GITIGNORES with a comma-separated list of gitignore template names. This is optional and can be omitted. To view the full list of available templates, see the repository initialization configuration reference.

• LICENSE with the license template name to apply to your repository. This is optional and can be omitted. To view the full list of available license templates, see the repository initialization configuration reference.

• README with default to create a README file from the default template. This is optional and can be omitted. If omitted, a README file won't be created.

Create a repository using a REST call by running the following command:

curl \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://INSTANCE_ID-PROJECT_NUMBER-api.REGION.sourcemanager.dev/v1/projects/PROJECT_NUMBER/locations/REGION/repositories?repository_id=REPOSITORY_ID \
    -d '{}'

Replace the following:

• REGION is the region of your Secure Source Manager instance. For information on supported locations, see Locations.
• INSTANCE_ID is your Secure Source Manager instance ID.
• PROJECT_NUMBER is the project number of your Secure Source Manager instance. See Identifying projects for information on where to find your project number.
• REPOSITORY_ID is the name for your repository.

Additional values can be specified using the HTTP POST data flag, -d'{}' including initializing the repository, adding a specific .gitignore file, or licenses. See the Reference documentation for more information.

If you want your output to be human readable, you can pipe it to JSON using json_pp.

For example:

curl \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://prod-test-instance-123456789012-api.us-central1.sourcemanager.dev/v1/projects/654987321654/locations/us-central1/repositories?repository_id=my-repo \
    -d '{"initialConfig":{"defaultBranch":"main"}}' | json_pp

The response will resemble the following:

{
  "name": "operations/266bf4c7-13fe-11ed-be24-da823b7355d0",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
    "createTime": "2022-08-04T14:02:59.810496928Z",
    "endTime": "2022-08-04T14:03:00.558354528Z",
    "target": "projects/654987321654/locations/us-central1/repositories/my-repo",
    "verb": "create",
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Repository",
    "name": "projects/65498732Secure Source Manager1654/locations/us-central1/repositories/my-repo",
    "instance": "projects/123456789012/locations/us-central1/instances/se392d0ac-9df4-4809-9949-f4e78d49a8e2",
    "createTime": "2022-08-04T14:03:00Z",
    "uris": {
      "html": "https://prod-test-instance-123456789012.us-central1.sourcemanager.dev/my-project-id/my-repo",
      "gitHttps": "https://prod-test-instance-123456789012-git.us-central1.sourcemanager.dev/my-project-id/my-repo.git"
    }
}

Where:

• 654987321654 is the repository project number.
• my-repo is the REPOSITORY_ID that you set in the create command. The uris field contains the URLs to access the repository via the web browser or via Git protocol HTTPS access.

Access your new repository with the HTML URI in the response. Code review, issue tracking, and pull requests are supported in the Secure Source Manager web interface.