|
Related YoLinux Tutorials:
°Subversion & Trac
°Trac wiki markup
°Trac-agile: Agilo
°Trac Plugins
°Jenkins CI
°YoLinux Tutorials Index
Free Information Technology Magazines and Document Downloads
|
| Git Installation and configuration: |
Installation:
- Red Hat Enterprise/CentOS: included with Workstation and Server installation DVD. RPM package "git".
- Ubuntu/Debian: sudo apt-get install git
Installs packages: git-doc git-el git-arch git-cvs git-svn git-email git-daemon-run git-gui gitk gitweb
Create Git repository: git --bare init --shared=group
Populate Git repository:
- git add *
- git commit -m "Initial commit message"
Git client proxy configuration:
- git --global http.proxy http://proxy.megacorp.com:80
or
- export HTTP_PROXY=proxy.megacorp.com:80
Test: config --get http.proxy
Configure repository:
- Make everything group readable and writable: git config core.sharedrepository 1
- Make sure that merges can't happen when you push to the repo. You have to do the merges on your local machine, and then push the result:
git config receive.denyNonFastforwards true
Git client: gitk
- Red Hat: Note that Red Hat does not have a package for Gitk. The latest version is available from github.com: gitk
wget https://raw.github.com/gitster/git/master/gitk-git/gitk
chmod +x gitk
This application requires Tcl/tk.
- Mint/Ubuntu/Debian: apt-get install gitk
May also install dependency tk
Git-web is a Perl cgi web front-end to Git which allows one to view the Git repository.
Git-web Installation:
- Red Hat/CentOS: The RPM package gitweb-caching is available from the Extra Packages for Enterprise Linux (EPEL) website and YUM repository
rpm -ivh gitweb-caching-1.6.5.2-8.b1ab8b5.el6.noarch.rpm
Installs to /var/www/gitweb-caching/...
- Mint/Ubuntu/Debian: apt-get gitweb
CGI installs to /usr/lib/cgi-bin/gitweb.cgi
Configuration:
Configure git-web by creating the file /etc/gitweb.conf and place all changes to the configuration here. Do not edit the installation configuration.
-
File: /etc/gitweb.conf
$projectroot = "/srv/git/projectx/git";
$site_name = "cm2.megacorp.com";
#$home_link_str = "http://cm2.megacorp.com/git-caching/"
$home_link_str = "GIT-Web";
# This just makes the description field wider so you can read # it better
$projects_list_description_width = 100;
# enable blame
$feature{'blame'}{'default'} = [1];
$feature{'patches'}{'default'} = [512];
|
If this is your command: git ls-remote userx@cm2.megacorp.com:/srv/git/projectx/git/master note that the "project root" is one directory higher.
Apache web server configuration file:
- Red Hat: /etc/httpd/conf.d/gitweb-caching.conf
- Mint/Ubuntu/Debian: /etc/apache2/conf.d/gitweb
Add the necessary authentication and authorization. See the YoLinux Apache authentication and authorization tutorial
[Potential Pitfall]: If you get the error in your Apache logs:
-
"... File does not exist: /var/www/gitweb-caching/gitweb.js, referer:. ..."
Download the file from the Git repo: git-1.7.6.1/gitweb/static/gitweb.js
| Gitweb Configuration For Multiple Git Repositories: |
-
File: /etc/gitweb.conf
$projectroot = "/srv/git";
...
...
|
Note:
- The project root is just defined at a higher point in the directory tree. This will cover the repositories held in /srv/git/projectx/git and /srv/git/projecty/.git (for example).
- Use symbolic links to place all repositories under the same heirarchy if the repositories are scattered throughout the file system.
Trac Installation:
- Location of Trac configuration: mkdir /srv/trac
- Initialize the Trac configuration: trac-admin /srv/trac/projectx initenv
-
Project Name [My Project]> projectx
Database connection string [sqlite:db/trac.db]>
- Give yourself admin privileges: trac-admin /srv/trac/midas/ permission add userx TRAC_ADMIN
- Allow the web server to own and access Trac: chown -R apache:apache /srv/trac
- SELinux:
- chcon -R -t httpd_sys_content_t /usr/share/trac/
- chcon -R -t httpd_sys_content_t /srv/trac/
Trac-git integration: also see the GitPlugin wiki page
Trac configuration file: /srv/trac/projectx/conf/trac.ini
-
[trac]
...
## Best to use Trac with a "bare" and up to date repo.
repository_dir = /srv/git/projectx/git/master
## repository_sync_per_request = (default)
repository_type = git
...
[git]
cached_repository = true
persistent_cache = true
git_bin = /usr/bin/git
split_page_names = false
## length revision sha-sums should be tried to be abbreviated to (must be >= 4 and <= 40); default: 7
shortrev_len = 40
## (0.12.0.3+) minimum length for which hex-strings will be interpreted as commit ids in wiki context
wiki_shortrev_len = 40
[header_logo]
alt = Megacorp ProjectX
height = -1
link = /
src = /images/ProjectX_logo.png
width = -1
[attachment]
max_size = 8388608
render_unsafe_content = false
# place at end of file
[components]
tracext.git.* = enabled
|
Note:
| Trac Configuration For Multiple Git Repositories: |
This capability is only available in Trac 0.12 and later.
Trac configuration file: /srv/trac/projectx/conf/trac.ini
-
[trac]
repository_sync_per_request =
...
[repositories]
projectx.description=Project X
projectx.dir = /srv/git/projectx/git/master
projectx.type = git
projectx.url = ssh://localhost/srv/git/projectx/git/master
projecty.description=Project Y
projecty.dir = /srv/git/projecty/.git
projecty.type = git
projecty.url = ssh://localhost/srv/git/projecty/.git
[git]
cached_repository = false
...
|
Note:
Git post-commit hooks to update Trac:
-
File: /srv/git/projectx/git/master/hooks/post-commit
#!/bin/sh
REV=$(git rev-parse HEAD)
trac-admin /srv/trac/projectxy changeset added projectx $REV
|
File: /srv/git/projecty/.git/hooks/post-commit
#!/bin/sh
REV=$(git rev-parse HEAD)
trac-admin /srv/trac/projectxy changeset added projecty $REV
|
Note:
- there is a single Trac instance /srv/trac/projectxy but two Git repositories: projectx and projecty.
- These are executable scripts to be executed by Git.
Trac Admin page for defining multiple repositories:
-
| Trac - Apache httpd web server integration:: |
Trac can be run using the stand-alone Trac daemon "tracd". This configuration shows the use of Apache with Trac.
File: /etc/httpd/conf.d/trac.conf
(Red Hat location)
For more on Apache authentication see:
The final touch is to create a homepage for your repositories so that they are easy to find, especially if you are hosting multiple reporitories.
The default homepage for most major Linux distributions
(Red Hat, Fedora, CentOS, Ubuntu, Debian) is /var/www/html/index.html
Create a home page here or create a redirect to the Trac Wiki home page and post links there.
Redirect to the Trac Wiki
-
<META HTTP-EQUIV="Refresh" Content="0; URL=/trac/projectx">
|
Sample home page:
-
<html>
<head>
<title>Welcome to Project X</title>
</head>
<body>
<h1>Welcome to Project X</h1>
<ul>
<li> <a href="/trac/projectx">Trac Wiki</a> </li>
<li> <a href="/git-caching/">Git-web</a> </li>
<li> <a href="/jenkins">Jenkins</a> </li>
</ul>
</body>
</html>
|
Now add Continuous Build and Integration.
See the YoLinux Jenkins tutorial.
 Books: |
-
|
|
