Skip to content

Commit 6200793

Browse files
authored
Update bitbucket-installation.md
1 parent 343ebe0 commit 6200793

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

docs/bitbucket-installation.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ description: Install gitStream to your Bitbucket workspace.
1818
Bitbucket Installation Overview
1919

2020
1. Designate a gitStream user account.
21-
2. Create a CM configuration file.
21+
2. Create a `cm` repo and `.cm` configuration file.
2222
3. Create a Bitbucket pipeline.
2323
4. Install the gitStream service.
2424

@@ -31,21 +31,22 @@ We recommend creating a dedicated service account to control access to individua
3131
!!! tip "Use this account when you integrate gitStream"
3232
Make sure to use this account when authorizing Bitbucket in LinearB.
3333

34-
## Create a CM Configuration File
34+
## Create a `cm` repo and `.cm` configuration file.
3535

36-
Create a `gitstream.cm` rules file in the root directory of your repository's default branch (usually `master` or `main`). This file will contain a YAML configuration that determines the workflows that run on your repositories. You can name the CM file anything you want as long as it ends in `.cm`.
37-
38-
!!! info "Configuration files go in the repo's root directory."
39-
Your `.cm` files should be placed in the repository's root directory.
36+
Create a `cm` repository in your Bitbucket workspace. This repository must reside in the same project as your target repositories. In the root directory of the default branch (usually `master` or `main`), create a `gitstream.cm` rules file to define the workflow automations. The file can have any name, but it must end with `.cm`.
4037

38+
!!! info "Configuration files locations"
39+
Group-level rules require your `.cm` files to be placed in the `cm` repository's root directory.
40+
You can also define specific repo-level rules under the `.cm` folder in each of the connected repositories
41+
4142
!!! example "Example Configuration"
4243
```yaml
4344
--8<-- "docs/downloads/gitstream-bb.cm"
4445
```
4546

4647
## Create a Bitbucket Pipeline
4748

48-
Once your gitStream configuration file is set up, you need a Bitbucket Pipelines configuration file to trigger gitStream automations. Create a `bitbucket-pipelines.yml` file in your repository's default branch (usually `master` or `main`) and add the following configuration:
49+
Once your gitStream configuration file is set up, you need a Bitbucket Pipelines configuration file to trigger gitStream automations. Create a `bitbucket-pipelines.yml` file in your `cm` repository's default branch and add the following configuration:
4950

5051
```yaml
5152
--8<-- "docs/downloads/bitbucket-pipelines.yml"

0 commit comments

Comments
 (0)