Add and Manage GitLab Groups

Before you can add or manage GitLab groups and projects, you must connect or add GitLab groups while setting up IT services. However, you can also add GitLab groups in the GitLab pane of Tools tab.

Note:

• In GitLab, organizations are mentioned as groups, and repositories are mentioned as projects.

• You must be the owner of the GitLab group which you want to connect for CLA mechanism.

• ​Add GitLab Groups​

• ​Enable Branch Protection and Auto Enable New Repositories​

• ​Disassociate GitLab Groups​

After you successfully add Git organizations, you can:

• ​View Connection Status of Git Organization and Repositories​

• ​Enforce or Remove CLA Mechanism from GitLab Projects​

• Manage the EasyCLA GitLab App on GitLab — review or revoke the OAuth authorization and re-authorize from your GitLab user settings

Add GitLab Groups

1. Sign in to the Project Control Center.

2. Click a project of interest.

3. Scroll down to the Tools Status section, and click EasyCLA.

Note: You can also connect the GitLab groups during IT setup in the IT Services Status section, and then install the EasyCLA application in the Tools Status section to add it for the CLA process.

4. Under CLA Groups, select a CLA group to which you have added the project.

5. Click Manage next to the project for which you want to manage repositories.

Add and Manage Repositories

6. Under the GITLAB tab, click the + sign at the top right of ADD GITLAB GROUP.

Add GitLab Group

7. Provide the complete URL of the GitLab group, as shown in the image, in the Enter GitLab Group URL field, and click Connect.

Connect GitLab Group

8. Click Install GitLab EasyCLA App.

Install GitLab EasyCLA App

9. Click Authorize.

10. After GitLab shows the success page, close that tab, return to the Project Control Center, and click I'm Done Installing.

Note: If you have already authorized the GitLab installation previously, GitLab may skip the authorization page and go directly to the success page. If you do not click I'm Done Installing, you will have to reinstall the EasyCLA application.

GitLab I am done Installing

Note:

1. LFX EasyCLA adds all the projects, including projects under subgroups, of the GitLab group to the Project Control Center.

2. To enable a CLA mechanism on a project, you must enforce CLA mechanism for GitLab projects. Simply adding a GitLab group to the project does not enable the EasyCLA mechanism for any GitLab project.

3. To review the configuration or revoke the application, navigate to the GitLab Applications under your User Settings. For step-by-step instructions, see Manage the EasyCLA GitLab App on GitLab.

Enable Branch Protection and Auto Enable New Repositories

After adding the GitLab group, you should enable branch protection and auto enable new repositories.

• Enable Branch Protection automatically enables the EasyCLA check for each GitLab project's default branch. If non-default branches also require EasyCLA protection, configure those branches manually in GitLab. If you select this check box, you do not need to enable branch protection manually for the default branch.

• Auto Enable New Repositories automatically adds a repository under the GitLab group on the project console when you add a project to the GitLab group.

To enable branch protection and auto enable new repositories:

1. Click the settings icon next to Additional Settings for a GitLab group.

2. Click both the check boxes, and click Save Changes.

Additional Settings GitLab

Disassociate GitLab Groups

Note: To disassociate a GitLab group, you must disable CLA from all projects of the GitLab group.

Disassociate GitLab Group disabled for CLA enforced Projects

1. Click the settings icon next to Additional Settings for a GitLab group.

2. Click Disassociate GitLab Group, and click Disassociate on the confirmation window.

Disassociate GitLab Group