Skip to main content

Connecting gitStream to GitLab in LinearB

Integrate gitStream with your GitLab account in LinearB

Steven Silverstone
Updated by Steven Silverstone

Overview

To integrate gitStream with your GitLab account in LinearB, follow these steps:

  1. Connect gitStream
  2. Create a CM Repository with Your CI Script
  3. Set Up Automation Rules

When using gitStream with GitLab, all automations are executed under the GitLab account that was initially connected to LinearB. It is recommended to use a dedicated service account (e.g., gitStream-cm) to provide better clarity and tracking of automated actions.

Step 1: Connect gitStream to GitLab

  1. Navigate to Settings > Git in LinearB.
  2. Click Connect gitStream next to your GitLab integration.
  • You can either use an existing GitLab integration or create a new one if needed.

Step 2: Create a CM Repository with Your CI Script

  1. In GitLab, create a new repository (CM project) within the same group or a parent group of the target repositories.
  2. In the default branch (usually main or master), create a .gitlab-ci.yml file.
  3. Add the necessary CI configuration found here: gitStream GitLab CI Configuration.

Step 3: Set Up gitStream Automation Rules

You can configure gitStream automation rules for either a single repository or for your entire GitLab organization. Select the appropriate option below based on your needs:

Single Repository Configuration

  1. In your repository's default branch (typically main or master), create a file with a name ending in .cm (e.g., gitstream.cm).
  2. This file should be placed within a .cm directory.
  3. Inside this file, define the YAML configuration that specifies the workflows and automation rules to be applied to this specific repository.
  4. You can name the file anything, as long as it ends with .cm to ensure gitStream recognizes it.

Organization-Level Configuration

  1. For organization-wide rules, create a gitstream.cm file in the root directory of your CM repository's default branch (usually main or master).
  2. This file will contain a YAML configuration that determines the workflows and automation rules applicable across all repositories within your GitLab organization.
  3. As with the single repository configuration, the file can be named anything as long as it ends in .cm.

By setting up these automation rules, you can define custom workflows tailored to individual repositories or implement standardized processes across your entire organization.

Step 4: Connect Repositories to gitStream

  1. Connect the CM repository you created.
  2. Select additional repositories that you want gitStream to monitor.
    • You can choose all repositories or specific ones.

Additional Resources

How did we do?

gitStream Documentation

Contact