[github/shaarli/Shaarli.git] / doc / Create-and-serve-multiple-Shaarlis-(farm).md

#Create and serve multiple Shaarlis (farm)
Example bash script (creates multiple shaarli instances and generates an HTML index of them)

```bash
#!/bin/bash
set -o errexit
set -o nounset

#config
shaarli_base_dir='/var/www/shaarli'
accounts='bob john whatever username'
shaarli_repo_url='https://github.com/shaarli/Shaarli'
ref="master"

#clone multiple shaarli instances
if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi[](.html)
   
for account in $accounts; do
    if [ -d "$shaarli_base_dir/$account" ];[](.html)
	then echo "[info] account $account already exists, skipping";[](.html)
	else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi[](.html)
done

#generate html index of shaarlis
htmlhead='<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<!-- Minimal html template thanks to http://www.sitepoint.com/a-minimal-html-document/ -->
<html lang="en">
	<head>
		<meta http-equiv="content-type" content="text/html; charset=utf-8">
		<title>My Shaarli farm</title>
		<style>body {font-family: "Open Sans"}</style>
	</head>
	<body>
	<div>
	<h1>My Shaarli farm</h1>
	<ul style="list-style-type: none;">'

accountlinks=''
    
htmlfooter='
	</ul>
	</div>
	</body>
</html>'    
    

for account in $accounts; do accountlinks="$accountlinks\n<li><a href=\"$account\">$account</a></li>"; done
if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi[](.html)
echo "[info] generating new index of shaarlis"[](.html)
echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html"
echo '[info] done.'[](.html)
echo "[info] list of accounts: $accounts"[](.html)
echo "[info] contents of $shaarli_base_dir:"[](.html)
tree -a -L 1 "$shaarli_base_dir"
```

This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like [Ansible](https://www.ansible.com/)[](.html)
Commit	Line	Data
5409ade2 A	1	#Create and serve multiple Shaarlis (farm)
	2	Example bash script (creates multiple shaarli instances and generates an HTML index of them)
	3
	4	```bash
	5	#!/bin/bash
	6	set -o errexit
	7	set -o nounset
	8
	9	#config
	10	shaarli_base_dir='/var/www/shaarli'
	11	accounts='bob john whatever username'
	12	shaarli_repo_url='https://github.com/shaarli/Shaarli'
	13	ref="master"
	14
	15	#clone multiple shaarli instances
	16	if [ ! -d "$shaarli_base_dir" ]; then mkdir "$shaarli_base_dir"; fi[](.html)
	17
	18	for account in $accounts; do
	19	if [ -d "$shaarli_base_dir/$account" ];[](.html)
	20	then echo "[info] account $account already exists, skipping";[](.html)
	21	else echo "[info] creating new account $account ..."; git clone --quiet "$shaarli_repo_url" -b "$ref" "$shaarli_base_dir/$account"; fi[](.html)
	22	done
	23
	24	#generate html index of shaarlis
	25	htmlhead='<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
	26	<!-- Minimal html template thanks to http://www.sitepoint.com/a-minimal-html-document/ -->
	27	<html lang="en">
	28	<head>
	29	<meta http-equiv="content-type" content="text/html; charset=utf-8">
	30	<title>My Shaarli farm</title>
	31	<style>body {font-family: "Open Sans"}</style>
	32	</head>
	33	<body>
	34	<div>
	35	<h1>My Shaarli farm</h1>
	36	<ul style="list-style-type: none;">'
	37
	38	accountlinks=''
	39
	40	htmlfooter='
	41	</ul>
	42	</div>
	43	</body>
	44	</html>'
	45
	46
	47
	48	for account in $accounts; do accountlinks="$accountlinks\n<li><a href=\"$account\">$account</a></li>"; done
	49	if [ -d "$shaarli_base_dir/index.html" ]; then echo "[removing old index.html]"; rm "$shaarli_base_dir/index.html" ]; fi[](.html)
	50	echo "[info] generating new index of shaarlis"[](.html)
	51	echo -e "$htmlhead $accountlinks $htmlfooter" > "$shaarli_base_dir/index.html"
	52	echo '[info] done.'[](.html)
	53	echo "[info] list of accounts: $accounts"[](.html)
	54	echo "[info] contents of $shaarli_base_dir:"[](.html)
	55	tree -a -L 1 "$shaarli_base_dir"
	56	```
	57
	58	This script just serves as an example. More precise or complex (applying custom configuration, etc) automation is possible using configuration management software like [Ansible](https://www.ansible.com/)[](.html)