An Amplication-generated GitHub MR

Amplication provides seamless git integration with GitLab. With this integration, you can use GitLab’s fully-featured version control to manage the generated code for all your resources.

Connect Your GitLab Organization

To get started, you must connect your GitLab organization to Amplication. Follow these steps:

1

Navigate to Your Amplication Workspace

Access your workspace within the Amplication platform.

2

Select the 'Projects' Tab

Find and select the “Projects” tab in the navigation bar.

3

Select a specific project's 'Software Catalog'

Click on your desired project to access its Software Catalog, where you can manage all services and resources.

4

Select the 'Git Settings' Tab

Select the Git Settings tab. If a repository is already connected, click Change Repository

5

Select Git Organization

After clicking “Change Repository”, select “Select Git Organization” to choose a new GitLab organization for your repository.

Adding a GitLab organization

Authorization and Repository Setup

1

Authorize Access

When selecting GitLab, you’ll be redirected to GitLab’s authorization page where you’ll grant Amplication the necessary permissions.

2

Configure Repository

After authorization, choose one of two options:

Use Existing Repository

Select from your available GitLab repositories in the repository selection modal

Create New Repository

Click the “Create repository” button to set up a fresh GitLab repository

Select existing GitLab repo

Working with Merge Requests

1

Make Changes

Update your resource in Amplication like editing service settings, adding an entity, or updating an API endpoint.

2

Generate Code

  1. Access the pending changes sidebar in your Software Catalog.
  2. Click “Generate the code” to initiate the build process

Next Steps