Git for Administrators
Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Git for Administrators.
The recommended way (now all Moodle development has moved to this versioning system) is Git. This page describes how to maintain a copy of Moodle on your production server which can easily be upgraded using Git. If you have customisations of Moodle core code, you are advised to follow the instructions in the Quick Git start guide for Moodle development.
To get the most of of Git it is worth making the effort to understand its basic concepts - see the See also section below. It can be a bit of a learning curve, especially if you are used to CVS or Subversion.
Getting hold of Git (Windows, OSX, Linux and others)
Support for Git was, up until recently, mostly confined to Linux but builds are now available for most popular operating systems:
- List of downloads from Git site - http://git-scm.com/download
Once you have downloaded and installed your OS relevant git installation, the git commands in this document should work with your operating system.
Obtaining the code from Git
The command line version of Git is discussed here. Graphical clients are little more than wrappers around the command line version, so you should be able to deduce the correct parameters quite easily.
$ git clone git://git.moodle.org/moodle.git (1) $ cd moodle $ git branch -a (2) $ git branch --track MOODLE_23_STABLE origin/MOODLE_23_STABLE (3) $ git checkout MOODLE_23_STABLE (4)
- The command (1) initializes the new local repository as a clone of the 'upstream' (i.e. the remote server based) moodle.git repository. The upstream repository is called 'origin' by default. It creates a new directory named moodle, where it downloads all the files. This operation can take a while as it is actually getting the entire history of all Moodle versions
- The command (2) lists all available branches.
- Use the command (3) to create a new local branch called MOODLE_23_STABLE and set it to track the remote branch MOODLE_23_STABLE from the upstream repository.
- The command (4) actually switches to the newly created local branch.
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 from 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.
- Moodle Docs
- Git FAQ
- CVS for Administrators
- Moodle versions
- For some screenshots see User:Frank_Ralf/Git (still work in progress)
- For fixing a Tracker Issue (MDL) / Forking Moodle / CONTRIButing code ... User:Sam_Hemelryk/My_Moodle_Git_workflow
- Moodle forum discussions
- 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
- GIT for dummies
- External resources