Connect Spryker Code Upgrader to a GitLab managed project

There are two options for connecting Spryker Code Upgrader to your repository: using the native integration or using an access token.

Connect Spryker Code Upgrader using the native integration

1. In the Upgrader UI, go to Projects.
2. On the Projects page, select the Spryker Upgrade Service project.

3. Go to Code.

4. In the Connect Git repository pane, for GIT HOSTING PROVIDER, select GitLab.

5. For ADD GITLAB INTEGRATION select +. This opens GitLab in a new window.

6. To authorize Buddy CI to access your account, click Authorize. Your account should have administrator rights in the repository you want to connect.

7. For GROUP, select the GitLab group that has access to the repository you want to connect.

8. For REPOSITORY, select the repository you want to connect. This displays a success message. The Upgrader is now connected to your repository.

Connect Spryker Code Upgrader using the GitLab access token

To connect the Upgrader manually using the GitLab access token, take the following steps.

Prerequisites

Create a GitLab access token

GitLab access token should have the following repository permissions:

• api for Spryker CI: grants complete read and write access to the scoped project API, including the Package Registry.

• write_repository for Spryker Upgrader Service: grants read and write access to the repository to enable the Upgrader to analyze the project and create PRs.

Configure the integration with GitLab

1. In the Upgrader UI, go to Projects.
2. On the Projects page, select the Spryker Upgrade Service project.

3. Go to Integrations.
4. On the Integrations page, click New integration.

5. On the New integration page, click the Git tab.
6. Select GitLab.

7. On the Add new GitLab integration page, enter a NAME.
8. Select SHARING and AVAILABILITY per your requirements.
9. For AUTHORIZATION METHOD, select Access Token.
10. For ACCESS TOKEN, enter the GitLab access token.

11. Click New integration. This connects the Upgrader to your GitLab organization.

12. To select the needed repository, go to Code.

13. On the Switch repository or Git hosting provider page, click the GitLab tab.

14. Select a REPOSITORY to connect the Upgrader to. This displays the message about a successful update. Now the Upgrader is connected to the repository.

Next steps

Set the target branch for the Upgrader