Last updated: 2022-06-10

Source: https://support.freshservice.com/support/solutions/articles/50000003561-installation-guide-for-gitlab-orchestration-app

Overview

Perform operations on Gitlab users, groups, and projects via Workflow Automator

Description

Orchestration apps let you automate repeatable tasks and actions that span across a diverse set of systems and applications using workflows. The list of actions supported for this app include:

User Management

1. Lookup user by email

2. Lookup user by username

3. Get user by id

Project Management

1. Lookup project

2. Update project

3. Delete project

4. Create project

Group Management

1. Add user to group

2. Remove user from group

3. Add user to multiple groups

4. Remove user from multiple groups

5. Lookup Group by name

Prerequisites

Create a Personal access token from your Gitlab account:

1. In the top-right corner, select your avatar.

2. Select Edit profile.

3. In the left sidebar, select Access Tokens.

4. Enter a name and optional expiry date for the token.

5. Select all the Scopes.

6. Select Create personal access token.

Save the personal access token somewhere safe. After you leave the page, you no longer have access to the token.

App Installation Parameter

To install and authenticate the app in Orchestration Center, the following inputs are to be provided:

1. Config Name \- Give your connection to Gitlab a name to identify which account you are connecting to.

2. GitLab URL \- The URL of the GitLab instance. For example https://example.gitlab.com

Note: This parameter is required only for GitLab on-prem orchestration app.

3. Access Token - The Personal access token of the Gitlab account. Follow the above-mentioned steps to obtain the same

Usecases

Now that you've successfully installed the GitLab orchestration app, please have a look at the sample use case below to show how the app can be used efficiently.

  • Sample Use Case for GitLab Orchestration App- Automate Gitlab Project Requests