Connect the Spryker CI to a GitLab managed project

There are two options for connecting Spryker CI to your repository: using Spryker CI’s native integration or using an access token.

Connect using Spryker CI native integration

1. In Spryker CI, 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 GitLab access token

To connect the Upgrader manually using a GitLab access token, follow the 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 connection in Spryker CI

1. In Spryker CI, 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.

Support for Spryker CI

• For help with Spryker CI, contact support.
• To learn more about Buddy, see their docs.

Next steps

Run Spryker Code Upgrader