Add a GitLab Repository

If your repository lives in GitLab, you can connect your repository automatically, or connect via SSH if you prefer.

If you prefer SSH, buddybuild automatically generates a secure SSH key for you to install into your source control system. Buddybuild uses this key to clone your repository.

Important

Buddybuild has first-class integrations with the following repo providers:

Buddybuild’s integrations provide the following features:

  • Commit status updates

  • Support for pull request workflows

  • Integration with issue tracking

  • Selective builds

  • Federated login

  • Automated access management

  • Ability to select from available repositories

If you choose to use SSH to connect to your repo, buddybuild can only access your repository’s file content, and the features noted above do not work.

Let’s get started!

Step 1: Enter the SSH Git Clone URL

Within the main page of your repository, look to the middle of the page for the HTTPS/SSH dropdown. Click it and select SSH (if it is not already selected).

A GitLab project screen, selecting SSH

Highlight and copy the SSH URL.

A GitLab project screen, copying the clone URL

Head over to dashboard, visit Select source and choose SSH.

The buddybuild Select source screen

Paste the SSH URL you copied into the Git clone URL field.

The buddybuild Connect another Git service screen

Step 2: Add the SSH Key to Your GitLab Account

Highlight and copy the generated SSH key.

The buddybuild Connect another Git service screen, with the SSH key selected

Navigate to your Profile Settings by first selecting the menu icon in the top left corner.

A GitLab project screen, showing the menu icon

In the menu that slides out, select Profile Settings.

A GitLab project screen, showing the opened application menu with Profile Settings selected

Next, select SSH Keys.

The GitLab Profile Settings screen

Add a new SSH Key by pasting the copied SSH key into the Key field, and entering Buddybuild as the title.

The GitLab SSH Keys screen

Next, click Add Key.

The buddybuild Connect another Git service screen

Warning

Private git submodules and private cocoapods

If your project depends on any code in other private git repos, the SSH key needs to be added to those repos as well.

Navigate back to buddybuild and click on the Build button.

The buddybuild Connect another Git service screen

Buddybuild clones your project code and starts a simulator build. The build should finish within a few minutes.

That’s it! Your GitLab repository is now connected to buddybuild, and your first build is under way. The next steps are:

results matching ""

    No results matching ""