Development/Git: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
m (cloning != write access should be quite obvious.)
(So core.git is the latest stable ''development'' version - not what is shown on musicbrainz.org - and in the future live releases will be available with 'tag -l')
Line 2: Line 2:


== Checking out source code ==
== Checking out source code ==
To create a local copy of the source code, clone a repository using this command:
To create a local copy of the [[MusicBrainz Server]] source code, clone the repository using:


git clone git://git.musicbrainz.org/musicbrainz-server/core.git mb_server
git clone git://git.musicbrainz.org/musicbrainz-server/core.git mb_server
Line 10: Line 10:
git pull
git pull


The above will clone the latest master branch -- see the [http://git.musicbrainz.org/gitweb/?p=musicbrainz-server/core.git;a=blob;f=README;h=69eddf403c338eebc52066c7a676e2109ba4b3e6;hb=HEAD README] for more information. Alternatively, all official releases we make are tagged on the master tree, and these can be cloned to run a stable version of the [[MusicBrainz Server]].
The above will clone the latest stable ''development'' version. Alternatively, if you're looking for a stable ''live'' release of the [[MusicBrainz Server]], all official releases we make are tagged and accessible using:

tag -l
git checkout <tag name>


If you need help or are confused send an email to [mailto:support@musicbrainz.org support@musicbrainz.org], or drop by the [http://webchat.freenode.net/?channels=musicbrainz #musicbrainz IRC channel].
If you need help or are confused send an email to [mailto:support@musicbrainz.org support@musicbrainz.org], or drop by the [http://webchat.freenode.net/?channels=musicbrainz #musicbrainz IRC channel].

Revision as of 09:15, 9 February 2010

Development on the MusicBrainz Server source code is coordinated using Git. The Git web interface, http://git.musicbrainz.org, provides access to viewing the various repositories and even browsing the source code.

Checking out source code

To create a local copy of the MusicBrainz Server source code, clone the repository using:

git clone git://git.musicbrainz.org/musicbrainz-server/core.git mb_server

And to stay up to date with the latest changes use:

git pull

The above will clone the latest stable development version. Alternatively, if you're looking for a stable live release of the MusicBrainz Server, all official releases we make are tagged and accessible using:

tag -l
git checkout <tag name>

If you need help or are confused send an email to support@musicbrainz.org, or drop by the #musicbrainz IRC channel.

Development with Git

If you want to help contribute to MusicBrainz - it's really simple! All you need to do is branch off master and commit there:

git clone git://git.musicbrainz.org/musicbrainz-server/core.git mb_server
cd mb_server
git checkout -b my-cool-feature master

When you are ready to share your work with us you have a few options - if you wish to submit a patches, you should use git format-patch. These can then be emailed to the developers mailing list. If you're doing work on more than one branch, or you'd like to have more control, we are happy to give you a branch or repository on git.musicbrainz.org to push work to. For more information on this, please ask on the developers mailing list and someone will give you more details.

Git Resources

If you're new to Git, don't worry - there is plenty of excellent documentation about how to use it: