You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/bitbucket-installation.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,8 +23,10 @@ description: Install gitStream to your Bitbucket workspace.
23
23
When setting up IP allowlists in Bitbucket, you're specifying which source IP addresses are permitted to interact with your repositories and APIs. This affects both gitStream and your CI/CD runners.
24
24
25
25
There are two primary cases where this matters for gitStream:
26
+
26
27
1. **Webhook Event Handling by gitStream**
27
28
When Bitbucket triggers a webhook event (e.g., a pull request opened), gitStream may need to make follow-up API calls to Bitbucket. This can include fetching additional metadata, posting comments to the PR, or performing other actions. These calls are made from the LinearB/gitStream service, which uses a fixed set of IP addresses. These IPs must be added to your Bitbucket allowlist to ensure proper operation.
29
+
28
30
2. **Outbound Requests from Your CI Runner**
29
31
When your pipeline runs gitStream, that runner might also make outbound calls to Bitbucket—for example, to clone a repository or retrieve commit history. These requests will originate from the runner's IP address.
Copy file name to clipboardExpand all lines: docs/github-installation.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,16 +6,18 @@ description: Install gitStream to your GitHub organization.
6
6
7
7
!!! Info "Prerequisites"
8
8
Allowed network connection between the runners and the following IPs:
9
-
9
+
10
10
- 13.56.203.235
11
11
- 54.151.81.98
12
12
13
13
??? Info "Understanding IP Allowlisting for gitStream"
14
14
When setting up IP allowlists in GitHub, you're specifying which source IP addresses are permitted to interact with your repositories and APIs. This affects both gitStream and your CI/CD runners.
15
15
16
16
There are two primary cases where this matters for gitStream:
17
+
17
18
1. **Webhook Event Handling by gitStream**
18
19
When GitHub triggers a webhook event (e.g., a pull request opened), gitStream may need to make follow-up API calls to GitHub. This can include fetching additional metadata, posting comments to the PR, or performing other actions. These calls are made from the LinearB/gitStream service, which uses a fixed set of IP addresses. These IPs must be added to your GitHub allowlist to ensure proper operation.
20
+
19
21
2. **Outbound Requests from Your CI Runner**
20
22
When your pipeline runs gitStream (e.g., via a GitHub Action), that runner might also make outbound calls to GitHub—for example, to clone a repository or retrieve commit history. These requests will originate from the runner's IP address.
Copy file name to clipboardExpand all lines: docs/gitlab-installation.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,8 +17,10 @@ description: Install gitStream to your GitLab organization.
17
17
When setting up IP allowlists in GitLab, you're specifying which source IP addresses are permitted to interact with your repositories and APIs. This affects both gitStream and your CI/CD runners.
18
18
19
19
There are two primary cases where this matters for gitStream:
20
+
20
21
1. **Webhook Event Handling by gitStream**
21
22
When GitLab triggers a webhook event (e.g., a merge request opened), gitStream may need to make follow-up API calls to GitLab. This can include fetching additional metadata, posting comments to the MR, or performing other actions. These calls are made from the LinearB/gitStream service, which uses a fixed set of IP addresses. These IPs must be added to your GitLab allowlist to ensure proper operation.
23
+
22
24
2. **Outbound Requests from Your CI Runner**
23
25
When your pipeline runs gitStream, that runner might also make outbound calls to GitLab—for example, to clone a repository or retrieve commit history. These requests will originate from the runner's IP address.
24
26
@@ -36,11 +38,11 @@ GitLab Installation Overview
36
38
1. Designate a gitStream user account.
37
39
1. Create a `cm` repo and `.cm` configuration file.
38
40
1. Create a GitLab pipeline.
39
-
1. Connect gitStream in LinearB.
41
+
1. Connect gitStream in LinearB.
40
42
41
43
## Designate a gitStream User Account
42
44
43
-
gitStream automation rules are executed on behalf of the user account configured when you install the gitStream service. This account must have the `maintainer` or `owner` role to the relevant repos.
45
+
gitStream automation rules are executed on behalf of the user account configured when you install the gitStream service. This account must have the `maintainer` or `owner` role to the relevant repos.
44
46
45
47
We recommend creating a [dedicated service account](https://docs.gitlab.com/ee/user/profile/service_accounts.html){:target="_blank"} to control access to individual repos easily. You can also use your professional or personal GitLab account for this, which would result in all automations being executed under that account, which might also affect LinearB's metrics.
46
48
@@ -68,7 +70,7 @@ Once your gitStream configuration file is set up, you need a GitLab CI configura
68
70
=== "GitLab-Hosted runners"
69
71
70
72
**Gitlab-Hosted Runners**
71
-
73
+
72
74
Use the following `.gitlab-ci.yml`
73
75
74
76
``` yaml+jinja
@@ -86,14 +88,14 @@ Once your gitStream configuration file is set up, you need a GitLab CI configura
86
88
``` yaml+jinja
87
89
--8<-- "docs/downloads/gitlab-shell-ci.yml"
88
90
```
89
-
91
+
90
92
=== "Self-Managed Runners - Kubernetes"
91
93
**Self-Managed Runners**
92
94
93
95
First, [register the runner](https://docs.gitlab.com/runner/register/){:target="_blank"} with a tag, and use the named tag in the `.gitlab-ci.yml` file
94
96
95
97
**Kubernetes executors**
96
-
98
+
97
99
1. Ensure your runner configuration (`config.toml` for example) has the followig:
98
100
``` yaml
99
101
[runners.kubernetes]
@@ -111,7 +113,7 @@ Once your gitStream configuration file is set up, you need a GitLab CI configura
0 commit comments