ClearOS software development uses the Git version control system, on GitLab.
The main project is located at https://gitlab.com/clearos.
Sub-projects fork off the main project, as desribed below:
|ClearCenter||Both Open Source and Proprietary (private repos) apps from ClearCenter|
|ClearFoundation||Open Source packages from ClearFoundation|
|Upstream||Packages maintained in upstream repositories with minor patches by ClearOS|
|Docs||Documentation (currently developer docs only)|
Software repositories have branches. Every project has a master branch.
New to Git? Read up on branches here.
In addition to the master branch, ClearOS uses branches to build packages and perform version control on the RPM's build from the Git software repositories.
The clear7 branch is a reserved branch for building packages for ClearOS 7. Similarly, if you see a clear6 branch, you can infer that this branch is for maintaining older ClearOS 6 code.
There may be any number of other branches, depending on whether another developer is working out of a custom branch to maintain their code prior to merging back into the master branch.
For a good introduction to Git commit flow, have a look at this GitHub document.
In order to get started, create a GitLab account here.
One of the first tasks you'll want to do is add your public key to your GitLab account. This will facilitate cloning and making pull requests to the various code repositories.
After you have logged in, at the top right hand corner of the site, click on your profile avatar and select "Settings".
Under "User Settings" in the vertical navigation bar on the left, select "SSH Keys". Copy your public key that you created in the Getting Started > SSH Keys section of this documentation and paste it in the textarea box labled "Keys".
Ensure you are pasting the public key portion (file ending in .pub) of your key pair!
Add a Title (just something to easily remember the keypair you're using and click "Add Key".
Back in your development environment, navigate to your home directory and then into the app folder:
Navigate the GitLab website until you find the project you wish to checkout. In the example below, we're going to checkout the "Date" app located here.
Select SSH (instead of HTTPS) for the URL and click on the clipboard icon to copy the URL. In the apps folder paste the url as follows:
git clone email@example.com:clearos/app-date.git date
Take note above that we clone the software repository the app basename (eg. "date") in place of the repository name (app-date). This is to be compatible with the ClearOS Webconfig framework.
Copyright © 2009- ClearCenter