Skip to content

Latest commit

 

History

History
103 lines (81 loc) · 3.46 KB

sync-with-gitlab.mdx

File metadata and controls

103 lines (81 loc) · 3.46 KB
title description icon
Sync With GitLab
Integrate Amplication with GitLab for streamlined git management for all your resources.
gitlab

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:

Access your workspace within the Amplication platform. Find and select the "Projects" tab in the navigation bar. Click on your desired project to access its Software Catalog, where you can manage all services and resources. Select the **Git Settings** tab. If a repository is already connected, click **Change Repository** After clicking "Change Repository", select "Select Git Organization" to choose a new GitLab organization for your repository.

Authorization and Repository Setup

When selecting GitLab, you'll be redirected to GitLab's authorization page where you'll grant Amplication the necessary permissions. 
<Frame>
  <img src="/images/day-zero/authorize-gitlab.png" />
</Frame>
After authorization, choose one of two options: 
<CardGroup cols={2}>
  <Card title="Use Existing Repository" icon="book">
    Select from your available GitLab repositories in the repository selection modal
  </Card>

  <Card title="Create New Repository" icon="plus">
    Click the "Create repository" button to set up a fresh GitLab repository
  </Card>
</CardGroup>

<Frame caption="Select existing GitLab repo">
  <img src="/images/day-zero/select-gitlab-repo.png" />
</Frame>

Working with Merge Requests

Update your resource in Amplication like editing service settings, adding an entity, or updating an API endpoint. 1. Access the pending changes sidebar in your [Software Catalog](/day-two/software-catalog/). 2. Click "Generate the code" to initiate the build process

Next Steps

Learn about project-level and resource-level Git settings and how to configure them for your resource. Understand how to track and monitor your changes, builds, and deployment history. Learn about Amplication's Smart Git Sync integration features, including branch management and merge request workflows.