Dienst:Homepage

Dokumentation zur Homepage

• URL: https://kbu.freifunk.net

Q: Wie ändere ich was?

1. Fork auf github erstellen.
2. checkout & Aufsetzen der Entwicklungsumgebung (wie unten beschrieben)
3. Ändern und testen
4. Pull-Request mit den Änderungen erstellen

Technik

• Jekyll als Offline / Blogging System. Details: http://jekyllrb.com/

Workflow

• Änderungsvorschläge werden als Pull-Request gegen das github-Repo erstellt (https://github.com/ff-kbu/website - Branch: master)
• Nach dem 4-Augen Prinzip wird der Pull-Request merged -- Kommentare, fragen werden dort hinterlegt
• Existiert eine Änderung, so wird die Homepage stündlich automatisch über jenkins deployed (https://apps.jluehr.de/jenkins/view/KBU/job/kbu-jenkins-deploy/configure)

Einrichten der Entwicklungsumgebung

Debian Stable / Wheezy

• apt-get install ruby1.9 jekyll bundler git ImageMagick
• git clone https://github.com/<Dein_Account>/website
• Im Verzeichnis website: bundle install

OSX

Getestet unter OS 10.6.8

mkdir /verzeichnis/zur/website/
cd /verzeichnis/zur/website/

Nun werden die notwenigen Jekyll Komponenten installiert. Vorraussetzung ist Macports.

sudo port install ruby1.9 gem1.9 ImageMagick git-core Jekyll

Jetzt installieren wir noch bundler

	
gem1.9 install bundler
bundle install

Soweit so gut, jetzt können wir:

jekyll build 	// die Seite bauen
jekyll -w	// uns Änderungen anzeigen lassen
jekyll serve -w	// Einen lokalen Server starten auf port 4000 (http://0.0.0.0:4000) auf dem wir eine Vorschau haben 

Autodeployment via jenkins

Build & Deployment der Homepage

• Schedule: H/5 * * * *
• Kommando

/usr/local/bin/jekyll build
rsync -Havc -e "ssh -p 2222 -l www-data-jenkins" ./_site/ kbu.freifunk.net:/srv/apache2/kbu.freifunk.net/htdocs