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 you to setup Source Control for 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:
Setting up GitHub
GitHub is a web and cloud-based service that helps developers to store and manage their code, as well as to track and control changes to their code base.
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 Development tab.
You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Development.
4.The Connect GitHub Organization dialog box appears. Enter the Organization Name and click Connect.
Make sure to enter a valid 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.
If the Organization name is changed in the GitHub, you need to connect the renamed organization again. The renamed organization won't be automatically connected even though the organization with the old name was connected.
Setup GitHub Repositories
You can manually add the repositories to the configured GitHub server.
To add repositories to the GitHub server, perform the following steps:
1.Go to the GitHub server in the Source Control and click + Add Repository.
2.The Add Repository dialog box appears. Enter the Repository Name, Website, Description. Click Add to add the repository.
You can also enable the DCO, Issues and Wiki by using the Enable DCO, Enable Issues and Enable Wiki toggle button respectively.
You have to install the DCO app before enabling the DCO on the repository. Refer GitHub DCO for configuration. After configuring the DCO in GitHub, you can enable the DCO in the PCC.
Enabling DCO in the PCC:
Adds branch protection rules for the default branch, so that PRs must be made before changes can be merged.
It adds a required DCO status check for PRs
If the DCO app is not installed and configured for the organization before DCO is enabled on a repository, all changes to the default branch will be blocked until the app is added.
Invite The Linux Foundation user 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.
We cannot accept invites unless the organization is associated with a project. Please make sure to add the project to the PCC before sending an invite to 'thelinuxfoundation" user, or the invite will not be accepted and will expire after 7 days.
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.
If your invite has expired, you must delete it and send a new invite.
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.
5.The Confirm Disassociation dialog box appears, click Delete to delete the GitHub Organization.
Setting up GitLab
GitLab is an open source code repository and collaborative software development platform for large DevOps and DevSecOps projects. GitLab helps you to automate the builds, integration, and verification of your code.
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 Development tab.
You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Development.
4.The Connect GitLab Group dialog box appears. Enter the Group Name and click Connect.
The name of the group should be added and not the url or the ID.
5.Once the connection is setup, you can see the status of GitLab project and its repositories.
Setting up Gerrit
Gerrit is a web-based code review tool, which is integrated with Git and built on top of Git version control system (helps developers to work together and maintain the history of their work). It allows merging changes to Git repository when you are done with the code reviews.
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Source Control from the Development tab.
You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click Development and then select Source Control.
3.The Source Control page appears. Click Gerrit and then click File Ticket to submit a ticket to configure Gerrit server for your project.
4. In the Support Form, provide details such as summary, project name, Gerrit URL and description. Click Create to submit the request to the support team.
5.Once the support team configures the Gerrit server, the Gerrit server is added in the source control along with the associated repositories.
Adding Repositories
You can manually add the repositories to the configured Gerrit server.
To add repositories to the Gerrit server, perform the following steps:
1.Go to the Gerrit server in the Source Control and click + Add Repository.
2.The Add Repository dialog box appears. Enter the Repository Name and Description and click Add.
You can use the toggle button if you want to enable the repository as the parent repositories for other repositories.
Updating the Repository
You can update the repository name and other changes with respect to the listed repository.
To update the repository details, perform the following steps:
2.The Edit Repository dialog box appears. You can update the Repository Name, Enable DCO and Description and click Save to update the changes.
Making a Repository as Writeable or Readable
When the repository is set as Writeable, the Read-only column is set as Yes and when the repository is set as Readable, the Read-only column is set to No.
Hiding a Repository and Restrict All Access
Deleting a Repository
Last updated
