This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:development:git [2011/01/28 22:32] sunweaver |
wiki:development:git [2020/05/28 22:43] (current) danger89 [Anonymous X2Go Git Repository Access via Git-protocol (read-only)] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | Within the X2go project development code is shared via a public GIT repository hosted by DAS-NETZWERKTEAM in Kiel, Nothern Germany (Servers: Hetzner Online AG). For any X2go GIT related questions, please contact our GIT repository administrator (currently: Mike Gabriel): '' | + | Within the X2Go project development code is shared via a public GIT repository hosted by DAS-NETZWERKTEAM in Kiel, Nothern Germany (Servers: Hetzner Online AG). For any technical X2Go Git related questions, please contact our Git repository administrator (currently: Mike Gabriel): '' |
- | ===== Access | + | ===== Access ===== |
- | Browse the X2go GIT repository tree in a webbrowser (either with GitWEB or with Chora/ | + | ==== Browse the X2Go GIT repository tree in a web browser ==== |
- | http:// | + | |
- | http://code.x2go.org/horde4/ | + | |
- | + | ||
The Web service is also available as a https service. To make secure browsing as smooth as possible, please import this Root-CA-Certificate into your web browser: http:// | The Web service is also available as a https service. To make secure browsing as smooth as possible, please import this Root-CA-Certificate into your web browser: http:// | ||
+ | ==== Anonymous X2Go Git Repository Access via Git-protocol (read-only) ==== | ||
- | **Anonymous X2go GIT Repository Access via GIT protocol (read-only)** | ||
- | The X2go project' | + | X2Go' |
- | $ mkdir -p ~/x2go | + | $ mkdir ~/ |
- | $ cd ~/x2go | + | $ git clone git:// |
- | $ git clone git:// | + | |
- | **Contributing | + | For the < |
- | Only project developers can access the GIT tree via the SSH method. Please understand that we only restrictively grant write access | + | ===== Contributing |
- | | + | Before you start contributing make sure git git knows who you are, as this is added to the patches. |
- | **Developer GIT Access via SSH** | + | ==== Setup Git Configuration ==== |
+ | Now it is time to set up your system environment for working with Git. Main thing is to tell Git who you are. For this edit the file '' | ||
- | As an X2go developer, please substitute the field <developername> in the text below with your account login name. Substitute | + | <code> |
+ | [user] | ||
+ | name = < | ||
+ | email = < | ||
+ | </code> | ||
+ | |||
+ | ==== Sending | ||
+ | |||
+ | Only project developers can access X2Go's Git tree via the SSH method. Please understand that we only restrictively grant write access to our GIT repository. However, you can send us patches via Mail (git-send-email). For submitting X2Go patches, please use the [[wiki: | ||
+ | |||
+ | |||
+ | ==== Developer Git Access via SSH ==== | ||
+ | |||
+ | |||
+ | In the instruction set below, substitute | ||
$ cd ~/ | $ cd ~/ | ||
- | $ git push ssh://< | + | $ git push ssh://x2go@code.x2go.org:< |
+ | |||
+ | ==== SSH Key Fingerprints of code.x2go.org (FQDN: ymir.das-netzwerkteam.de) ==== | ||
- | **SSH Key Fingerprints of code.x2go.org (fqdn: ymir.das-netzwerkteam.de)** | ||
| | ||
RSA Key: ab: | RSA Key: ab: | ||
- | ===== Objectives | + | ===== Commits / Tags via e-Mail ===== |
+ | |||
+ | Commits and tags in X2Go Git are posted as e-Mails to two different mailing lists: | ||
+ | |||
+ | * Git commits -> x2go-commits@lists.x2go.org (https:// | ||
+ | * Git tags -> x2go-tags@lists.x2go.org (https:// | ||
+ | |||
+ | These mailing lists can be subscribed to by anyone who is interested in X2Go Git changes. However, beware that there might be phases during which you get flooded by mails. Furthermore the lists are read-only. Postings to these lists will be dropped automatically by the mailing list service. | ||
+ | |||
+ | Both mailing lists are also archived at Gmane: | ||
+ | |||
+ | * [[http:// | ||
+ | * [[http:// | ||
+ | |||
+ | ===== Snippets ==== | ||
+ | |||
+ | ==== Checkout all repos ==== | ||
+ | Just copy and paste into a bash terminal: | ||
+ | < | ||
+ | for REP in \ | ||
+ | buildscripts.git \ | ||
+ | cups-x2go.git \ | ||
+ | libjpeg-turbo.git \ | ||
+ | libpam-x2go.git \ | ||
+ | lightdm-remote-session-x2go.git \ | ||
+ | ltsp-pyhocathinclient.git \ | ||
+ | nx-libs.git \ | ||
+ | pinentry-x2go.git \ | ||
+ | pyhoca-cli.git \ | ||
+ | pyhoca-contrib.git \ | ||
+ | pyhoca-gui.git \ | ||
+ | python-paramiko.git \ | ||
+ | python-x2go.git \ | ||
+ | x2go-keyring.git \ | ||
+ | x2goadmincenter.git \ | ||
+ | x2gobroker.git \ | ||
+ | x2goclient-contrib.git \ | ||
+ | x2goclient.git \ | ||
+ | x2goclient2.git \ | ||
+ | x2godesktop-applet.git \ | ||
+ | x2godesktopsharing.git \ | ||
+ | x2gognomebindings.git \ | ||
+ | x2golxdebindings.git \ | ||
+ | x2goplasmabindings.git \ | ||
+ | x2goserver.git \ | ||
+ | x2gothinclient.git \ | ||
+ | x2gotrinitybindings.git \ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | ; do git clone git:// | ||
+ | </ | ||
+ | |||
+ | ==== Get Updates for all Repos ==== | ||
+ | Just copy and paste into a bash terminal: | ||
+ | |||
+ | < | ||
+ | for REP in \ | ||
+ | buildscripts \ | ||
+ | cups-x2go \ | ||
+ | libjpeg-turbo \ | ||
+ | libpam-x2go \ | ||
+ | lightdm-remote-session-x2go \ | ||
+ | ltsp-pyhocathinclient \ | ||
+ | nx-libs \ | ||
+ | pinentry-x2go \ | ||
+ | pyhoca-cli \ | ||
+ | pyhoca-contrib \ | ||
+ | pyhoca-gui \ | ||
+ | python-paramiko \ | ||
+ | python-x2go \ | ||
+ | x2go-keyring \ | ||
+ | x2goadmincenter \ | ||
+ | x2gobroker \ | ||
+ | x2goclient-contrib \ | ||
+ | x2goclient \ | ||
+ | x2goclient2 \ | ||
+ | x2godesktop-applet \ | ||
+ | x2godesktopsharing \ | ||
+ | x2gognomebindings \ | ||
+ | x2golxdebindings \ | ||
+ | x2goplasmabindings \ | ||
+ | x2goserver \ | ||
+ | x2gothinclient \ | ||
+ | x2gotrinitybindings \ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | z99.ubuntu/ | ||
+ | ; do cd $REP && git pull && cd .. ; done | ||
+ | </ | ||
+ | ===== Maintenance ===== | ||
+ | |||
+ | <note warning> | ||
+ | |||
+ | ==== Create new Git Project on X2Go Git ==== | ||
+ | |||
+ | Create a local Git project: | ||
+ | |||
+ | < | ||
+ | $ mkdir -p ~/ | ||
+ | $ cd ~/ | ||
+ | $ git init | ||
+ | </ | ||
+ | |||
+ | Then add your first files to the new '' | ||
+ | |||
+ | Then run the following command sequence: | ||
+ | |||
+ | < | ||
+ | $ cd ~/ | ||
+ | $ x2go-gitcreate x2gonewthing | ||
+ | # if the Git creation succeeds (check via http:// | ||
+ | $ rm x2gonewthing -Rfv | ||
+ | $ git clone ssh:// | ||
+ | </ | ||
+ | |||
+ | Now you can start working on your new X2Go project as on any of the other already existing X2Go Git projects. | ||
+ | |||
+ | ==== Edit Git Configs ==== | ||
+ | |||
+ | As '' | ||
+ | |||
+ | < | ||
+ | $ cd / | ||
+ | $ vim config | ||
+ | </ | ||
+ | |||
+ | ==== Edit Git Descriptions ==== | ||
+ | |||
+ | As '' | ||
+ | |||
+ | < | ||
+ | $ cd / | ||
+ | $ vim description | ||
+ | </ | ||
+ | |||
+ | ==== Edit Git ACLs ==== | ||
+ | |||
+ | Unused feature, may come later... | ||
+ | |||
+ | |||
+ | ===== Backyard ===== | ||
+ | |||
+ | ==== Reverting Merge Commits ==== | ||
+ | |||
+ | If you forget to run '' | ||
+ | |||
+ | There is nothing bad about merge commits apart from the fact that the X2Go Git system won't allow them being pushed to the server :-/. | ||
+ | |||
+ | Thus, you probably want to avoid merge commits right from the beginning. However, from time to time it occurs that you crunch your Git log with a merge commit. This is how such a thing can happen: | ||
+ | |||
+ | * change a file | ||
+ | * commit it locally | ||
+ | * push it to X2Go Git | ||
+ | * find that the push operation gets rejected :-( | ||
+ | * then run '' | ||
+ | * and then uuups... realize: the '' | ||
+ | |||
+ | One possible solution for this is // | ||
+ | |||
+ | < | ||
+ | # make a temporary backup copy of the master branch | ||
+ | $ git checkout -b master-bak-tmp | ||
+ | |||
+ | # go back to master branch | ||
+ | $ git checkout master | ||
+ | |||
+ | # and reset it to that refspec where local Git and server' | ||
+ | $ git reset --hard < | ||
- | * Our goal is to give the online community convenient access to our most recent work. | + | # then take a look at the log of your old local master branch |
- | * We have chosen a server location in Germany as one of our demands to the provider is that the GIT portal' | + | $ git log master-bak-tmp |
- | * We have chosen not to host the GIT ourselves, but have found a sponsor for hosting X2go GIT (http://das-netzwerkteam.de) | + | |
- | * Community members can apply for a GIT branch in X2go's BerliOS GIT repository. The person who applies for a branch (please contact our GIT administrator, | + | |
- | * The X2go team encourages you to form teams and work on your own branch and create your own blend of X2go. This will enable us all to cooperate and benefit from each others' | + | |
- | ===== GIT Policies ===== | + | # now cherry-pick your local changes individually from the master-bak-tmp branch (where refspec-1 ... refspec-n are the commit hashes of each commit): |
+ | $ git cherry-pick < | ||
+ | $ git cherry-pick < | ||
+ | ... | ||
+ | $ git cherry-pick < | ||
- | On each GIT repositories (one GIT per source package) there are 2 permanent branches: | + | # finally drop the tmp backup of old master |
+ | $ git branch -D master-bak-tmp | ||
+ | </ | ||
- | * **master branch** | + | ==== Pushing to X2Go Git ==== |
- | * **develop branch** | + | |
- | An X2go __release__ always __means a merge__ from the **develop branch** | + | Whenever your local X2Go Git project is in an acceptable state for the community, feel free to push the code to the X2Go Git server: |
- | All X2go components that have been accepted for a future release can be found in the **develop branch** | + | < |
+ | $ git push | ||
+ | </ | ||
- | There can be different temporary branches around release management: | + | < |
+ | When working on master' | ||
- | * **release branches** | + | Keeping back code for too long can result in code conflicts |
- | * -> branches off from **develop branch** | + | </note> |
- | * -> merges into **master branch** | + | |
- | * **hotfix branches** (hotfix-<target-version>) | + | |
- | * -> branches off from **master branch** | + | |
- | * -> merges back into **master branch** (and **develop branch** if needed) | + | |
- | And there can be different temporary branches around feature development. These branches we call feature branches: | + | The update scripts of X2Go Git will shout warnings at you while pushing. These warnings relate to |
- | * ** feature branches** | + | * whitespaces found at the end of lines |
- | * -> branches off from **develop branch** | + | |
- | * -> if feature gets accepted: merges back into **develop branch** | + | * no \newline at end of file |
- | Further policies are: | + | You may consider silencing those warnings before committing the next time... |
- | * Every GIT branch is readable by the public, there can be no private branches | ||
- | * The master branch is maintained by the X2go core development team (currently: Alex & Heinz) | ||
- | * The develop branch is maintained by the X2go core development team (currently: Alex & Heinz) | ||