Apply for invite to IaCP

VCS Integration

Overview

Scalr can be integrated with version control system (VCS) providers to add powerful capabilities to the platform.

Each account and environment can integrate with multiple VCS providers to provide the following capabilities:

  • Link to Terraform templates for template registry offerings.

  • Link workspaces to a VCS repository to enable automated deployment and dry runs triggered by commits pull requests (PR’s).

  • Register Terraform modules to make it easy to share and consume these modules across multiple Templates

Currently supported VCS’s:

  • github Github SaaS

  • github Github Enterprise

  • gitlab Gitlab SaaS

  • gitlab Gitlab CE/EE

  • azure_dos Azure Devops Services

  • bitbucket Bitbucket cloud

VCS Provider Configuration

SCOPE_ACC SCOPE_ENV

Github

A Github VCS Provider is authenticated against an OAuth application.

  1. Create new VCS Provider and select Github or Github Enterprise from the “Type” drop down

    ../_images/new_github_1.png

Note

For Github Enterprise you will need to enter the URL of your Github system.
GHE

  1. Copy the callback URL, click the “register a new OAuth application” link and register a new OAuth app in Github

    ../_images/gh_oauth.png
  2. Copy the client ID and client secret and go back to Scalr

    ../_images/new_github_2.png
  3. When you click “create” you will be redirected back to Github to complete the authorisation.


Gitlab

A Gitlab VCS provider is authenticated against an OAuth application.

  1. Create new VCS Provider and select Gitlab or Gitlab CE/EE from the “Type” drop down

    ../_images/new_gitlab_1.png

Note

For Gitlab CE/EE you will need to enter the URL of your Github system.
GLE

  1. Copy the callback URL, click the “register a new OAuth application” link and register a new OAuth app in Gitlab

    • Check the following options

      • Confidential

      • api

      • read_repository

      • profile

        ../_images/gl_app_1.png
      • Allow requests to the local network from web hooks and services

      • Allow requests to the local network from system hooks

        ../_images/gl_app_4.png
  2. Save and then copy Application ID and Secret

    ../_images/gl_app_2.png
  3. Go back to IaCP, enter the Id and secret

    ../_images/gl_app_3.png
  4. When you click “create” you will be redirected back to Gitlab to complete the authorisation.


Azure Devops Services

An Azure Devops Services VCS provider is authenticated against an OAuth application.

  1. Create new VCS Provider and select Azure Devops Services from the “Type” drop down

    ../_images/new_azdos_1.png
  2. Copy the callback URL, click the “register a new OAuth application” link and register a new OAuth app in Azure Devops

    • Below is an example app configuration

    • Only two scopes are required for Scalr, Code (read) and Code (status)

      ../_images/azure_dos_scopes.png
  3. Click Create and then copy the Application ID and Client Secret

    ../_images/azure_dos_secrets.png
  4. Go back to IaCP, enter the Id and secret

    ../_images/new_azdos_2.png
  5. When you click “create” you will be redirected back to Azure Devops to complete the authorisation.


Bitbucket

A Bitbucket VCS provider is authenticated against an OAuth application.

  1. Create new VCS Provider and select Bitbucket from the “Type” drop down

    ../_images/bitbucket_1.png
  2. Copy the callback URL

  3. Login to Bitbucket in a new window and register a new OAuth consumer (Settings –> OAuth)

    • Copy in the call back URL

    • Set the permissions as shown below

      ../_images/bitbucket_2.png
  4. Click Save and then copy the Application ID and Client Secret

    ../_images/bitbucket_3.png
  1. Go back to IaCP, enter the Id and secret

    ../_images/bitbucket_4.png
  2. When you click “create” you will be redirected back to Bitbucket to complete the authorisation.