Dienst:Homepage
Version vom 9. März 2015, 02:22 Uhr von D0b (Diskussion | Beiträge) (→Einrichten der Entwicklungsumgebung)
Dokumentation zur Homepage
Q: Wie ändere ich was?
- Fork auf github erstellen.
- checkout & Aufsetzen der Entwicklungsumgebung (wie unten beschrieben)
- Ändern und testen
- 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
mkdir /verzeichnis/zur/website/ cd /verzeichnis/zur/website/
Notwendige Jekyll Komponenten installieren:
apt-get install ruby1.9 jekyll bundler git ImageMagick git clone https://github.com/ff-kbu/website.git bundle install
OSX
Getestet unter OS 10.6.8
mkdir /verzeichnis/zur/website/ cd /verzeichnis/zur/website/
Notwendige Jekyll Komponenten installieren, vorraussetzung ist Macports:
sudo port install ruby1.9 gem1.9 ImageMagick git-core Jekyll gem1.9 install bundler git clone https://github.com/ff-kbu/website.git bundle install
How to Jekyll
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 // der Seite betrachten können.
Git Repo
Aktuellen Source der Page clonen
git clone https://github.com/ff-kbu/website.git
Wer einen Account auf github hat, kann so von der Shell auf ein neues Repo erstellen:
touch README.md git init git add README.md git commit -m "first commit" git remote add origin https://github.com/username/repo-name.git git push -u origin master
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