Connect a code repository

This document describes how to connect a code repository to Spryker Cloud Commerce OS.

Spryker supports the following version control systems:

• GitHub
• Bitbucket
• GitLab

Spryker also supports all the Git repositories that support AWS CodeCommit push mirroring. Similar to the GitLab setup, you can configure all the commits from your version control system to be mirrored to Spryker and consumed by our pipelines to build and deploy your system.

We recommend mapping your branches to environments as follows:

Connect a GitHub code repository

1. Log into the AWS management console of the environment you want to connect a repository to.
2. Go to CodePipeline.
3. One the Pipelines page, select the pipeline you want to connect the repository to.
4. On the page of the pipeline, click Edit. This opens the pipeline editing page.
5. In the Edit: Source pane, click Edit stage.
6. In the Spryker_App_Src section, click the Edit action button. This opens the Edit action window.

7. For Action provider, select GitHub(via GitHub App). This adds GitHub related fields to the window.
8. Click Connect to GitHub and authorize AWS CodePipeline to access your GitHub repository.
9. For Repository name, enter and select the repository you want to connect.
10. For Branch name, enter and select the branch you want to connect.
11. Click Done.
12. In the Edit: Source pane, click Done.
13. Scroll up and click Save.
14. In the Save pipeline changes window, click Save.

Your GitHub repository is now successfully connected!

Connect a Bitbucket code repository

Currently, only GitHub is integrated into AWS CodeBuild. To use a Bitbucket code repository, configure AWS CodeStar by following the steps below.

Prerequisites

Ensure that your BitBucket account has Admin permissions in the code repository.

AWS CodeStar integrates via OAuth 2.0 and requires the following permissions:

• Read your account information.

• Read your repositories and their pull requests.

• Administer your repositories.

• Read and modify your repositories.

Retrieve a connection ARN

To get an Amazon Resource Name (ARN) of a connection, create a CodeBuild Connection:

1. In the AWS Management Platform, go to Services > CodeBuild > Settings > Connections.
2. Select Create connection.
3. In the Create a connection pane, select BitBucket.
4. Enter Connection name.

5. Select Connect to Bitbucket.

6. Select Grant access.

7. Select Install a new app.

8. Select Grant access.

9. In the Connect to Bitbucket pane, select Connect.

The page refreshes with all the fields cleared.

10. Select Connections.

In the Connections pane, you can see the created connection and its ARN.

11. Provide the connection ARN via support.

We connect the repository shortly after you provide the details.

Connect a GitLab code repository

Currently, CodePipeline doesn’t have a native integration of GitLab. To make it work, you can configure a CodeCommit repository as a mirror of a GitLab repository.

Prerequisites

Prepare for configuration:

1. Ensure that your GitLab account has Admin permissions in the code repository.
2. Request the following details via support:
   • CodeCommit repository URL
   • Username and password for HTTPS authorization in CodeCommit repository

GitLab mirroring

To configure GitLab mirroring:

1. In the GitLab account, go to the code repository.
2. Select Settings > Repository.
3. Select Expand next to Mirroring repositories.

4. In Git repository URL, enter the CodeCommit repository URL provided by support.
5. For Mirror direction, select Push.
6. For Authentication method, select Password.
7. Enter a Password.
8. Select Mirror repository.

Allow the synchronization several minutes to complete and you should see the record of your mirrored repository.

Next step

Deployment pipelines