History

Git Repositories

Using github

The simplest, fastest way to create a git-based repository for your project is creating a project with github .

Assuming that you (the manager of the project to be created) want to create an ohwr project with a github repository, here are the steps:

1. Project manager / Github repository admin (you)

  • Login / register on github.
  • Create a new github project. It is recommended that you name the github project following Redmine's naming conventions: This is, only lowercase letters, numbers and hyphens (-), and a max length of 30 characters.
  • Contact Javier Serrano indicating the github project you want to use as repository. Javier will create an ohr-support issue and assign it to the ohr-support team.

2. ohwr admin (Javier)

  • Create the project with the repository flag deactivated.
  • Open a support ticket detailing:
    • The project id
    • The github repository url

3. ohr-support team (egarcia, fjuan)

  • Read docuemtation at plugin repository
  • git clone the repository into the local repository folder
  • Activate the repository flag for the project, and then go to Settings/Repository and set the following fields:
    • type of repository: git
    • Path to Repository field pointing to the final /.git/ folder
    • Overwrite default settings for checkout url: Yes
    • Checkout url: the git:// (read-only address) for the repository on github
    • Render checkout URL as a link: Yes
    • Display Login: No login or password

Send the hook url to the project manager. It should look like this: http://www.ohwr.org/github_hook?project_id=ohwr_project_identifier . Note that the id= parameter is needed only if the github repository name is different from the Ohwr project identifier.

4. Project manager / Github repository admin (you)

Note: Post-Receive Hooks looses timezone information

Using non-github servers

1. Project manager / Git admin (you)

  • Create a new git repository on your git server. It is recommended that you name the github project following Redmine's naming conventions: This is, only lowercase letters, numbers and hyphens (-), and a max length of 30 characters.
  • Contact Javier Serrano indicating that repository's read-only git url. Javier will create an ohr-support issue and assign it to the ohr-support team.

Steps 2 and 3: Same as above

4. Project manager / Git admin (you)

  • On the git server, create a new file inside /your-git-repository/.git/hooks/post-receive
  • Add the following line to that file (you will receive the correct OHWR-PROJECT-ID from the ohr-support team once your ohwr project has been created)
      wget --post-data="payload={}&project_id=OHWR-PROJECT-ID" http://www.ohwr.org/github_hook
  • Notice that wget must be available from the command line for the git user in order for this to work.

From that moment on, the git repository will be synced; new updates on the server will be automatically 'told' to the ohwr repository.

  • Make sure that the file is executable by the git user.

SVN to GIT

Based on this guide: http://www.jonmaddox.com/2008/03/05/cleanly-migrate-your-subversion-repository-to-a-git-repository/

1. SSH to the host env, cd to the git repo folder and su as git:

Notice that the git repository path might change.

ssh ohwr
cd /var/git/repositories
sudo su git

2. Create a users.txt file

nano ~/users.txt

It must include the login, full name and address of all the committers of /trunk/ using the following format:

jmaddox = Jon Maddox <jon@gmail.com>
bigpappa = Brian Biggs <bigpappa@gmail.com>

3. Clone /trunk/ into a temp git using the users.txt file

We'll be assuming that the name of our project is "project" here. Change as required.

mkdir project_tmp.git
cd project_tmp.git
git svn init http://svn.ohwr.org/project/trunk/ --no-metadata
git config svn.authorsfile ~/users.txt
git svn fetch

4. Clone the temp repository into a bare one

This will make sure that no traces of SVN remain on the repo

cd ..
git clone --bare project_tmp.git project.git

5. Remove temporary folder and users.txt

rm -rf project_tmp.git
rm ~/users.txt

6. Update repository info in OHWR site

  • Go to project / settings / repository and delete the svn repository info
  • Create a new repository info with the "GIT" protocol
  • Override the Git checkout settings with correct ones.