Source Control

Source Control allows you to track and manage updates to your code. It gives you the control to manage the right version of the code. PCC allows your to setup Source Control to your projects.

For compliance reasons, the Linux Foundation platform needs to have access to each GitHub organization you use to host your code. Your governance body and authorized community members will still be responsible and accountable for day-to-day administration of repositories, teams, and users, unless covered by a specific managed-services-agreement with the Linux Foundation.

You can setup the following Source Controls tools to your projects:

• GitHub

• GitLab

Setting up GitHub

You can use GitHub as a source control tool to manage your project.

To setup the GitHub account to your project, perform the following steps:

1.Login into PCC.

2. Search for the required project. The Project dashboard appears. Click Source Control from the IT SERVICES STATUS tab.

You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Source Control.

Source Control

3.The Source Control page appears. Click GitHub and click the icon available in front of Connect.

GitHub

4.The Connect GitHub Organization dialog box appears. Enter the Organization Name and click Connect.

Make sure to enter a valid GitHub organization name.

GitHub Organization Name

• For more information on how to create an organization, refer Create an Organization.

• For more information on how to transfer a repository, refer Transfer a Repository.

5.Once the connection is setup, you can see the status of GitHub project and its repositories.

GitHub Status

If the Organization name is changed in the GitHub, you need to connect the renamed organization again. The renamed organization wont be automatically connected even though the organization with the old name was connected.

Invite users to your Organization

Your project should have its own GitHub organization, separate from your company's GitHub organization, and which is not shared with other, non-Linux-Foundation projects. If you need to, create a new GitHub organization for this project, and have a user who is an owner in both organizations transfer each project repository to this organization.

Then, invite the user “thelinuxfoundation” as an owner at the organization level (not per repository) to the GitHub organization, and connect them in Project Control Center.

• For more information on how to invite users to join organization, refer Invite Users to an Organization.

• For more information on how to transfer a repository, refer Transfer a Repository.

Deleting a GitHub Organization

You can delete the added GitHub organization from the PCC.

To delete the GitHub organization that is added in the PCC, perform the following:

1.Login into PCC.

2.Click the Source Control.

3.Under GitHub, click on the required GitHub organization that you want to delete.

GitHub Organization

4.Click the icon and click Disassociate.

Disassociate

5.The Confirm Disassociation dialog box appears, click Delete to delete the GitHub Organization.

Delete

Setting up GitLab

You can use GitLab as a source control tool to manage your project.

To setup the GitLab account to your project, perform the following steps:

1.Login into PCC.

2. Search for the required project. The Project dashboard appears. Click Source Control from the IT SERVICES STATUS tab.

You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Source Control.

Source Control

3.The Source Control page appears. Click GitLab and click the icon available in front of Connect.

GitLab

4.The Connect GitLab Group dialog box appears. Enter the Group Name and click Connect.

GitLab Group Name

5.Once the connection is setup, you can see the status of GitLab project and its repositories.

GitLab Status

​

​

​