Add gitlab.com integration for staging

jimmyjayp · jimmyjayp · commit 6b7b6e127192 · 2022-01-31T00:35:58.000-05:00
diff --git a/api_server/docs/integrations/gitlab.md b/api_server/docs/integrations/gitlab.md
@@ -1 +1,37 @@
 # Gitlab Integration
+
+## Gitlab Cloud (gitlab.com)
+
+### Gitlab / OAuth
+
+The Gitlab.com integration for CodeStream implements the standard OAuth
+procedure which requires a dedicated OAuth application on Gitlib.com with the
+appropriate settings.
+
+1. Login to Gitlab.com
+
+1. `Settings > Applications`
+    1. Set the **Redirect URL (callback URL)** to for your API's URL (similar to
+       `https://api.codestream.us/no-auth/provider-token/gitlab`)
+
+    1. Select the Confidential, Expire AccessTokens and api Scopes checkboxes
+       (all three).
+
+    1. Create the application. Take note of the **Application ID** and
+       **Secret**.
+
+1. Add the credentials to the CodeStream server's config file in the
+   `intergrations` section.
+    ```
+    {
+        "integrations": {
+            "gitlab": {
+                "cloud": {
+                    "appClientId": "***************************",
+                    "appClientSecret": "*************************",
+                    "disabled": false
+                }
+            }
+        }
+    }
+    ```
diff --git a/shared/codestream_configs/profiles/cloud.json b/shared/codestream_configs/profiles/cloud.json
@@ -205,7 +205,9 @@
 				"prod": {
 					"_loadSecretsFile": "gitlab/prod.cfg"
 				},
-				"stg": {}
+				"stg": {
+					"_loadSecretsFile": "gitlab/stg.cfg"
+				}
 			}
 		},
 		"jira": {
