Creating an OAuth Token for FlexDeploy ITS

1. Go to GitLab and log in as the user you want to comment on GitLab Issues with.

2. Generate a Personal Access Token in GitLab following this guide: Personal access tokens | GitLab Docs

3. Choose an expiration date based on your security policies. Shorter expiration dates will require updating the ITS more frequently.

4. Choose the following OAuth scopes to comment on and change status of issues:

Open

GitLab ITS Instances

A GitLab instance looks like this:

Open

Setting Up Folders and Projects to Use the GitLab ITS Instance

Then back in FlexDeploy, set up your folder and project Issue Tracking settings.

GitLab Issues only accept statuses of open and closed. Other statuses will be ignored.

Linking GitLab Issues to FlexDeploy Builds

Now you are ready to link tickets with commits or by manually entering them on project builds or project packages.

Linking with Commit Messages

Set up your FlexDeploy Project with a ticket pattern. The pattern must be GitLab repo name + “-” + issue number.

Following this pattern, make a commit message.

Open

Push and merge your change.

When you request a build, the issue numbers are automatically pulled from your commits and linked.

Open

Linking by Manual Entry at Project Build Time

If you are building the project manually, you can enter issue numbers at build time.

The issue number should be GitLab Repo Name-Issue Number

Open

Linking Issues to Project Packages

If you are working with a package-based project, you can associate issues with packages that will live through its build and deployment lifecycle.

Add one or more Issues by clicking the edit package button on the right panel. Add one or more Issues. The dropdown only shows previously linked issues. Type the entire issue key to make a new one. The issue number should be in the format GitLab Repo Name-Issue Number. After saving, all builds and deployments of this package will automatically be associated to that GitLab Issue.

Open