User Tools

Site Tools


wiki:development:git

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:development:git [2011/08/08 16:53]
morty [Contributing to X2go]
wiki:development:git [2020/05/28 22:43] (current)
danger89 [Anonymous X2Go Git Repository Access via Git-protocol (read-only)]
Line 1: Line 1:
-====== X2go's Git Repository ======+====== X2Go's Git Repository ======
  
-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): ''git-admin (at) x2go (dot) org'', a discussion about content should be held on the developers' mailing list: ''x2go-dev@lists.berlios.de''.+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): ''git-admin (at) x2go (dot) org'', a discussion about content should be held on the developers' mailing list: ''x2go-dev@lists.x2go.org''.
  
 ===== Access ===== ===== Access =====
  
-==== Browse the X2go GIT repository tree in a web browser ====+==== Browse the X2Go GIT repository tree in a web browser ====
  
  
Line 12: Line 12:
 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://das-netzwerkteam.de/NWT-ca.crt 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://das-netzwerkteam.de/NWT-ca.crt
  
-==== Anonymous X2go Git Repository Access via Git-protocol (read-only) ====+==== Anonymous X2Go Git Repository Access via Git-protocol (read-only) ====
  
  
-X2go's Git projects can be cloned to a local copy through anonymous Git with the following instruction set (in a Unix-like console session). +X2Go's Git projects can be cloned to a local copy through anonymous Git with the following instruction set (in a Unix-like console session). 
  
-  $ mkdir -p ~/x2go +  $ mkdir ~/x2go && cd ~/x2go 
-  $ cd ~/x2go +  $ git clone git://code.x2go.org/<package_name
-  $ git clone git://code.x2go.org/<package+
  
-For <packagenames please refer to the [[http://git.x2go.org|Git WebGUI]] (see above).+For the <package_name> please refer to the [[http://git.x2go.org|Git WebGUI]] (see above).
  
-===== Contributing to X2go =====+===== Contributing to X2Go =====
  
 Before you start contributing make sure git git knows who you are, as this is added to the patches. Before you start contributing make sure git git knows who you are, as this is added to the patches.
  
-=== Setup Git Configuration ===+==== 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 ''~/.gitconfig'' with your favourite editor and put the followings lines in it (of course, you may want to personalize some of the fields): 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 ''~/.gitconfig'' with your favourite editor and put the followings lines in it (of course, you may want to personalize some of the fields):
Line 37: Line 36:
 </code> </code>
  
 +==== Sending in Patches ====
  
 +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:bugs|X2Go Bug Tracker System]].
  
-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 this eMail address: 
  
-<note>TODO: Write/Link howto</note>+==== Developer Git Access via SSH ====
  
-  patches@x2go.org 
  
-=== Developer Git Access via SSH === +In the instruction set below, substitute <package> with the X2Go source package that you want to work on, substitute <branch> with the name of the branch of <package> you are contributing to. The SSH <port> to use for Git write access will be provided to developers only and will not be named in this Wiki. Access via SSH will only be granted by SSH public key authentication (no password auth).
- +
- +
-In the instruction set below, substitute <package> with the X2go source package that you want to work on, substitute <branch> with the name of the branch of <package> you are contributing to. The SSH <port> to use for Git write access will be provided to developers only and will not be named in this Wiki. Access via SSH will only be granted by SSH public key authentication (no password auth).+
  
   $ cd ~/x2go/<package>   $ cd ~/x2go/<package>
   $ git push ssh://x2go@code.x2go.org:<port>/srv/git/code.x2go.org/<package> <branch>   $ git push ssh://x2go@code.x2go.org:<port>/srv/git/code.x2go.org/<package> <branch>
  
-=== SSH Key Fingerprints of code.x2go.org (FQDN: ymir.das-netzwerkteam.de) ===+==== SSH Key Fingerprints of code.x2go.org (FQDN: ymir.das-netzwerkteam.de) ====
  
      
Line 60: Line 56:
 ===== Commits / Tags via e-Mail ===== ===== Commits / Tags via e-Mail =====
  
-Commits and tags in X2go Git are posted as e-Mails to two different mailing lists:+Commits and tags in X2Go Git are posted as e-Mails to two different mailing lists:
  
-  * Git commits -> x2go-commits@lists.berlios.de (https://lists.berlios.de/mailman/listinfo/x2go-commits) +  * Git commits -> x2go-commits@lists.x2go.org (https://lists.x2go.org/listinfo/x2go-commits) 
-  * Git tags -> x2go-announcement@lists.berlios.de (https://lists.berlios.de/mailman/listinfo/x2go-announcement)+  * Git tags -> x2go-tags@lists.x2go.org (https://lists.x2go.org/listinfo/x2go-tags)
  
-These mailing lists can be subscribed to by anyone who is interested in X2go Git changes. However, beware that there might be phases you get flooded by mails, if you subscribe to any of these lists (esp. x2go-commits). Furthermore the lists are read-only. Postings to these lists will be dropped automatically by the mailing list service. +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: Both mailing lists are also archived at Gmane:
  
-  * [[http://blog.gmane.org/gmane.linux.terminal-server.x2go.scm|gmane.linux.terminal-server.x2go.scm]] -- X2go Git commit messages (read-only) +  * [[http://blog.gmane.org/gmane.linux.terminal-server.x2go.scm|gmane.linux.terminal-server.x2go.scm]] -- X2Go Git commit messages (read-only) 
-  * [[http://blog.gmane.org/gmane.linux.terminal-server.x2go.tags|gmane.linux.terminal-server.x2go.tags]] -- X2go Git taggings (read-only)+  * [[http://blog.gmane.org/gmane.linux.terminal-server.x2go.tags|gmane.linux.terminal-server.x2go.tags]] -- X2Go Git taggings (read-only)
  
 ===== Snippets ==== ===== Snippets ====
  
-==== Checkout all repos==== +==== Checkout all repos ==== 
-This is for bash+Just copy and paste into a bash terminal: 
 <code> <code>
 for REP in \ for REP in \
 buildscripts.git \ buildscripts.git \
 cups-x2go.git \ cups-x2go.git \
 +libjpeg-turbo.git \
 +libpam-x2go.git \
 +lightdm-remote-session-x2go.git \
 ltsp-pyhocathinclient.git \ ltsp-pyhocathinclient.git \
-nxcomp.git \ +nx-libs.git \
-nxcompext.git \ +
-nxcompshad.git \ +
-nxproxy.git \+
 pinentry-x2go.git \ pinentry-x2go.git \
 pyhoca-cli.git \ pyhoca-cli.git \
 pyhoca-contrib.git \ pyhoca-contrib.git \
 pyhoca-gui.git \ pyhoca-gui.git \
 +python-paramiko.git \
 python-x2go.git \ python-x2go.git \
 x2go-keyring.git \ x2go-keyring.git \
-x2goagent.git \+x2goadmincenter.git \ 
 +x2gobroker.git \
 x2goclient-contrib.git \ x2goclient-contrib.git \
 x2goclient.git \ x2goclient.git \
 +x2goclient2.git \
 +x2godesktop-applet.git \
 x2godesktopsharing.git \ x2godesktopsharing.git \
 x2gognomebindings.git \ x2gognomebindings.git \
 +x2golxdebindings.git \
 x2goplasmabindings.git \ x2goplasmabindings.git \
 x2goserver.git \ x2goserver.git \
 x2gothinclient.git \ x2gothinclient.git \
 x2gotrinitybindings.git \ x2gotrinitybindings.git \
 +z99.ubuntu/libev.git \
 +z99.ubuntu/python-crypto.git \
 +z99.ubuntu/python-gevent.git \
 +z99.ubuntu/python-greenlet.git \
 +z99.ubuntu/python-pampy.git \
 +z99.ubuntu/python-setproctitle.git \
 ; do git clone git://code.x2go.org/$REP; done ; do git clone git://code.x2go.org/$REP; done
 </code> </code>
 +
 +==== Get Updates for all Repos ====
 +Just copy and paste into a bash terminal: 
 +
 +<code>
 +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/libev \
 +z99.ubuntu/python-crypto \
 +z99.ubuntu/python-gevent \
 +z99.ubuntu/python-greenlet \
 +z99.ubuntu/python-pampy \
 +z99.ubuntu/python-setproctitle \
 +; do cd $REP && git pull && cd .. ; done
 +</code>
 +===== Maintenance =====
 +
 +<note warning>This is only for admins having access to the X2Go Git server.</note>
 +
 +==== Create new Git Project on X2Go Git ====
 +
 +Create a local Git project:
 +
 +<code>
 +$ mkdir -p ~/MyCode/x2go-upstream/x2gonewthing
 +$ cd ~/MyCode/x2go-upstream/x2gonewthing
 +$ git init
 +</code>
 +
 +Then add your first files to the new ''x2gonewthing'' project. Commit these files as the first commit. Maybe commit more...
 +
 +Then run the following command sequence:
 +
 +<code>
 +$ cd ~/MyCode/x2go-upstream/
 +$ x2go-gitcreate x2gonewthing
 +# if the Git creation succeeds (check via http://code.x2go.org/gitweb), only then...
 +$ rm x2gonewthing -Rfv
 +$ git clone ssh://x2go@code.x2go.org:32032/srv/git/code.x2go.org/x2gonewthing.git
 +</code>
 +
 +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 ''x2go-admin'' on ''code.x2go.org'':
 +
 +<code>
 +$ cd /srv/git/code.x2go.org/<x2go-project>.git
 +$ vim config
 +</code>
 +
 +==== Edit Git Descriptions ====
 +
 +As ''x2go-admin'' on ''code.x2go.org'':
 +
 +<code>
 +$ cd /srv/git/code.x2go.org/<x2go-project>.git
 +$ vim description
 +</code>
 +
 +==== Edit Git ACLs ====
 +
 +Unused feature, may come later...
 +
 +
 +===== Backyard =====
 +
 +==== Reverting Merge Commits ====
 +
 +If you forget to run ''git-pull'' before modifying code files you will run into merge problems when committing your changes.
 +
 +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 ''git-pull'' instead
 +  * and then uuups... realize: the ''git-pull'' fetched in some code for the same file, I have just been working on...) -> you probably forgot to run a ''git-pull'' before starting to work on that particular file...
 +
 +One possible solution for this is //cherry-picking//. Here is an example (presuming that your are working on the master branch):
 +
 +<code>
 +# 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's Git were known to be still in sync
 +$ git reset --hard <last-refspec-known-to-be-identical-with-server>
 +
 +# then take a look at the log of your old local master branch
 +$ git log master-bak-tmp
 +
 +# 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 <refspec-1>
 +$ git cherry-pick <refspec-2>
 +...
 +$ git cherry-pick <refspec-n>
 +
 +# finally drop the tmp backup of old master
 +$ git branch -D master-bak-tmp
 +</code>
 +
 +==== Pushing to X2Go Git ====
 +
 +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:
 +
 +<code>
 +$ git push
 +</code>
 +
 +<note>
 +When working on master's HEAD do not wait __too__ long before pushing them to the server as it may happen that others work on master's HEAD as well.
 +
 +Keeping back code for too long can result in code conflicts (changes in the same code block of the same file by two different developers).
 +</note>
 +
 +The update scripts of X2Go Git will shout warnings at you while pushing. These warnings relate to
 +
 +  * whitespaces found at the end of lines
 +  * tabs found in the file (for Python: no tabs, for Bash, Perl, C++, etc. tabs are wanted, so you can ignore these if not coding Python)
 +  * no \newline at end of file
 +
 +You may consider silencing those warnings before committing the next time...
  
  
  
wiki/development/git.1312822415.txt.gz · Last modified: 2013/03/08 13:31 (external edit)