Skip to content

Latest commit

 

History

History
119 lines (69 loc) · 7.76 KB

File metadata and controls

119 lines (69 loc) · 7.76 KB

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.

{% hint style="info" %} You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Source Control. {% endhint %}

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.

{% hint style="info" %} Make sure to enter a valid GitHub organization name. {% endhint %}

GitHub Organization Name

{% hint style="info" %}

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

GitHub Status

{% hint style="danger" %} 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. {% endhint %}

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.

{% hint style="info" %}

  • 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. {% endhint %}

{% hint style="warning" %} If your invite has expired, you must delete it and send a new invite. {% endhint %}

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.

.

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.

{% hint style="info" %} You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Source Control. {% endhint %}

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