Get startedSign in

Connect a source control provider

Setting up an SCM Connection in Plural to integrate with Github, GitLab, or BitBucket

Overview

Plural has the ability to spawn pull requests, post review comments, and other functionality to integrate with your standard SCM (Source Control Management) workflows. The most impactful of these is the PR Automation api, which allows you to spawn templated pull requests to do common tasks like:

  • provision new clusters
  • drive deployment pipelines
  • in conjunction with Stacks, provision associated kubernetes or cloud infrastructure (databases, IAM, networks)

To get this working you'll first need to give your Plural Console scoped access tokens to your SCM.

Info:

If you're using Plural Cloud, this should have been installed for you by default as part of the setup wizard.

Prerequisites

Some things you'll need to run this tutorial:

  • Plural Console admin Permissions
  • SCM Provider Personal Access Token
  • SCM Provider Organization admin Permissions
    • This is only required when creating the webhook
    • The workload cluster can still be created without the SCM webhook

Create a New SCM Connection

Creating an SCM Connection is easiest just using our UI. You can then reference that created resource via k8s CRD to drive other workflows. Step by step, you'll want to: