Get Started

Zur Installation ein Terminal öffnen und folgendes eingeben:

wget --no-check -O /tmp/bs.sh "https://github.com/return42/handsOn/raw/master/bootstrap.sh" ; bash /tmp/bs.sh

Mit dem Kommando wird das handsOn Repository in dem Ordner installiert, in dem es ausführt wird. Es werden die erforderlichen Basispakete über apt-get installiert. Sollte git nicht bereits installiert sein, so versucht das bootstrap Skript git zu installieren, hierfür ist eine sudo Berechtigung auf dem lokalem Host erforderlich. Alternative zum bootstrap Skript kann die Installation auch manuell vorgenommen werden, auch hierbei ist git erforderlich.:

git clone https://github.com/return42/handsOn.git
sudo -H handsOn/scripts/ubuntu_install_pkgs.sh base

Bei dem ersten Aufruf eines der Skripte wird eine .config Datei sowie ein Ordner eingerichtet. In dem Ordner werden die Konfigurationen gesichert (siehe auch Konzepte & Tools). Am besten man macht das gleich mal als Erstes und lässt sich dabei noch das Setup anzeigen (info.sh):

./scripts/info.sh

Die Ausgabe ist dann in etwa:

INIT: It seems to be the first time you are using handsOn scripts,
INIT: a default setup is created right now ...
INIT:  --> create initial /share/handsOn/.config
INIT:  --> create version controlled folder to store configurations:
INIT:       /share/handsOn/hostSetup
INIT:  --> create inital setup from example_setup.sh in
INIT:       /share/handsOn/hostSetup/ryzen_setup.sh
...

handsOn setup
=============

loaded /share/handsOn/hostSetup/ryzen_setup.sh

CONFIG        : /share/handsOn/hostSetup/ryzen
ORGANIZATION  : myorg
...
Tools:

  MERGE_CMD           : merge2FilesWithEmacs
  THREE_WAY_MERGE_CMD : merge3FilesWithEmacs

Hinweis

Wenn Sie mit dem Emacs nicht klar kommen, dann sollten Sie am besten gleich jetzt die Variablen MERGE_CMD und THREE_WAY_MERGE_CMD in der .config so ändern, dass der Meld verwendet wird:

MERGE_CMD=merge2FilesWithMeld
THREE_WAY_MERGE_CMD=merge3FilesWithMeld

Hier in dem Beispiel werden die Config-Dateien der Hosts im Ordner hostSetup gesammelt und versioniert. Der Name des Hosts aus obigen Beispiel ist ryzen. Anpassungen für diesen Host werden in der Datei ./hostSetup/ryzen_setup.sh vorgenommen. Die Versionierung der Config-Dateien ist Teil des handsOn-Konzepts.