MEMOBALL.info » svn

การติดตั้ง SVN & Trac ร่วมกับ Apache ใน Ubuntu

spnball — Fri, 02 Oct 2009 09:11:46 +0000

ช่วงนี้กำลังปรับปรุงระบบ SVN ใหม่อยู่ โดยจะให้การทำ authen ผ่าน .htaccess เดียวกันทั้ง SVN & Trac
จึงได้นำ SVN และ Trac มาผูกรวมกับ Apache ซึ่งเป็นวิธีการติดตั้งที่ง่ายกว่า และสะดวกกว่าการติดตั้งแบบที่นำเสนอครั้งก่อน โดยอาศัย dav_svn กับ mods_python เข้ามาช่วย

จาก WikiBall

เนื้อหา

ติดตั้ง Program ใน Ubuntu

SVN + Apache

ติดตั้ง apache

$ sudo apt-get install apache2

ติดตั้ง svn

$ sudo apt-get install subversion

ติดตั้งโมดูล svn ของ apache

$ sudo apt-get install libapache2-svn

Trac + Apache

การติดตั้ง Trac จำเป็นต้องมี SVN อยู่ก่อนแล้ว
จึงทำการติดตั้ง Trac ดังนี้
ดาวโหลด trac มาใส่ไว้ในที่ไดที่หนึ่งอาจเป็น /home/user ก็ได้ หรืออาจให้ wget ดึงมาเลย

wget http://ftp.edgewall.com/pub/trac/Trac-0.11.5.tar.gz

ระเบิดมัน

tar -xzf Trac-0.11.5.tar.gz

ลง Python setup

$ sudo apt-get install python-setuptools

เข้าไปที่ directory ดังกล่าว Trac-0.11.5 แล้วทำการ install

$ sudo python ./setup.py install

การสร้าง project

สร้าง repository

ตัวอย่างการสร้าง

$ svnadmin create /var/svn/repository/example

นำเข้า (import) project

$ svn import /path/to/projectexample file:///var/svn/repository/example/examplev1 -m"initial import"

สร้าง Trac

การสร้าง project enviroment รันคำสั่ง

$ trac-admin /path/to/myproject initenv

ดู option ต่างๆ ได้ที่ การใช้งาน trac

Enable apache modules

เราต้องทำการ enable apache modules โดยการทำ soft link ใน /etc/apache2/mods-enabled ไปยัง /etc/apache2/mods-available/

$ cd /etc/apache2/mods-enabled
$ sudo ln -s ../mods-available/dav_svn.conf
$ sudo ln -s ../mods-available/dav_svn.load
$ sudo ln -s ../mods-available/mod_python.load

Apache configure

หลังจากลงโปรแกรม แล้ว เราก็จะมากทำการ config เจ้าตัว apache ของเราให้สามารถทำงานได้กัน โดยก่อนอื่นต้องเข้าไปที่ /etc/apache2/sites-available/

configuration file สำหรับ trac

สร้าง config file ใหม่

$sudo vim trac


        SetHandler mod_python
        PythonInterpreter main_interpreter
        PythonHandler trac.web.modpython_frontend
        PythonOption TracEnv /path/to/project/environment
        PythonOption TracUriRoot /uri/path/to/trac/project

ถ้าต้องการทำ authentication ผ่าน .htaccess ของ apache ให้เพิ่มโค้ดด้านล่าง ลงใน Location

        AuthType Basic
        AuthName "Project name"
        AuthUserFile /path/to/.htaccess
        Require valid-user

configuration file สำหรับ subversion

สร้าง config file ใหม่

$sudo vim svn

DAV svn SVNPath /var/svn/repository/rddi/mailgoth/

ถ้าต้องการทำ authentication ผ่าน .htaccess ของ apache ให้เพิ่มโค้ดด้านล่าง ลงใน Location

        AuthType Basic
        AuthName Foo
        AuthUserFile /var/svn/repository/rddi/mailgoth/.htaccess

        require valid-user
        Order deny,allow

Enable site

ทำการ Enable site

$ cd /etc/apache2/sites-enabled/
$ sudo ln -s ../sites-available/svn 002-svn
$ sudo ln -s ../sites-available/trac 002-trac

วิธีสร้าง .htaccess

htpasswd -c .htaccess username

Restart apache

สั่ง restart apache

 $ sudo apache2ctl restart

ถ้าเข้าแล้วยังมี error อยู่ ให้ไปดูที่ /var/log/apache/error.log ว่ามี Error อะไรเกิดขึ้น

การใช้งาน

เข้าใช้งาน Trac : http:/site.name/uri/path/to/trac/project
เข้าใช้งาน SVN : http:/site.name/uri/path/to/svn/project

รับข้อมูลจาก (Reference) :

จาก WikiBall : http://wiki.memoball.info/index.php/SVN+Trac+apache2

หมวดหมู่: SVN | Apache | Trac | Ubuntu

SVN Keywords และการใช้คำสั่ง set properties (setprops)

admin — Mon, 23 Feb 2009 10:09:21 +0000

วันนี้นั่งเขียน auto-props ของ svn อยู่ ก็เลยเอา keywords ของ svn มาใส่เก็บไว้ใน wiki จะได้ง่ายต่อการค้นหา

มาอัพเดตในส่วนของ keywords (Tue Aug 18,2009) ใหม่ โดยจะเพิ่มส่วนของการใช้งานคำสั่ง เพราะเพิ่งค้นพบว่าตัวเองชอบการใช้ command line มากกว่าการใช้ UI ซึ่งอาจเป็นเพราะใช้ Ubuntu Destop/Server เสียจนชิน อีกทั้งการใช้คำสั่งบางอย่าง สามารถทำงานได้สะดวกกว่าการใช้ UI ดังนั้นในที่นี้ จึงจะกล่างถึงแต่เฉพาะการใช้งาน Set proporties ใน svn เท่านั้น

จาก WikiBall

เนื้อหา

Command

propset

ใช้คำสั่ง propset เพื่อทำการสร้างค่า properties ใหม่ให้กับ file ตังตัวอย่างการ set ในส่วนของ copyright โดยชื่อ file สามารถใช้ regular expression ได้ด้วย ซึ่งการใช้ regular expression ใน svn แบบ UI เป็นเรื่องที่ทำยากมาก

$ svn propset copyright '(c) 2003 Red-Bean Software' calc/button.c
property 'copyright' set on 'calc/button.c'

ด้วอย่างด้านล่าง จะเป็นการเปลี่ยนหมดทุกไฟล์ ใน directory

$ svn propset svn:keywords 'Author Date Id Revision HeadURL' *

propedit

proplist

proplist ใช้สำหรับแสดง properties ใน file ในตัวอย่างต้านล่างเป็นการดู properties ทีละหลายๆ ไฟล์ โดยสามารถเลือกดูทีละ file โดยเปลี่ยนจาก * เป็นชื่อ
เราใช้ –verbose สำหรับแสดง value ใน properties ต่างๆ ซึ่งถ้าเราไม่ใส่ เอาพุตที่ออกมานั้นจะเป็นเฉพาะชื่อ properties ที่ทำการตั้งไว้เท่านั้น

$ svn proplist --verbose *
Properties on 'gcp_addressbook.ext.php':
  svn:keywords : Author Date Id Revision HeadURL
Properties on 'gcp_all.ext.php':
  svn:keywords : Author Date Id Revision HeadURL
Properties on 'gcp_compose.ext.php':
  svn:keywords : Author Date Id Revision HeadURL
Properties on 'gcp_list.ext.php':
  svn:keywords : Author Date Id Revision HeadURL
Properties on 'gcp_login.ext.php':
  svn:keywords : Author Date Id Revision HeadURL
Properties on 'gcp_mail.ext.php':
  svn:keywords : Author Date Id Revision HeadURL
Properties on 'gcp_settings.ext.php':
  svn:keywords : Author Date Id Revision HeadURL

Keywords

การใส่ keyword ใน file นั้น สามารถทำได้โดยการใส่ข้อความตามรูปแบบ ชื่อ keyword ที่ต้องการระหว่าง $ ดังต่อไปนี้

$Revision$
$Id$

ไม่ต้องใส่ค่าสงไป เพราะค่าที่ได้จะถูกใส่โดยอัตโนมัติ

Date

สำหรับใส่วันที่ที่การเปลี่ยนแปลงไฟล์ ใน revision นั้นๆ หรือใช้ LastChangedDate. แทนก็ได้ ซึ่งจะให้ผลดังตัวอย่าง

$Date: 2002-07-22 21:42:37 -0700 (Mon, 22 Jul 2002) $

Revision

สำหรับใส่เลข revision หรือใช้ LastChangedRevision หรือ Rev แทนก็ได้

$Revision: 144 $

Author

สำหรับใส่ชื่อผู้เขียนข้อมูลนี้ขึ้น หรือใช้ LastChangedBy แทนก็ได้

$Author: harry $

HeadURL

สำหรับใส่ URL หรือที่อยู่ไฟล์ (ในตำแหน่งสุดท้าย ไม่ขึ้นอยู่กับว่าจะย้ายหรือคัดลอกมาจากไหน) หรือใช้ URL แทนก็ได้

$HeadURL: http://svn.collab.net/repos/trunk/README $

Id

ใส่ทุกอย่างที่จำเป็นต้องมี ดูได้ดังตัวอย่าง คือ ชื่อไฟล์ Revision วันที่และเวลาที่ทำการเปลี่ยนแปลง และผู้เขียน ตามลำดับ

$Id: calc.c 148 2002-07-28 21:30:43Z sally $

ขอบคุณข้อมูลดีๆ จาก ref

http://svnbook.red-bean.com/en/1.1/ch07s02.html#svn-ch-7-sect-2.3.4

รับข้อมูลจาก (Reference) :

จาก WikiBall : http://wiki.memoball.info/index.php/Svn_keyword_and_setprops

หมวดหมู่: SVN

การติดตั้ง svn

admin — Fri, 30 Jan 2009 12:28:05 +0000

หลังจากหัวหมุนกับการใช้งานและการติดตั้ง svn&trac อยู่ซะตั้งนาน แต่ตอนนี้ก็ใช้งานได้แล้วครับ ก้เลยเอาไปเขียนใส่ไว้ใน wiki ของตัวเองซะ ที่นี่ครับ

จาก WikiBall

Subversion เป็นโปรแกรมที่ใชัสร้าง และจัดการ version ของ source code ของเรา

เนื้อหา

การติดตั้ง

สำหรับ Ubuntu

$ sudo apt-get install apt-get install subversion

การใช้งานร่วมกับ apache2

ติดตั้ง apache module

$ sudo apt-get install libapache2-svn

สร้าง diretory ดังตัวอย่าง หรืออย่างอื่นก็ได้

mkdir /var/svn
mkdir /var/svn/repository

แก้ไขค่า permission

chown www-data:www-data -R /var/svn/repository
chmod 770 -R /var/svn/repository

แก้ไข apache svn module configuration file : /etc/apache2/mods-available/dav_svn.conf

...
SVNParentPath /var/svn/repository
#SVNPath /var/svn/repository
.....
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /etc/apache2/dav_svn.passwd
Require valid-user
...

สร้าง htaccess

htpasswd2 -c /etc/apache2/dav_svn.passwd tester

ref : http://www.debuntu.org/2006/05/20/54-how-to-subversion-svn-with-apache2-and-dav

การใช้งาน

สร้าง repository

ตัวอย่างการสร้าง

$ svnadmin create /var/svn/repository/example

นำเข้า (import) project

$ svn import /path/to/projectexample file:///var/svn/repository/example/examplev1 -m"initial import"

การเข้าผ่าน apache

http://servername/svn/project

คู่มือการใช้งาน

การ config svnserve

svnserve คือ daemon สำหรับ svn โดยที่เราสามารถ login ผ่านทาง SVN client ต่างๆ โดยผ่านโปรโตคอล svn

svn://hostname:port/repos

ทดสอบรับ daemon แบบ forground โดยใช้คำสั่ง

$ sudo svnserve -d --listen-port=port --foreground -r  root/path

เรียกเป็น http ใน browser ถ้าขึ้นในลักษณะนี้แสดงว่ารันได้แล้ว

( success ( 1 2 ( ANONYMOUS ) ( edit-pipeline svndiff1 absent-entries ) ) )

ตัว svnserve นี้จะไม่มี file ใน init.d มาให้เราจะต้องสร้างเองดังนี้
สื่อ:svnserve.tar.gz

อย่าลืมตั้งค่า authentication ใน /path/to/repository/conf

SVN Client

สำหรับที่ผู้ที่ไม่อยากใช้ SVN แบบ command line ใช้แบบ command line ไม่เป็น(เช่นเดียวกับผม) จะมี GUI กระต่ายกับเต่า ให้เลือกใช้ได้ดังนี้

ref : http://agaricdesign.com/note/subversion-client-ubuntu-anything-tortoisesvn

svn service file

#!/bin/sh -e
#
# svnserve - brings up the svn server so anonymous users
# can access svn
#

# Get LSB functions
. /lib/lsb/init-functions
. /etc/default/rcS

SVNSERVE=/usr/bin/svnserve
SVN_USER=svn
SVN_GROUP=svn
SVN_REPO_PATH=/var/svn/repository/
SVN_PORT=8000

# Check that the package is still installed
[ -x $SVNSERVE ] || exit 0;

case "$1" in
	start)
		log_begin_msg "Starting svnserve..."
		umask 002
		if start-stop-daemon --start \
		--chuid $SVN_USER:$SVN_GROUP \
		--exec $SVNSERVE \
		-- -d --listen-port=$SVN_PORT -r $SVN_REPO_PATH; then
			log_end_msg 0
		else
			log_end_msg $?
		fi
	;;

	stop)
		log_begin_msg "Stopping svnserve..."
		if start-stop-daemon --stop --exec $SVNSERVE; then
		log_end_msg 0
		else
		log_end_msg $?
		fi
	;;

	restart|force-reload)
		"$0" stop && "$0" start
	;;

	*)
	echo "Usage: /etc/init.d/svnserve {start|stop|restart|force-reload}"
		exit 1
	;;
esac

exit 0

Troubleshooting

import ไม่ได้

svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///Development/subversion/foo'

เหตุการณ์ดังกล่าวเกิดขึ้นได้ 2 กรณี คือ

 #path ดังกล่าวไม่สามารถเข้าไปได้ เช่น ติด permission
 #ใส่ path กับ URL สรับกัน

อื่นๆ ที่เกี่ยวข้อง

รับข้อมูลจาก (Reference) :

จาก WikiBall : http://wiki.memoball.info/index.php/Subversion

หมวดหมู่: SVN

การติดตั้ง subversion เพื่อใช้กับ trac

admin — Wed, 21 Jan 2009 07:34:33 +0000

เนื่องจากเมื่อลง trac แล้วกลับยังใช้ browse source ไม่ได้ จึงได้หาข้อมูลในส่วนนี้ จึงทำให้รู้ว่า trac นั้น จะ run ตรงส่วนของ browse source เป็นเพียงหน้ากากเท่านั้น แต่จะเพิ่มบางส่วนเท่านั้นคือ mileston และ ticket ซึ่งตัวที่รันจริงๆ จะเป็นตัวจัดการโค้ด Subversion (จะเป็นตัวอื่นก็ได้ ไม่จำกัด) ซึ่งการติดตั้ง Subversion จะอยู่ใน

จาก WikiBall

Subversion เป็นโปรแกรมที่ใชัสร้าง และจัดการ version ของ source code ของเรา

เนื้อหา

การติดตั้ง

สำหรับ Ubuntu

$ sudo apt-get install apt-get install subversion

การใช้งานร่วมกับ apache2

ติดตั้ง apache module

$ sudo apt-get install libapache2-svn

สร้าง diretory ดังตัวอย่าง หรืออย่างอื่นก็ได้

mkdir /var/svn
mkdir /var/svn/repository

แก้ไขค่า permission

chown www-data:www-data -R /var/svn/repository
chmod 770 -R /var/svn/repository

แก้ไข apache svn module configuration file : /etc/apache2/mods-available/dav_svn.conf

...
SVNParentPath /var/svn/repository
#SVNPath /var/svn/repository
.....
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /etc/apache2/dav_svn.passwd
Require valid-user
...

สร้าง htaccess

htpasswd2 -c /etc/apache2/dav_svn.passwd tester

ref : http://www.debuntu.org/2006/05/20/54-how-to-subversion-svn-with-apache2-and-dav

การใช้งาน

สร้าง repository

ตัวอย่างการสร้าง

$ svnadmin create /var/svn/repository/example

นำเข้า (import) project

$ svn import /path/to/projectexample file:///var/svn/repository/example/examplev1 -m"initial import"

การเข้าผ่าน apache

http://servername/svn/project

คู่มือการใช้งาน

การ config svnserve

svnserve คือ daemon สำหรับ svn โดยที่เราสามารถ login ผ่านทาง SVN client ต่างๆ โดยผ่านโปรโตคอล svn

svn://hostname:port/repos

ทดสอบรับ daemon แบบ forground โดยใช้คำสั่ง

$ sudo svnserve -d --listen-port=port --foreground -r  root/path

เรียกเป็น http ใน browser ถ้าขึ้นในลักษณะนี้แสดงว่ารันได้แล้ว

( success ( 1 2 ( ANONYMOUS ) ( edit-pipeline svndiff1 absent-entries ) ) )

ตัว svnserve นี้จะไม่มี file ใน init.d มาให้เราจะต้องสร้างเองดังนี้
สื่อ:svnserve.tar.gz

อย่าลืมตั้งค่า authentication ใน /path/to/repository/conf

SVN Client

ref : http://agaricdesign.com/note/subversion-client-ubuntu-anything-tortoisesvn

svn service file

#!/bin/sh -e
#
# svnserve - brings up the svn server so anonymous users
# can access svn
#

# Get LSB functions
. /lib/lsb/init-functions
. /etc/default/rcS

SVNSERVE=/usr/bin/svnserve
SVN_USER=svn
SVN_GROUP=svn
SVN_REPO_PATH=/var/svn/repository/
SVN_PORT=8000

# Check that the package is still installed
[ -x $SVNSERVE ] || exit 0;

case "$1" in
	start)
		log_begin_msg "Starting svnserve..."
		umask 002
		if start-stop-daemon --start \
		--chuid $SVN_USER:$SVN_GROUP \
		--exec $SVNSERVE \
		-- -d --listen-port=$SVN_PORT -r $SVN_REPO_PATH; then
			log_end_msg 0
		else
			log_end_msg $?
		fi
	;;

	stop)
		log_begin_msg "Stopping svnserve..."
		if start-stop-daemon --stop --exec $SVNSERVE; then
		log_end_msg 0
		else
		log_end_msg $?
		fi
	;;

	restart|force-reload)
		"$0" stop && "$0" start
	;;

	*)
	echo "Usage: /etc/init.d/svnserve {start|stop|restart|force-reload}"
		exit 1
	;;
esac

exit 0

Troubleshooting

import ไม่ได้

svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///Development/subversion/foo'

เหตุการณ์ดังกล่าวเกิดขึ้นได้ 2 กรณี คือ

 #path ดังกล่าวไม่สามารถเข้าไปได้ เช่น ติด permission
 #ใส่ path กับ URL สรับกัน

อื่นๆ ที่เกี่ยวข้อง

รับข้อมูลจาก (Reference) :

จาก WikiBall : http://wiki.memoball.info/index.php/Subversion

หมวดหมู่: SVN