Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note that there’s a confusing configuration dependency here:

MettleCI Workbench requires a GitLab Application ID in order to provide a Callback URL BUT a Callback URL is required by GitLab in order to provide you with an Application ID!

So, we address this by entering a provisional Callback URL and returning later to edit it with the actual Callback URL provided by the MettleCI Workbench.

  1. Got to From the menu icon on the top banner and select AdminApplicationsNew application

    Image Removed
  2. Name your application logically so GitLab administrators understand its function. Something like MettleCI Workbench {EngineName} might be a good example.

  3. For your Redirect URI start by enter a provisional URL following the example given below (substituting your DataStage Engine URI to appropriate values)

    • http://your-engine.your-org.com:PORT/api/auth/delegated/2

    • e.g http://demo115-engn.dm-demo-datastage.datamigrators.io:8080/api/auth/delegated/2

  4. Ensure the following checkboxes are selected:

    • Trusted

    • Confidential

    • Expire access tokens

    • Scopes

      • API

      • openid

...

For example…

...

  1. Click Save application and you’ll be presented with information about your registered application such as the Application ID, Secret, Callback URL, etc.

...

Note

You should keep this window open, to support you during the next configuration step, as…

  • You’ll need to copy and paste the Application ID and Secret values into the MettleCI Workbench, and

  • You may need to edit the GitLab Application Callback URL, depending upon what Workbench tells you in later configuration steps

...

  1. From the Profile icon in the top-right of the MettleCI Workbench window select the menu item Issue Management.

    Image Removed

  2. On the resulting page click the [+] icon, in the top-right, to add a new issue management system.

  3. Select GitLab as your Issue Management Type, then Next.

  4. On the next page enter

    1. A Name that will help you uniquely identify your GitLab instance,

    2. The URL of your GitLab instance

    3. The Application ID and Secret values you were presented by GitLab in the previous configuration step

  5. Once complete, click Next. You’ll be presented with your list of registered Issue Management Systems including your newly-defined GitLab instance

...

  1. Select Manage Projects from the Profile icon in the top-right of the Workbench window.

    Image Removed

  2. Select the pencil icon alongside the DataStage project with which you wish to use GitLab issue lookup

    Image Removed

  3. At the bottom of the project configuration page select your newly - defined GitLab Issue management Service then click Update Project.

    Image Removed

Test your GitLab Issue Lookup is working by Workbench

...