Extension - GitLab
The GitLab extension allows you to import mobile apps directly from GitLab into the Blue Cedar Platform, using Blue Cedar's GitLab Import service. Enabling this extension gives you access to the Import - GitLab step to the Setup & Analysis stage of your workflows, and allows you to detect from the Dashboard when new app binaries are available for import into your Blue Cedar Platform account. Click Add to enable, and click the gear icon to configure.
See Incorporating automatic app updates from GitLab for an overview of this feature.
Overview
This table presents a summary of the GitLab extension—what it provides, what you need to know about enabling and configuring it, and what are the corresponding workflow steps and other relevant topics. The rest of this page provides configuration details for the extension.
| Services provided by this extension | The GitLab import extension provides access to Blue Cedar's Import service, which allows you to import mobile apps from GitLab to the Blue Cedar Platform. |
|---|---|
| Extension configuration | Create a configuration for each project on gitlab.com that you want to import from. These projects can be private, in which case you need to add an access token to the configuration, or public. |
| Related workflow steps | Add an Import from GitLab step to the Setup & Analysis stage of your workflow. See Import from GitLab for details about the workflow step. |
| Other related topics | In addition to configuring the GitLab import extension and including the GitLab step in a workflow, the Import widget on the Dashboard lets you know when a new version of the app is ready for import from GitHub. You can set up a webhook for private repos to send an event notice to the Blue Cedar Platform. See Using the Dashboard and Incorporating automatic app updates from GitLab for details. |
Prerequisites
GitLab is a code hosting platform for collaboration and distribution. It is also a continuous integration tool for building, testing, and distributing app binaries.
You'll need to create a group name on gitlab.com. If you want to see proactive alerts on the Dashboard of the Blue Cedar Platform, you'll also need to request a Personal Access Token from the mobile app developer.
Enable GitLab
From the Blue Cedar Platform main menu, select Extensions > Import. The platform shows the available extensions.
Before users can add Import to workflows, you must enable an Import extension. On the Import page > GitLab card, click Add Extension.
Configure GitLab
The GitLab extension supports GitLab projects on the Community site. It does not currently support GitLab Enterprise projects.
Setting up a configuration for GitLab Community projects
To subscribe to a GitLab Community project, you need:
- Group name
- Access token (required to access private projects)
- Name of project where the app binary lands
On the GitLab card, click the gear icon.
- Click Add GitLab Config to open a dialog.
- Enter the Group Name on GitLab
- Enter your Access Token, and click Continue.
Choose which projects from the group's list to subscribe to.
- Choose whether to automatically subscribe to new projects added to the group.
Give each configuration a name: these names are available as choices when you add GitLab to a workflow.
Managing GitLab configurations
After setting up a configuration, you can enable or disable it from the GitLab configuration list. If you disable a configuration, it still exists but projects are no longer monitored. You can delete a configuration from the down-arrow menu to the left of the configuration name.
Next steps
The GitLab extension is now available in the Setup & Analysis stage of workflows. When you add GitLab to a workflow in the workflow builder, choose the configuration as configured above.
Related topics: