Git

	Skill level: Developer
	Risk of inconsistencies with Koozali SME Server methodology, upgrades & functionality is high. One must be knowledgeable about how changes impact their Koozali SME Server. Significant risk of irreversible harm.

Developer / Maintainer

Marco Hess

Status

As of 10 Feb 2013, RPM's are available from my personal repository (see below) and have been validated on a latest version of SME8. Feedback will be appreciated.

Description

This is a place holder for a Git integration contrib for SME server that is currently under development. It integrates git with git-http-backend and gitweb into SME8. Have a look http://git.through-ip.com for a live instance of the contrib.

The current feature list include:

• Create & manage centralised git repositories through the SME server-manager panel.
• Per repository network access configurable for either 'Local network Only' or 'Internet'.
• Repositories accessed over HTTP/HTTPS for easy remote access through firewalls.
• Separately configurable PULL and PUSH permissions.
• Permissions based on SME server users and groups.
• Support for Anonymous access PULL and/pr PUSH.
• Separate name space for Git repositories using git as a prefix (i.e. independent of ibays and other resources on the server)
• Email notification of push operations to all users that have either pull or push access to the repository
• Web viewing of repositories through gitweb.
• Special GitHub style theme for gitweb viewer (separately installable).
• Gravatars support in gitweb
• Automatic markdown of README.md into README.html and shown in gitweb

Installation

There are now RPMs available from my personal repository that can be found at

http://through-ip.com/packages/smeserver/i386/repoview/

Source RPMs are also available, as well as cloning with Git from either:

http://git.through-ip.com

or from GitHub:

1. https://github.com/MarcoHess/smeserver-git/tree/smeserver-git
2. https://github.com/MarcoHess/smeserver-git/tree/smeserver-gitweb
3. https://github.com/MarcoHess/smeserver-git/tree/smeserver-gitweb-theme

Through IP Repositpory

The following command will configure the Through-IP repository on SME Server.

/sbin/e-smith/db yum_repositories set through-ip repository \
BaseURL http://through-ip.com/packages/smeserver/i386/ \
Name 'Through IP Pty. Ltd.' \
EnableGroups yes \
Visible yes \
GPGCheck no \
status disabled

After adding it to the database we have to update the changes to the configuration file:

signal-event yum-modify

Dag Repositpory

The Git packages comes from the Dag repository. Check the instructions on that wiki page and make sure you use the settings for SME8

Install the SME Server Git RPM's

yum --enablerepo=through-ip --enablerepo=dag install smeserver-git smeserver-gitweb smeserver-gitweb-theme

Using SME Server Git

Ignore self signed SSL certificates

When accessing git on your server, set your git client to ignore self signed SSL certificates with:

git config --global http.sslVerify false

Repository Update Mailing Lists

The configured users for the git repository are automatically added to the mailing list to receive email notifications about changes to the repository.

Feedback

I welcome any feedback on this contrib for bugs, features or assistance (e.g. turning it into an RPM). Email me at the address found at the top of this page.

Additional information

More information about Git can be found on http://git-scm.com/.

---