Github clone. You can install portable github system into Unix/Linux.
- Github clone. GitPrep have same interface as GitHub.
- Portable. You can install GitPrep into your Unix/Linux server.
- Support cygwin on Windows(need gcc4 package). You can install GitPrep into Windows.
- Only needs Perl 5.8.7+.
- Smart HTTP support, you can pull and push via HTTP
- CGI support, and having built-in web server, Reverse proxy support.
- SSL support.
Shared Server must support Linux/Unix, Apache, SuExec, CGI, and PHP5(CGI mode).
(PHP is not necessary, if PHP exists, the install process is easy because you do not need to think about permissions.)
Many shared servers support these, so you will be able to find a suitable server easily.
First you need to download gitprep.
https://github.com/yuki-kimoto/gitprep/archive/latest.zip
Expand the zip file. You will see the following directory.
gitprep-latest
Rename the gitprep-latest directory to gitprep.
gitprep-latest -> gitprep
GitPrep needs the git command. You must install git by yourself. If you don't yet set user.name and user.email, you must set them.
git config --global user.name "gitprep"
git config --global user.email "[email protected]"
You must add the correct git command path to the gitprep.conf config file.
[basic]
;;; Git command path
git_bin=/home/yourname/local/bin/git
You upload these directory into server document root by FTP.
Access the following URL by browser.
http://(Your host name)/gitprep/setup/setup.php
(If you don't access PHP file or don't have PHP, you can use CGI script please set this CGI script permission to 755)
http://(Your host name)/gitprep/setup/setup.cgi.
Click Setup button once and wait about 5 minutes.
If you see result, click "Go to Application".
If you receive an internal server error, look at the log file (gitprep/log/production.log) to see what the problem occurred.
GitPrep has its own web server, so you can start using the application very easily. This is much better than the way shown above because you do not need to setup the Apache environment and performance will be much better.
(You can also install GitPrep into Cygwin. If you want to install GitPrep into Cygwin, gcc4 and make program are needed.)
Create a gitprep user. This is not necessary, but recommended.
useradd gitprep
su - gitprep
cd ~
Download tar.gz archive, expand it and change directory.
curl -kL https://github.com/yuki-kimoto/gitprep/archive/latest.tar.gz > gitprep-latest.tar.gz
tar xf gitprep-latest.tar.gz
mv gitprep-latest gitprep
cd gitprep
To setup GitPrep, execute the following command. All of the needed modules will be installed.
./setup.sh
Run the test to check if the setup process was successful or not.
prove t
If "All tests successful" is shown, the setup process was successful.
Same as Shared Server's Configuration section.
You can start the application by running the provided gitprep script. The application is run in the background and the port is 10020 by default.
./gitprep
Then access the following URL.
http://localhost:10020
If you want to change the port, edit gitprep.conf. If you cannot access this port, you might change the firewall settings.
You can stop the application by adding the --stop option.
./gitprep --stop
You can manage the application from the root user.
Start the application
sudo -u gitprep /home/gitprep/gitprep/gitprep
Stop the application
sudo -u gitprep /home/gitprep/gitprep/gitprep --stop
If you want to start the application when the OS starts, add the start application command to rc.local(Linux).
If you want to make it easy to manage gitprep, then create a run script.
mkdir -p /webapp
echo '#!/bin/sh' > /webapp/gitprep
echo 'su - gitprep -c "/home/gitprep/gitprep/gitprep $*"' >> /webapp/gitprep
chmod 755 /webapp/gitprep
You can start and stop the application with the following command.
# Start or Restart
/webapp/gitprep
# Stop
/webapp/gitprep --stop
If you are a developer, you can start the application in development mode.
./morbo
Then access the following URL.
http://localhost:3000
If you have git, it is easy to install from git.
git clone git://github.com/yuki-kimoto/gitprep.git
It is useful to write configuration in gitprep.my.conf, not gitprep.conf.
In Gitprep, blame page use "git blame --line-porcelain". In old git, there is no --line-porcelain option. We don't know when --line-porcelain was added to git. At least, blame page work well in git 1.8.2.1.
It is very easy. you only overwrite all files except for "gitprep.conf".
If you want to upgrade by "git pull", you can do it. you create "gitprep.my.conf" copied from "gitprep.my.conf", and do "git pull"
If you get a rainbow unicorn t-rex error after upgrading, you might be missing a new CPAN dependency. Rerun the /setup/setup.php on brower or rerun setup.sh on command line.
There are some reasons.
1. Git version is old
If you see "error: RPC failed; result=56, HTTP code = 200" , your git maybe old. Please upgrade to latest git. I checked git version 1.8.5.5.
2. GitPrep restriction
GitPrep restrict max post message size 10MB(This is default of Mojolicious)
You maybe see the following error
Delta compression using up to 4 threads.
Compressing objects: 100% (17830/17830), done.
Writing objects: 100% (18281/18281), 687.05 MiB | 129.92 MiB/s, done.
Total 18281 (delta 295), reused 18281 (delta 295)
error: RPC failed; result=22, HTTP code = 413
fatal: The remote end hung up unexpectedly
fatal: The remote end hung up unexpectedly
Please increase increase the value of MOJO_MAX_MESSAGE_SIZE
# 1GB
export MOJO_MAX_MESSAGE_SIZE=1024000000
3. git restriction
git restrict post max size via http protocol. http.postBuffer value of git config is maybe small.
You maybe see the following error message.
error: RPC failed; result=56, HTTP code = 200
fatal: The remote end hung up unexpectedly
Counting objects: 18281, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (17830/17830), done.
Writing objects: 100% (18281/18281), 687.05 MiB | 133.23 MiB/s, done.
Total 18281 (delta 295), reused 18281 (delta 295)
fatal: The remote end hung up unexpectedly
Everything up-to-date
Please increase the value of http.postBuffer.
# 1GB
git config http.postBuffer 1024000000
If you see the following error message in log/production.log
[Wed Feb 12 15:27:02 2014] [error] ... Can't execute git commit ...
you need to set User name and Email of git. Please set user.name and user.email.
git config --global user.name "gitprep"
git config --global user.email "[email protected]"
You can use GitPrep via reverse proxy access
---------------------------- ------------
---->| Web Server(Reverse proxy)|---->|GitPrep |
<----| (Apache, etc) |<----| |
---------------------------- ------------
I show apache config example. You can use Name virtual host.
# HTTP
<VirtualHost *:80>
ServerName myhost.com
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
ProxyRequests Off
ProxyPreserveHost On
ProxyPass / http://localhost:10020/ keepalive=On
ProxyPassReverse / http://localhost:10020/
RequestHeader set X-Forwarded-HTTPS "0"
</VirtualHost>
If you use GitPrep vis https, you should set X-Forwarded-HTTPS Request Header.
# HTTPS
<VirtualHost *:443>
ServerName myhost.com
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
ProxyRequests Off
ProxyPreserveHost On
ProxyPass / http://localhost:10020/ keepalive=On
ProxyPassReverse / http://localhost:10020/
RequestHeader set X-Forwarded-HTTPS "1"
</VirtualHost>
- Config::Tiny
- DBD::SQLite
- DBI
- DBIx::Connector
- DBIx::Custom
- Mojolicious
- Mojolicious::Plugin::INIConfig
- mojo-legacy
- Object::Simple
- Text::Markdown::Discount
- Validator::Custom
These are my Perl web application projects.
- WebDBViewer - Database viewer to see database information on web browser.
- TaskDeal - Setup or deploy multiple environments on web browser. Ruby Chef alternative tool.
Copyright 2012-2013 Yuki Kimoto. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.