Difference between revisions of "Git and Gitweb"

Latest revision as of 17:00, 9 January 2021

	Update Needed
	The contents of this page have become outdated or irrelevant. Please consider updating it.

NOTE: There is a one-click app currently in ALPHA being tested.

Git is a free & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Every Git clone is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on network access or a central server. Branching and merging are fast and easy to do. Coupled with Gitweb, provides a web interface for browsing your project.

This tutorial will show you how to install, create a repo, and browse that repo on your HDA.

NOTE: Tested on Fedora 14.

Setup

Create web app (Advanced Settings must be enabled on HDA)

From the Dashboard main page, select Apps at the top.
Choose Webapps
Select New Web App button at the bottom
Enter gitweb for the Name (ensure the path reflects the name correctly)
Choose Create
Open a terminal as root user and do the following:
Install dependencies
```
yum -y install git git-daemon gitweb
```

Look for the ####-gitweb.conf in /etc/httpd/conf.d (#### is some number, i.e. 1000) file and open it in your favorite editor. Add text after ServerAlias line

Text=Alias /git /var/hda/web-apps/gitweb/html
RewriteEngine On
RewriteRule ^git$ git/ [R]
DirectoryIndex gitweb.cgi
SetEnv GITWEB_CONFIG "/etc/gitweb.conf"
AddHandler cgi-script .cgi

Create web page to browse repository

cd /var/hda/web-apps/gitweb
echo '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>Your Page Title</title>
<meta http-equiv="REFRESH" content="0;url=http://gitweb/git/"></HEAD>
<BODY>
Optional page text here.
</BODY>
</HTML>' > html/index.html
chown apache.users html/index.html

Add user

useradd -U -d /var/cache/git -s /usr/libexec/git-core/git-shell git

Set directory permissions

cd /var/cache
chown -R git:git git
chmod 755 git/

Create /etc/init.d/git file and add the following

#!/bin/sh
#
#   Startup/shutdown script for Git Daemon
#
#   Linux chkconfig stuff:
#
#   chkconfig: 345 56 10
#   description: Startup/shutdown script for Git Daemon
#
. /etc/init.d/functions
 
DAEMON=/usr/libexec/git-core/git-daemon
ARGS='--base-path=/var/cache/git --detach --syslog --export-all --user=git --group=git'
 
prog=git-daemon
 
start () {
 echo -n $"Starting $prog: "
 
 # start daemon
 daemon $DAEMON $ARGS
 RETVAL=$?
 echo
 [ $RETVAL = 0 ] && touch /var/lock/git-daemon
 return $RETVAL
}
 
stop () {
 # stop daemon
 echo -n $"Stopping $prog: "
 killproc $DAEMON
 RETVAL=$?
 echo
 [ $RETVAL = 0 ] && rm -f /var/lock/git-daemon
}
 
restart() {
 stop
 start
}
 
case $1 in
 start)
 start
 ;;
 stop)
 stop
 ;;
 restart)
 restart
 ;;
 status)
 status $DAEMON
 RETVAL=$?
 ;;
 *)
 
 echo $"Usage: $prog {start|stop|restart|status}"
 exit 3
esac
 
exit $RETVAL

Set init script to run

chmod 755 /etc/init.d/git;
/etc/init.d/git start
/sbin/chkconfig git on

Set User information (change user.name and user.email accordingly)

git config --global user.name "MyHDA"
git config --global user.email myhda@localhost

Create temporary repository

cd /var/cache/git/
git init test
cd test

Add test file and a short description

echo 'test' > README
git add README
git commit -a -m "initial README file"

Create local repository

cd /var/cache/git/
git clone test test.git
cd test.git
git push origin master

Edit /var/cache/git/test/.git/config and add the following at the bottom (change MyHDA as desired)

[gitweb]
       owner = MyHDA

Add to bottom of /etc/gitweb.conf file

$feature{'blame'}{'default'} = [undef];
$feature{'pickaxe'}{'default'} = [undef];
$feature{'search'}{'default'} = [undef];
$feature{'grep'}{'default'} = 1;
$feature{'snapshot'}{'default'} = ['tgz', 'gzip', 'zip'];
$feature{'snapshot'}{'override'} = 1;
$site_name = "HDA Git";
$projectroot = '/var/cache/git/';
$projects_list_description_width = 50;
$git_temp = "/tmp";
$home_text = "indextext.html";
$site_footer = "indexfooter.html";
$projects_list = $projectroot;
$home_link_str = "http://gitweb / git ";
$stylesheet = "/git/static/gitweb.css";
$logo = "/git/static/git-logo.png";
$favicon = "/git/static/git-favicon.png";
$feature{'pathinfo'}{'default'} = [1];
$my_uri = "http://gitweb/git/";
$home_link = "http://gitweb/git/;"

Copy web files and set permissions

d /var/hda/web-apps/gitweb
cp -r /var/www/git/* html
chown -R apache:users html/

Update local repository description

cd /var/cache/git
sed -i '1d' test.git/.git/description
echo 'Test Repo' >> test.git/.git/description

Edit /etc/httpd/conf.d/git.conf and replace with this text

<Directory /var/hda/web-apps/gitweb/html>     
       RewriteEngine On
       RewriteBase /git/
       RewriteRule ^$ gitweb.cgi  [L]
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteCond %{REQUEST_FILENAME} !-d
       RewriteRule (.*) gitweb.cgi/$1  [QSA,L]
</Directory>

Update permissions, remove temporary repository, and restart web server

chown -R git.git /var/cache/git
rm -rf /var/cache/git/test
/etc/init.d/httpd restart

Complete

That is it. Navigate to http://gitweb/git to browse the newly created repository.

Optional

You can add the Amahi repo by doing the following:

cd /var/cache/git
git clone git://git.amahi.org/amahi.git

References

Hosting your own Git Repository on Fedora 12

Contribute Code

@@ Line 1: / Line 1: @@
+{{NeedsUpdate}}
+'''NOTE:'''  There is a [http://www.amahi.org/apps/gitweb one-click app] currently in ALPHA being tested.
 [http://git-scm.com/ Git] is a free & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency.  Every Git clone is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on network access or a central server. Branching and merging are fast and easy to do.  Coupled with [http://sourceforge.net/apps/trac/sourceforge/wiki/GitWeb%20repository%20browser Gitweb], provides a web interface for browsing your project.
+This tutorial will show you how to install, create a repo, and browse that repo on your HDA.
+'''NOTE:'''  Tested on Fedora 14.
 == Setup==
-[http://wiki.amahi.org/index.php/Open_Terminal_as_root Open a terminal as root] user and do the following:
+<ul>
-* Install dependencies
+<li>Create web app ([[Advanced_Settings|Advanced Settings]] must be enabled on HDA)</li>
-{{Code|yum -y install git git-daemon gitweb}}
+<ol>
-* Add user
+<li>From the Dashboard main page, select '''Apps''' at the top.</li>
-{{Code|useradd -U -d /var/cache/git -s /usr/libexec/git-core/git-shell git}}
+<li>Choose ''Webapps''</li>
-* Set directory permissions
+<li>Select '''New Web App''' button at the bottom</li>
-{{Code|cd /var/cache
+<li>Enter ''gitweb'' for the Name (ensure the path reflects the name correctly)</li>
+<li>Choose '''Create'''</li>
+<li>[[Open_Terminal_as_root|Open a terminal as root]] user and do the following:
+<li>Install dependencies
+<pre>yum -y install git git-daemon gitweb</pre></li>
+<li>Look for the ''####-gitweb.conf'' in '''/etc/httpd/conf.d''' (#### is some number, i.e. 1000) file and open it in your favorite editor.  Add text after '''ServerAlias''' line
+<pre>Text=Alias /git /var/hda/web-apps/gitweb/html
+RewriteEngine On
+RewriteRule ^git$ git/ [R]
+DirectoryIndex gitweb.cgi
+SetEnv GITWEB_CONFIG "/etc/gitweb.conf"
+AddHandler cgi-script .cgi</pre></li>
+<li>Create web page to browse repository</li>
+<pre>cd /var/hda/web-apps/gitweb
+echo '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<title>Your Page Title</title>
+<meta http-equiv<nowiki>=</nowiki>"REFRESH" content<nowiki>=</nowiki>"0;url<nowiki>=</nowiki>http://gitweb/git/"></HEAD>
+<BODY>
+Optional page text here.
+</BODY>
+</HTML>' > html/index.html
+chown apache.users html/index.html</pre></li>
+</ol>
+<li>Add user
+<pre>useradd -U -d /var/cache/git -s /usr/libexec/git-core/git-shell git</pre></li>
+<li>Set directory permissions
+<pre>cd /var/cache
 chown -R git:git git
-chmod 755 git}}
+chmod 755 git/</pre></li>
-* Create public SSH key storage
+<li>Create '''/etc/init.d/git''' file and add the following
-{{Code|cd /var/cache/git;
+<pre>#!/bin/sh
-mkdir .ssh
-chmod 700 .ssh
-touch .ssh/authorized_keys
-chmod 600 .ssh/authorized_keys
-chown -R git:git .ssh/}}
-* Create init script
-{{Code|vi /etc/init.d/git}}
-<blockquote>
-{{Text|Text=#!/bin/sh
 <nowiki>#</nowiki>
 <nowiki>#</nowiki>   Startup/shutdown script for Git Daemon
@@ Line 78: / Line 107: @@
   *)
-  echo $"Usage: $prog {start|stop|restart|status}"
+  echo $"Usage: $prog {start<nowiki>|</nowiki>stop<nowiki>|</nowiki>restart<nowiki>|</nowiki>status}"
   exit 3
 esac
-exit $RETVAL}}</blockquote>
+exit $RETVAL</pre></li>
-* Set init script to run
+<li>Set init script to run
-{{Code|chmod 755 /etc/init.d/git;
+<pre>chmod 755 /etc/init.d/git;
-chkconfig git on
+/etc/init.d/git start
-service git start}}
+/sbin/chkconfig git on</pre></li>
-* Create repository
+<li>Set User information (change '''user.name''' and '''user.email''' accordingly)
-{{Code|cd /var/cache/git/
+<pre>git config --global user.name "MyHDA"
-mkdir test.git
+git config --global user.email myhda@localhost</pre></li>
+<li>Create temporary repository
+<pre>cd /var/cache/git/
+git init test
+cd test</pre></li>
+<li>Add test file and a short description
+<pre>echo 'test' > README
+git add README
+git commit -a -m "initial README file"</pre></li>
+<li>Create local repository
+<pre>cd /var/cache/git/
+git clone test test.git
 cd test.git
-git init --bare
+git push origin master</pre></li>
-chown -R git:git ../test.git/}}
+<li>Edit '''/var/cache/git/test/.git/config''' and add the following at the bottom (change '''MyHDA''' as desired)
-* Add a short description
+<pre>[gitweb]
-{{Code|cd /var/cache/git/test.git/
+        owner = MyHDA</pre></li>
-echo "test test repo" > description}}
+<li>Add to bottom of '''/etc/gitweb.conf''' file
-* Configure user access
+<pre>$feature{'blame'}{'default'} = [undef];
-{{Code|vi config}}
-<blockquote>
-{{Text|Text=[core]
-       repositoryformatversion = 0
-       filemode = true
-       bare = true
-[gitweb]
-        owner = Your Name}}</blockquote>
-* Create local repository and commit
-{{Code|mkdir ~/test
-cd ~/test && git init
-echo 'test' > README
-git add README
-git commit -m "initial README file"}}
-* Create SSH rsa public key
-{{Code|ssh-keygen -t rsa -C "admin@yourisp.com" -N amahi -f /var/cache/git/.ssh/authorized_keys}}
-* Push to the repository
-{{Code|git remote add origin git@git.yourisp.com:test.git
-git push origin master}}
-* Add to bottom of the configuration file
-{{Code|vi /etc/gitweb.conf}}
-<blockquote>
-{{Text|Text=$feature{'blame'}{'default'} = [undef];
 $feature{'pickaxe'}{'default'} = [undef];
 $feature{'search'}{'default'} = [undef];
@@ Line 139: / Line 155: @@
 $feature{'pathinfo'}{'default'} = [1];
 $my_uri = "http://gitweb/git/";
-$home_link = "http://gitweb/git/;"}}</blockquote>
+$home_link = "http://gitweb/git/;"</pre></li>
-* Create custom index.html file
+<li>Copy web files and set permissions
-{{Code|cd /var/hda/web-apps/gitweb
+<pre>d /var/hda/web-apps/gitweb
-vi html/index.html}}
+cp -r /var/www/git/* html
-<blockquote>
+chown -R apache:users html/</pre></li>
-{{Text|Text=<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<li>Update local repository description
-<html>
+<pre>cd /var/cache/git
-<head>
+sed -i '1d' test.git/.git/description
-<title>Your Page Title</title>
+echo 'Test Repo' >> test.git/.git/description</pre></li>
-<meta http-equiv="REFRESH" content="0;url=http://git/git/"></HEAD>
+<li>Edit '''/etc/httpd/conf.d/git.conf''' and replace with this text
-<BODY>
+<pre><Directory /var/hda/web-apps/gitweb/html>
-Optional page text here.
-</BODY>
-</HTML>}}</blockquote>
-* Copy web files and set permissions
-{{Code|cp -r /var/www/git/* html
-chown -R apache:users html}}
-* Modify the web app configuration file as follows
-{{Code|vi /etc/httpd/conf.d/####-gitweb.conf}}
-<blockquote>
-{{Text|Text=Alias /git /var/hda/web-apps/gitweb/html/
-RewriteEngine On
-RewriteRule ^git$ git/ [R]
-DirectoryIndex gitweb.cgi
-SetEnv GITWEB_CONFIG "/etc/gitweb.conf"
-AddHandler cgi-script .cgi
-/etc/httpd/conf.d/git.conf
-<Directory /var/hda/web-apps/gitweb/html>
         RewriteEngine On
         RewriteBase /git/
@@ Line 174: / Line 172: @@
         RewriteCond %{REQUEST_FILENAME} !-d
         RewriteRule (.*) gitweb.cgi/$1  [QSA,L]
-</Directory>}}</blockquote>
+</Directory></pre></li>
-* Restart Apache
+<li>Update permissions, remove temporary repository, and restart web server
-{{Code|/etc/init.d/httpd restart}}
+<pre>chown -R git.git /var/cache/git
+rm -rf /var/cache/git/test
+/etc/init.d/httpd restart</pre></li>
+</ul>
 ==Complete==
-Navigate to <nowiki>http://gitweb/git</nowiki> to browse the newly created repository.
+That is it.  Navigate to <nowiki>http://gitweb/git</nowiki> to browse the newly created repository.
+==Optional==
+You can add the Amahi repo by doing the following:
+<pre>cd /var/cache/git
+git clone git://git.amahi.org/amahi.git</pre>
 ==References==
 [http://www.kutukupret.com/2010/03/26/hosting-your-own-git-repository-on-fedora-12/ Hosting your own Git Repository on Fedora 12]
+[[Contribute_code|Contribute Code]]

Amahi Wiki

Links

Personal tools

Navigation

Tools