Minimal git Infrastructure - Revision history

320x200 at 21:59, 1 August 2019

2019-08-01T21:59:47Z

← Older revision		Revision as of 21:59, 1 August 2019
Line 114:		Line 114:

	'''Note:''' don't consider this as a fail-proof security thing, if you don't trust the user, maybe you should not give them a shell in the first place.		'''Note:''' don't consider this as a fail-proof security thing, if you don't trust the user, maybe you should not give them a shell in the first place.

			[[Category:git]]

320x200: /* PRO TIPS */

2019-08-01T21:56:11Z

PRO TIPS

← Older revision		Revision as of 21:56, 1 August 2019
Line 104:		Line 104:
	printf "done updating website\n"		printf "done updating website\n"
	</pre>		</pre>

			=== Allowing a Limited User to Push to the Repos ===
			The both great and crappy thing about this setup is that it makes use of the OS level for user management, so if you want to add another committer, you need to give them a shell access to your server. Obviously you're better off with something like gitea if you intend to allow many users to join and contribute to your awesome software, as it will be a PITA to <code>adduser</code> new people all the time.

			However, if it's something exceptional and it's convenient to give someone read-write access to your repos without a full shell access you can do it like this:

			adduser somebody
			chsh -s /usr/bin/git-shell somebody

			'''Note:''' don't consider this as a fail-proof security thing, if you don't trust the user, maybe you should not give them a shell in the first place.

320x200: /* Post-receive hook */

2019-08-01T21:44:02Z

Post-receive hook

← Older revision		Revision as of 21:44, 1 August 2019
Line 78:		Line 78:

	== PRO TIPS ==		== PRO TIPS ==
	=== Post-receive ~~hook~~ ===		=== Post-receive Hook Goodness ===
	Say that one of your repos is a static website, and that you would like to have this very website updated live as you push to your repos and served on your server from <code>/var/www/~~static-website~~</code>. You can tweak the default stagit post-receive git hook to do all this.		Say that one of your repos is a static website, and that you would like to have this very website updated live as you push to your repos and served on your server from <code>/var/www/www.lurk.org</code>. You can tweak the default stagit related post-receive git hook to do all this.

	'''SKIPPED:''' From this point we assume that you have configured your HTTP server to serve ~~static-website~~ from <code>/var/www/~~static-website~~</code> and that of course this path exits.		'''SKIPPED:''' From this point we assume that you have configured your HTTP server to serve www.lurk.org from <code>/var/www/www.lurk.org</code> and that of course this path exits.

	* As root:		* As root:
			setfacl -Rm g:gitusers:rwX /var/www/www.lurk.org/
			setfacl -d -Rm g:gitusers:rwX /var/www/www.lurk.org/

	As any user from the <code>gitusers</code> you can do the following:		As any user from the <code>gitusers</code> you can do the following:
			* Clone the repos
			cd /var/www/www.lurk.org/
			git clone /var/www/git.lurk.org/repos/www.lurk.org.git .
			* Go to your repos' hook folder
			cd /var/www/git.lurk.org/repos/www.lurk.org.git/hooks
			* Delete the current post-receive hook (currently a ''symlink'' to <code>update_single.sh</code>)
			rm post-receive
			* Copy the same script again
			cp ../../../update_single.sh post-receive
			* Edit <code>post-receive</code> and append the following:
			<pre>
			# HERE IS THE EXTRA BIT!
			unset GIT_DIR
			git -C /var/www/www.lurk.org pull
			printf "done updating website\n"
			</pre>

320x200: /* Usage */

2019-08-01T21:26:22Z

Usage

← Older revision		Revision as of 21:26, 1 August 2019
Line 76:		Line 76:
	=== Clone existing repos to contribute ===		=== Clone existing repos to contribute ===
	git clone server-name:/var/www/git.lurk.org/repos/name-of-the-repos.git		git clone server-name:/var/www/git.lurk.org/repos/name-of-the-repos.git

			== PRO TIPS ==
			=== Post-receive hook ===
			Say that one of your repos is a static website, and that you would like to have this very website updated live as you push to your repos and served on your server from <code>/var/www/static-website</code>. You can tweak the default stagit post-receive git hook to do all this.

			'''SKIPPED:''' From this point we assume that you have configured your HTTP server to serve static-website from <code>/var/www/static-website</code> and that of course this path exits.

			* As root:


			As any user from the <code>gitusers</code> you can do the following:

320x200: /* Create local repos and set the git server as origin */

2019-08-01T21:19:59Z

Create local repos and set the git server as origin

← Older revision		Revision as of 21:19, 1 August 2019
Line 66:		Line 66:

	=== Create local repos and set the git server as origin ===		=== Create local repos and set the git server as origin ===
	On your machine and after the repos on the git server was created:		On your machine and '''after the repos on the git server was created''':
	mkdir name-of-the-repos		mkdir name-of-the-repos
	cd name-of-the-repos		cd name-of-the-repos

320x200: /* Create a new repos on the git server */

2019-08-01T21:19:38Z

Create a new repos on the git server

← Older revision		Revision as of 21:19, 1 August 2019
Line 61:		Line 61:
	== Usage ==		== Usage ==
	=== Create a new repos on the git server ===		=== Create a new repos on the git server ===
	This can be done by any user in the group <code>gitusers</code>, ~~not~~ need to be root:		This can be done by any user in the group <code>gitusers</code>, no need to be root:
	cd /var/www/git.lurk.org		cd /var/www/git.lurk.org
	./new_repos.sh name-of-the-repos "oneline about the repos"		./new_repos.sh name-of-the-repos "oneline about the repos"

320x200: /* Create a new repos on the git server */

2019-08-01T21:19:27Z

Create a new repos on the git server

← Older revision		Revision as of 21:19, 1 August 2019
Line 61:		Line 61:
	== Usage ==		== Usage ==
	=== Create a new repos on the git server ===		=== Create a new repos on the git server ===
	This can be done by any user in the group <code>gitusers</code>:		This can be done by any user in the group <code>gitusers</code>, not need to be root:
	cd /var/www/git.lurk.org		cd /var/www/git.lurk.org
	./new_repos.sh name-of-the-repos "oneline about the repos"		./new_repos.sh name-of-the-repos "oneline about the repos"

320x200: /* configs */

2019-08-01T21:06:28Z

configs

← Older revision		Revision as of 21:06, 1 August 2019
Line 22:		Line 22:
	# Optional: further stylify style.css		# Optional: further stylify style.css
	* Get a logo		* Get a logo
	wget https://things.bleu255.com/runyourown/images/d/d5/Runyourown.png -o /var/www/git.lurk.org/logo.png		wget https://things.bleu255.com/runyourown/images/d/d5/Runyourown.png -O /var/www/git.lurk.org/logo.png
	* Copy the following handy shell scripts and put them in <code>/var/www/git.lurk.org/</code>:		* Copy the following handy shell scripts and put them in <code>/var/www/git.lurk.org/</code>:
	** <code>new_repos.sh</code>: https://git.bleu255.com/stagit/file/scripts/new_repos.sh.html		** <code>new_repos.sh</code>: https://git.bleu255.com/stagit/file/scripts/new_repos.sh.html

320x200: /* configs */

2019-08-01T21:05:07Z

configs

← Older revision		Revision as of 21:05, 1 August 2019
Line 22:		Line 22:
	# Optional: further stylify style.css		# Optional: further stylify style.css
	* Get a logo		* Get a logo
			wget https://things.bleu255.com/runyourown/images/d/d5/Runyourown.png -o /var/www/git.lurk.org/logo.png
	* Copy the following handy shell scripts and put them in <code>/var/www/git.lurk.org/</code>:		* Copy the following handy shell scripts and put them in <code>/var/www/git.lurk.org/</code>:
	** <code>new_repos.sh</code>: https://git.bleu255.com/stagit/file/scripts/new_repos.sh.html		** <code>new_repos.sh</code>: https://git.bleu255.com/stagit/file/scripts/new_repos.sh.html

320x200: /* Prerequisites */

2019-08-01T21:03:20Z

Prerequisites

← Older revision		Revision as of 21:03, 1 August 2019
Line 10:		Line 10:
	git clone git://git.codemadness.org/stagit		git clone git://git.codemadness.org/stagit
	cd stagit		cd stagit
			# Optional: edit stagit-index.c to customize some settings like the site header, etc.
	make && make install		make && make install

Line 17:		Line 18:
	* create these directories for your repos and for <code>stagit</code>:		* create these directories for your repos and for <code>stagit</code>:
	mkdir -p /var/www/git.lurk.org/repos		mkdir -p /var/www/git.lurk.org/repos
			* Get a style
			cp /usr/src/stagit/style.css /var/www/git.lurk.org
			# Optional: further stylify style.css
			* Get a logo

	* Copy the following handy shell scripts and put them in <code>/var/www/git.lurk.org/</code>:		* Copy the following handy shell scripts and put them in <code>/var/www/git.lurk.org/</code>:
	** <code>new_repos.sh</code>: https://git.bleu255.com/stagit/file/scripts/new_repos.sh.html		** <code>new_repos.sh</code>: https://git.bleu255.com/stagit/file/scripts/new_repos.sh.html