GitLab Duo with Amazon Q

{{< details >}}

  • Tier: Ultimate
  • Add-on: GitLab Duo with Amazon Q
  • Offering: GitLab Self-Managed

{{< /details >}}

{{< history >}}

  • Introduced as beta in GitLab 17.7 with a flag named amazon_q_integration. Disabled by default.
  • Feature flag amazon_q_integration removed in GitLab 17.8.
  • Generally available in GitLab 17.11.

{{< /history >}}

{{< alert type=”note” >}}

If you have a GitLab Duo Pro or Duo Enterprise add-on, this feature is not available.

{{< /alert >}}

At Re:Invent 2024, Amazon announced the GitLab Duo with Amazon Q integration. With this integration, you can automate tasks and increase productivity.

To get a subscription to GitLab Duo with Amazon Q, contact your Account Executive.

Set up GitLab Duo with Amazon Q

To access GitLab Duo with Amazon Q, request access to a lab environment.

Alternately, if you have GitLab 17.11 or later, you can set it up on your GitLab Self-Managed instance.

Use GitLab Duo with Amazon Q in an issue

To invoke GitLab Duo with Amazon Q for an issue, you will use quick actions.

Turn an idea into a merge request

Turn an idea in an issue into a merge request that contains the proposed implementation.

Amazon Q uses the issue title and description, along with project context, to create a merge request with code to address the issue.

From the issue description

  1. Create a new issue, or open an existing issue and in the upper-right corner, select Edit.
  2. In the description box, type /q dev.
  3. Select Save changes.

From a comment

  1. In the issue, in a comment, type /q dev.
  2. Select Comment.

Upgrade Java

Amazon Q can analyze Java 8 or 11 code and determine the necessary Java changes to update the code to Java 17.

View a walkthrough.

Prerequisites:

To upgrade Java:

  1. Create an issue.
  2. In the issue title and description, explain that you want to upgrade Java. You do not need to enter version details. Amazon Q can determine the version.
  3. Save the issue. Then, in a comment, type /q transform.
  4. Select Comment.

A CI/CD job starts. A comment is displayed with the details and a link to the job.

  • If the job is successful, a merge request with the code changes needed for the upgrade is created.
  • If the job fails, a comment provides details about potential fixes.

Use GitLab Duo with Amazon Q in a merge request

To invoke GitLab Duo with Amazon Q for a merge request, you will use quick actions.

Review a merge request

Amazon Q can analyze your merge request and suggest improvements to your code. It can find things like security issues, quality issues, inefficiencies, and other errors.

  1. Open your merge request.
  2. On the Overview tab, in a comment, type /q review.
  3. Select Comment.

Amazon Q performs a review of the merge request changes and displays the results in comments.

Make code changes based on feedback

Amazon Q can make code changes based on reviewer feedback.

  1. Open a merge request that has reviewer feedback.
  2. On the Overview tab, go to the comment you want to address.
  3. Below the comment, in the Reply box, type /q dev.
  4. Select Add comment now.

Amazon Q proposes changes to the merge request based on the reviewer’s comments and feedback.

Generate unit tests

Generate new unit tests while you’re having your merge request reviewed. Amazon Q surfaces any missing unit test coverage in the proposed code changes.

To generate unit tests for all code changes:

  1. Open your merge request.
  2. On the Overview tab, in a comment, type /q test.
  3. Select Comment.

Amazon Q populates a comment with the suggested tests.

Create test coverage for selected lines

Generate new unit tests for specific lines of code in your merge request.

To create test coverage for selected lines:

  1. Open your merge request.
  2. On the Changes tab, select the lines you want to test.
  3. In the comment, type /q test.
  4. Select Add comment now.
  • If the merge request includes a test file, it is updated with the suggested tests.
  • If the merge request does not include a test file, Amazon Q populates a comment with the suggested tests.

Additional supported features

In addition, these features are available on GitLab Duo with Amazon Q.

Feature GitLab version
GitLab Duo Chat GitLab 17.11 and later
Code Suggestions GitLab 17.11 and later
Code Explanation GitLab 17.11 and later
Test Generation GitLab 17.11 and later
Refactor Code GitLab 17.11 and later
Fix Code GitLab 17.11 and later
Root Cause Analysis GitLab 17.11 and later
Discussion Summary GitLab 17.11 and later
Vulnerability Explanation GitLab 17.11 and later
Vulnerability Resolution GitLab 17.11 and later