GitLab

GitLab is an open source end-to-end software development platform with built-in version control, issue tracking, code review and more. This document describes how to connect IBM watsonx Orchestrate to GitLab and use its skills on watsonx Orchestrate.

Before you begin

To connect watsonx Orchestrate to GitLab, make sure that you have a GitLab account. If you don't have a GitLab account, you can create one at try GitLab for free.

Connecting to GitLab

Important:
- A credential type must be set for apps that are a part of team skill sets and AI assistants. Skill-based actions in AI assistants support only shared credentials.
- If a credential type of an app is not specified, an error message is displayed when users attempt to run the skills of the app. To resolve the error, an admin must set the credential type for the app. For more information, see Managing connections.

An app can be connected either through the skill catalog or through the watsonx Orchestrate chat. Use the method that suits you to connect to an app.

Connect to the app through the skill catalog when you add that skill to your skill set:

  1. On the watsonx Orchestrate chat page, click Add skills from the catalog.
  2. Search and click the app tile.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Otherwise, connect to that app through the watsonx Orchestrate chat when you use the skill:

  1. Open the watsonx Orchestrate chat.
  2. On the chat, start the skill.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Configuring the connection

To connect watsonx Orchestrate to GitLab, complete the following steps:

  1. Click Connect app.
  2. Specify the following connection details:
    • Specify the Endpoint URL of your GitLab instance.
    • Enter the Personal access token. To generate a personal access token, see Creating personal access tokens.
  3. Click Connect app.
Note: The icon A green check icon appears to show that the app is connected. indicates that the connection was successfully established.

Creating a personal access token

To create a personal access token, complete the following steps:

  1. Click your profile photo on the left sidebar, then click Edit profile.

  2. Select Access Tokens.

  3. Click Add new token.

  4. Specify the name of your token.

  5. Select an Expiration date, choose a default option or click Custom to enter a date.

  6. Select the required scopes. Scopes set the permission levels that are granted to the token.

  7. Click Create personal access token.

What to do next

After you connect to the app, you can use the GitLab skills. For more information see, Using the chat.

To learn about the available skills, see List of prebuilt apps, skills and skill flows.

Note: Before you use the Create a pipeline skill, ensure that the CI/CD (continuous integration and continuous delivery) is enabled and configured properly in GitLab settings as this skill relies on a correctly set up CI/CD configuration. The CI/CD configurations are prerequisites for successfully using the Create a pipeline skill.

Parent topic:

Connecting to apps