Dienst:Homepage: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
D0b (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „Kategorie:DiensteKategorie:Infrastruktur == Dokumentation zur Homepage == * URL: https://kbu.freifunk.net Q: Wie ändere ich was? # Fork auf github e…“) |
D0b (Diskussion | Beiträge) |
||
| Zeile 19: | Zeile 19: | ||
== Einrichten der Entwicklungsumgebung == | == Einrichten der Entwicklungsumgebung == | ||
=== Debian Stable / Wheezy === | |||
* <tt>apt-get install ruby1.9 jekyll bundler git ImageMagick</tt> | * <tt>apt-get install ruby1.9 jekyll bundler git ImageMagick</tt> | ||
* <tt>git clone https://github.com/</tt><Dein_Account><tt>/website</tt> | * <tt>git clone https://github.com/</tt><Dein_Account><tt>/website</tt> | ||
* Im Verzeichnis website: <tt>bundle install</tt> | * Im Verzeichnis website: <tt>bundle install</tt> | ||
=== OSX === | |||
Getestet unter OS 10.6.8 | |||
<pre> | |||
mkdir /verzeichnis/zur/website/ | |||
cd /verzeichnis/zur/website/ | |||
</pre> | |||
Nun werden die notwenigen Jekyll Komponenten installiert. Vorraussetzung ist [https://www.macports.org/ Macports]. | |||
<pre> | |||
sudo port install ruby1.9 gem1.9 ImageMagick git-core Jekyll | |||
</pre> | |||
Jetzt installieren wir noch ''bundler'' | |||
<pre> | |||
gem1.9 install bundler | |||
bundle install | |||
</pre> | |||
Soweit so gut, jetzt können wir: | |||
<pre> | |||
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 | |||
</pre> | |||
== Autodeployment via jenkins == | == Autodeployment via jenkins == | ||
Version vom 9. März 2015, 03:12 Uhr
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
- 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