Contents

Connecting Xcode Cloud to GitLab

Allow Xcode Cloud to access your GitLab repository.

Overview

When you first configure your project or workspace to use Xcode Cloud, you need to allow Xcode Cloud to access your Git repository. It uses this access to automatically build and test your code when you make changes to the codebase.

The person who first configures a project or workspace to use Xcode Cloud must have the maintainer role for the GitLab repository. If you don’t have this role, see Connect Xcode Cloud to an admin-managed Git repository.

To allow Xcode Cloud to access your repository on GitLab:

  1. Configure your project or workspace to use Xcode Cloud and create your first workflow as described in Configuring your first Xcode Cloud workflow. Xcode analyzes your project to learn which SCM provider you use and indicates that you use GitLab on the Grant Access to Your Source Code sheet.

  2. Click Grant Access. Xcode opens your browser and takes you to the App Store Connect website.

  3. Click “Authorize in GitLab” to open the GitLab website and install a GitLab app that manages access to your GitLab repository.

  4. Review the permissions that Xcode Cloud requests and allow it to access your account. This takes you back to the App Store Connect website, which indicates that you successfully connected Xcode Cloud to GitLab.

  5. Return to Xcode. It indicates that Xcode Cloud can access your source code.

  6. Click Next, complete the configuration of your first workflow, and start your first build.

See Also

GitLab