Git für Administratoren

Diese Seite ist noch nicht vollständig übersetzt.

Die empfohlene Vorgehensweise ist Git (Achtung: Bis jetzt ist noch nicht die gesamte Moodle-Code-Entwicklung auf dieses Versionierungssystem umgezogen!). Dieser Artikel beschreibt, wie Sie Moodle auf Ihrem Produktivserver über Git aktualisieren. Wenn Sie eigene Codeanpassungen haben, folgen Sie den Anleitungen in diesem Artikel Quick Git start guide for Moodle development (englisch).

Um Git effektiv nutzen zu können, sollten Sie die wichtigsten Konzepte verstanden haben (siehe Quellenangaben im Abschnitt Siehe auch). Das kann einen gewissen Einarbeitsaufwand erfordern, insbesondere wenn Sie bisher mit CVS oder Subversion gearbeitet haben.

Git (Windows, OSX, Linux)

• Eine Download-Liste für verschiedene Betriebssysteme finden Sie auf der Git-Seite http://git-scm.com/download.
• Wenn Sie Git heruntergeladen und auf Ihrem System installiert haben, sollten die im folgenden beschriebenen Befehle funktionieren.

Moodle-Code über Git holen

Hier beschreiben wir die kommandozeilen-basierte Version von Git. Grafische Benutzeroberflächen sind letztendlich nur Hüllen, darunter verbirgt sich ebenfalls die Kommandozeilenversion.

Das offizielle Moodle Git Repository finden Sie unter http://git.moodle.org/gw?p=moodle.git;a=summary (ein offizieller Clone liegt unter https://github.com/moodle/moodle). Um einen lokalen Checkout zu initialisieren, verwenden Sie folgende Befehle

$ git clone http://git.moodle.org/moodle.git                       (1)
$ cd moodle
$ git branch -a                                                    (2)
$ git branch --track MOODLE_22_STABLE origin/MOODLE_22_STABLE      (3)
$ git checkout MOODLE_22_STABLE                                    (4)

• Befehl(1) initialisiert das neue lokale Repository als einen Clone des Remote moodle.git Repository. Das Remote Repository wird standardmäßig als Quelle bezeichnet. Es legt ein neues Verzeichnis moodle an, in das alle Dateien heruntergeladen werden. Dieser Prozess kann eine Weile dauern, weil die gesamte Historie aller Moodle-Versionen mit gezogen wird.
• Befehl (2) listet alle verfügbaren Zweige (branches) auf.
• Mit Befehl (3) legen Sie einen neuen lokalen Zweig (Branch) an, der MOODLE_22_STABLE heißt, und setzen diesen Zweig so, dass er dem Remote branch MOODLE_22_STABLE vom Remote Repository folgt.
• Befehl (4) stellt auf den neuen lokalen Zweig um.

Note that Git has a huge number of options for each command and it's actually possible to do the above process with a single command (left as an exercise!!).

Git from behind a firewall

Git uses a proprietary protocol and it may be blocked by your firewall (port 9418). If this is a problem, you can use Github's http version https://github.com/moodle/moodle.git. It's a bit slower, so use the Git protocol if you can.

Updating your installation

The Moodle development team performs integration and testing of fixed bugs every Monday and Tuesday. On Wednesday you can install all patches by updating your code. Check the shortlog to see if the official repository has been already updated or not.

To update your code to the latest version (on the MOODLE_22_STABLE branch) all you have to do is:

$ cd /path/to/your/moodle/
$ git pull

If this is a production site you should still consider the Upgrade instructions (e.g. take backups).

Installing a contributed extension from its Git repository

This is one way to handle adding plugins from other Git repositories into your Moodle repository. Another way is to use Git Submodules. However, at the time of writing, this is one of Git's rougher features and should be regarded as an advanced option.

For example, let us say we want to install the Book module form its Git repository into our Moodle 2.2.

$ cd /path/to/your/moodle/
$ cd mod                                                          (1)
$ git clone git://github.com/skodak/moodle-mod_book.git book      (2)
$ cd book
$ git checkout -b MOODLE_22_STABLE origin/MOODLE_22_STABLE        (3)
$ git branch -d master                                            (4)

The command (1) changes the current directory into the mod folder of your local Moodle clone. The command (2) creates a new subdirectory book and makes a local clone of Petr Škoda's vanilla Book repository. The command (3) creates a new local branch that will track the remote branch with a Book version for Moodle 2.1. The command (4) deletes the master that was created automatically by git-clone in (2) as we do not want it in this production checkout.

Now it is wise to put the new directory mod/book/ to the list of ignored files of the main Moodle clone, otherwise a status of the main clone will keep reminding you that the new code has not been checked in.

$ cd /path/to/your/moodle/
$ echo /mod/book/ >> .git/info/exclude

To update your Moodle installation now, you must visit both Git repositories and pull changes from upstream.

$ cd /path/to/your/moodle/
$ git pull
$ cd mod/book
$ git pull

Writing a shell script with these lines in the root of Moodle installation is a very good idea. Otherwise it is easy to forget what Git repositories are there within the main Moodle repository.

Siehe auch

Moodle Docs:

• Moodle-Versionen
• Einige Screenshots von Frank Ralf (in Arbeit)
• Tracker Einträge (MDL) / Moodle CONTRIButing Code ... Sam Hemelryk

Diskussionsbeiträge auf moodle.org:

• GIT help needed
• Best way to manage CONTRIB code with GIT
• Handy Git tip for tracking 3rd-party modules and plugins
• Moodle Git repositories
• Git and CVS

Externe Quellen:

• Everyday GIT With 20 Commands Or So
• Git Reference
• Pro Git book
• Git from the bottom up