GitLab Duo with Amazon Q

Tier: Ultimate Offering: Self-managed Status: Preview/Beta
History
  • Introduced as beta in GitLab 17.7 with a flag named amazon_q_integration. Disabled by default.
The availability of this feature is controlled by a feature flag. For more information, see the history. This feature is Preview/Beta and is available for testing, but not ready for production use.

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

On December 3, 2024, the private fork of the GitLab codebase where Amazon and GitLab have been collaborating on the integration was unveiled. Select GitLab customers have been invited to a test GitLab instance so they can start to experiment right away.

Set up GitLab Duo with Amazon Q

To access GitLab Duo with Amazon Q, you must request access to a lab environment. Alternately, you can set up the GitLab Development Kit.

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.

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.

Apply code changes based on feedback

Amazon Q can suggest code changes based on feedback in a specific merge request comment.

  1. Open a merge request that has reviewer feedback.
  2. On the Overview tab, go to the comment you want to address.
  3. Type /q fix.
  4. Select Add comment now.

Amazon Q proposes changes for the specific comment.

Create test coverage

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 create test coverage:

  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.