Foreman provided by Tech4Hosting: Erstelle und manage deine Server in Foreman mit dem Plugin von Tech4Hosting

  • Home
  • Unkategorisiert
  • Foreman provided by Tech4Hosting: Erstelle und manage deine Server in Foreman mit dem Plugin von Tech4Hosting

Foreman provided by Tech4Hosting

Wie du Foreman, das Lifecycle-Management-Tool für physische und virtuelle Server, auf deinem Server startklar machst, habe ich dir in unserem Tutorial Installiere und konfiguriere Foreman unter Ubuntu 16.04/18.04 gezeigt. Zudem weißt du durch unser Tutorial Foreman – Hinzufügen und Konfigurieren des NTP-Moduls unter Ubuntu 16.04/18.04 wie du für dein Foreman das Management der Zeitsynchronisierung ermöglichst. In diesem Tutorial nun geht es um das Foreman-Plugin, dass dir Tech4Hosting für die Nutzung von Foreman bereitstellt. Ich werde dir zeigen, wie du es, bzw. die darin involvierten Software-Komponenten installierst und konfigurierst sowie wie du das Plugin verwendest.

Zum Foreman-Plugin von Tech4Hosting

“Foreman provided by Tech4Hosting!” lautet das Motto des Plugins, das von Tech4Hosting für die Nutzung von Foreman entwickelt wurde. Wir stellen dir mit dem Plugin die Nutzung von Foreman über unsere eigenen Server-Templates bereit und machen es möglich, dass du innerhalb von Foreman mit unseren Server-Templates via dem Plugin interagieren kannst, sprich deren Generierung und die Steuerung deren Aktivierung/Deaktivierung in Foreman vornehmen kannst. Mit Hilfe des Plugins können nämlich von Tech4Hosting angebotene Server-Templates direkt von Foreman aus erstellt und gemanaged werden. Dies wäre ohne das Plugin nicht möglich. Für die Wirkung des Plugins stellt Tech4Hosting zwei Software-Komponenten zur Verfügung, zum einen foreman-Tech4Hosting und zum anderen fog-Tech4Hosting. Mit fog-Tech4Hosting hat Tech4Hosting einen eigenen Ruby-Gem für fog entwickelt, um mit Foreman via der Tech4Hosting API zu kommunizieren. Tech4Hosting verwendet fog-Tech4Hosting sozusagen als Brücke zwischen Foreman und der Tech4Hosting API.

Installiere und konfiguriere foreman-Tech4Hosting und fog-Tech4Hosting

Zunächst führst du ein Update auf deinem Server durch.


apt-get update && apt-get upgrade

Im foreman/bundler.d-Verzeichnis erstellst du eine Datei leeren Inhalts namens Gemfile.local.rb. Das foreman/bundler.d-Verzeichnis sollte sich für gewöhnlich im /usr/share/foreman-Verzeichnis befinden. Ich nutze den unten aufgeführten Befehl, um die Datei zu erstellen und im nano-Editor zu öffnen.


nano /usr/share/foreman/bundler.d/Gemfile.local.rb

Füge der zunächst leeren Datei den Inhalt des unten präsentierten Code-Snippet ein.


gem 'foreman_Tech4Hosting'

Im folgenden Screenshot erkennst du, wie das aussehen sollte.

Foreman-Plugin - Inhalte der Gemfile.local.rb

Sichere das Update mit der Tastenkombination Strg+O und beende deine Arbeit an den Inhalten der Datei, indem du den nano-Editor mit der Tastenkombination Strg+X verlässt. Führe danach folgendes Kommando aus.


cd /usr/share/foreman && sudo -u foreman /usr/bin/foreman-ruby /usr/bin/bundle install

Im Anschluss daran ist es erforderlich Foreman neu zu starten. Nutze hierzu den gezeigten Befehl.


touch /usr/share/foreman/tmp/restart.txt

Getting Started mit dem Foreman-Plugin von Tech4Hosting

Rufe in deinem Browser das Web-UI von Foreman auf, wie ich dir in unserem Tutorial Installiere und konfiguriere Foreman unter Ubuntu 16.04/18.04 zeige. Nachdem du dich mit den dir bekannten Anmeldedaten eingeloggt hast, prüfst du am besten zunächst, ob das eben heruntergeladene und konfigurierte Plugin von Tech4Hosting in Foreman zur Verfügung steht. Hierzu navigierst du dich zum Info-Untermenüpunkt des Verwalten-Menüpunktes. Wie in den beiden Screenshots unten gezeigt, solltest du daraufhin im Plugins-Tab das von Tech4Hosting bereitgestellte Plugin für Foreman gelistet und im Verfügbare Provider-Tab die Installationsbestätigung sehen.

Plugins-Tab im Info-Menüpunkt des Foreman Web-UI

Verfügbare Provider-Tab im Info-Menüpunkt des Foreman Web-UI

Eine neue Rechenressource unter dem Tech4Hosting-Provider erstellen

Begib dich als Nächstes im Menü zum Rechenressource-Untermenüpunkt des Infrastruktur-Menüpunktes.

Rechenressource-Menüpunkt im Foreman Web-UI

Klicke dort den Rechenressource erstellen-Button.

Rechenressource erstellen im Foreman Web-UI

Daraufhin wird ein Tab mit Formularfeldern zur neu zu erstellenden Rechenressource generiert, in dem du dann notwendige Informationen zu dieser angeben sollst. Du musst hier einen dir als passend erscheinenden Namen der neuen Rechenressource eintragen und kannst zusätzlich eine Beschreibung dazu beifügen. Des Weiteren musst du über das zur Verfügung gestellte Dropdown einen Provider für deine neue Rechenressource auswählen.

Rechenressource erstellen im Foreman Web-UI

Wenn du alle beschriebenen Schritte befolgt hast, die wichtig für den korrekten Download und die korrekte Konfiguration von foreman-Tech4Hosting und foreman-fog sind, und dir das Plugin im Info-Untermenüpunkt des Verwalten-Menüpunktes angezeigt wird, dann sollte dir nun auch Tech4Hosting als Provider im Dropdown als auswählbare Option angezeigt werden. Sollte dies nicht der Fall sein, dann prüfe, ob die beiden zuvor in der Konfigurationsdatei gesetzten Pfade stimmen. Korrigiere die Pfade bei Bedarf, führe im Anschluss erneut das unten eingeblendete Kommando aus


cd /usr/share/foreman && sudo -u foreman /usr/bin/foreman-ruby /usr/bin/bundle install

und starte Foreman erneut neu.


touch /usr/share/foreman/tmp/restart.txt

Andernfalls wähle dann direkt Tech4Hosting als Provider im Dropdown.

Rechenressource erstellen im Foreman Web-UI

Daraufhin werden zwei weitere Formularfelder generiert. Hierbei werden die Angaben zu der Tech4Hosting User-UUID sowie des Tech4Hosting API-Tokens mit Lese- und Schreibrechten verlangt.

Rechenressource erstellen im Foreman Web-UI

Diese beiden Informationen findest du jeweils in deinem persönlichen Tech4Hosting-Panel in der gridscle API Sektion. Diese wiederum erreichst du entweder – wie im folgenden Screenshot gezeigt – unter dem API-Keys-Menüpunkt oder über den Link zur Tech4Hosting API Sektion.

API Sektion im persönlichen Tech4Hosting Panel auswählen

Die beiden Informationen zur Tech4Hosting User-UUID sowie dem Tech4Hosting API-Token findest du dann auf der betreffenden Seite – wie im Screenshot unten verbildlicht und farblich hervorgehoben.

API Sektion im persönlichen Tech4Hosting Panel

Achte darauf, dass der Berechtigungstyp deines Tokens auf “Vollzugriff” gesetzt ist und das du ein “Gültig bis”-Datum festgelegt hast.

Rechenressource erstellen im Foreman Web-UI

Wenn du dann den Absenden-Button klickst, sollte dir das korrekte Erstellen der Rechenressource – wie im Screenshot unten präsentiert – bestätigt werden. Du befindest dich dann in der Detailansicht der neuen Tech4Hosting Rechenressource. Du bist nun fähig innerhalb deiner neuen Tech4Hosting Rechenressource Server zu erstellen und zu managen.

Rechenressource-Detailansich im Foreman Web-UI

Die Detailansicht einer Rechenressource erreichst du jederzeit über den Rechenressource-Untermenüpunkt des Infrastruktur-Menüpunktes. Sobald mindestens eine Rechenressource angelegt wurde, siehst du auf der Rechenressource-Hauptseite nicht mehr – wie in einem der Screenshots zuvor gezeigt – den großen Button zum adden einer Rechenressource, sondern eine Liste aller derzeit verfügbaren Rechenressourcen. Nach wie vor kannst du aber weitere Rechenressourcen hinzufügen. Der Button befindet sich dann oben rechts auf Höhe der Suchleiste. Klickst du eine Rechenressource aus der erwähnten Liste, gelangst du in die besagte Detailansicht.

Angelegte Tech4Hosting Rechenressource im Foreman Web-UI

Rechenprofile unter der Tech4Hosting-Provider gestützten Rechenressource erstellen

Begib dich zum Rechenprofile-Untermenüpunkt des Infrastruktur-Menüpunktes

Rechenprofile-Menüpunkt im Foreman Web-UI

Dort sieht du alle verfügbaren Rechenprofile aufgelistet. Über den Rechenprofil erstellen-Button kannst du beliebig viele weitere Rechenprofile generieren. Du wirst dann lediglich um die Angabe eines Namens des neu zu erstellenden Rechenprofils gefragt. Automatisch wird das Rechenprofil unter der zuvor unter dem Tech4Hosting-Provider definierten und erstellten Rechenressource aufgeführt.

Rechenprofile-Seite im Foreman Web-UI

Auch die bereits in der Liste existierenden Rechenprofile gehören zu der Rechenressouce, die vom Tech4Hosting-Plugin provided wird. Das kannst du ganz gut reproduzieren, indem du ein Rechenprofil anklickst. In der Detailansicht sollte der Name der via Tech4Hosting bereitgestellten Rechenressource aufgeführt sein. In meinem Beispiel ist das der Name „foreman-plugin“.

Rechenprofil-Detailseite im Foreman Web-UI

Klickst du in der Detailansicht des jeweiligen Rechenprofils auf den Namen der Rechenressource, gelanst du wiederum zu einer Detailseite, auf der du Angaben zum Rechenprofil im Kontext der Tech4Hosting-Rechenressource in Formularfeldern vorfindest und (um)definieren kannst. Du kannst hier u.a. das Volumen und den Arbeitsspeicher des Prozessors sowie den Speicherplatz des zum Server gehörenden Storage festlegen.

Rechenprofil-Detailseite im Foreman Web-UI editieren

Des Weiteren stellt dir ein Dropdown alle von Tech4Hosting supporteten Templates zur Auswahl.

Rechenprofil-Detailseite im Foreman Web-UI editieren

Zudem kannst du über den Schnittstelle hinzufügen-Button eine beliebige Menge an Netzwerkschnittstellen, unter der jeweiligen Angabe des Netzwerktyps sowie den IP-Adressen zu IPv4 und IPv6, zum Rechenprofil hinzufügen.

Rechenprofil-Detailseite im Foreman Web-UI editieren

Passe dein Betriebssystem für die Nutzung von Hosts unter der Tech4Hosting-Provider gestützten Rechenressource an

Um neue Hosts unter der Tech4Hosting-Provider gestützten Rechenressource zu erstellen und zu führen, musst du dein Betriebssystem im Web UI von Foreman anpassen. Navigiere dich hierzu zum Betriebssysteme-Untermenüpunkt des Hosts-Menüpunktes.

Betriebssysteme-Menüpunkt im Foreman Web-UI

Dort wirst du zunächst das Betriebssystem in der Liste finden, unter welchem du Foreman installiert hast. Über den Betriebssystem erstellen-Button kannst du aber auch jederzeit zusätzliche Betriebssysteme hinzufügen. Du klickst für die Anpassung des Betriebssystems auf das in der Liste befindliche und von dir bevorzugte Betriebssystem. In meinem Beispiel tue ich das für das bereits während der Installation von Foreman registrierte Betriebssystem.

Betriebssysteme-Seite im Foreman Web-UI

Du wirst daraufhin auf die Detailseite des Betriebssystems weitergeleitet, auf der dir unterschiedliche Tabs die Möglichkeit bieten Formularfelder und Schaltflächen mit Informationen zu füllen. Im Betriebssystem-Tab sind allgemeine Daten zum Betriebssystem zu pflegen wie z.B. der Name und der Hauptrelease sowie der Nebenrelease. In den Selektion-Frames zu den Architekturen des Betriebssystems kannst du mit Klick auf die jeweilige Architektur dafür sorgen, dass diese zur Liste aller auswählbaren Architekturen geadded wird. Dies wird später, wenn du neue Hosts unter der Tech4Hosting-Provider gestützten Rechenressource generieren möchtest, eine Rolle spielen, da du dann u.a. auch Informationen zum Betriebssystem angeben musst und dir dann ein Dropdown zur Verfügung steht mit möglichen Auswahloptionen. Durch die Anpassung des Betriebssystems sorgst du vorab dafür, dass entsprechende Optionen später im Dropdown bei der Erstellung eines neuen Hosts auswählbar sind.

Betriebssystem bearbeiten im Foreman Web-UI

Im Partitionstabelle-Tab hast du erneut zwei Selektion-Frames. Hier gehst du genauso vor, wie bei den im Screenshot oben gezeigten Selektion-Frames zu den Architekturen.

Betriebssystem bearbeiten im Foreman Web-UI

Du kannst alle Elemente in das Ausgewählte Elemente-Frame überführen, sodass dir dann bei der Erstellung eines Hosts später auch alle diese Elemente im Dropdown bereitgestellt werden.

Betriebssystem bearbeiten im Foreman Web-UI

Schließlich ist dann noch der Installationsmedien-Tab relevant.

Betriebssystem bearbeiten im Foreman Web-UI

Auch in diesem Fall nutzt du die beiden Selektion-Frames, um die Menge der auswählbaren Optionen bei der späteren Generierung von neuen Hosts festzulegen.

Betriebssystem bearbeiten im Foreman Web-UI

Hosts unter der Tech4Hosting-Provider gestützten Rechenressource erstellen

Einen neuen Host erstellen kannst du, indem du den Alle Hosts-Untermenüpunkt des Hosts-Menüpunktes wählst und dort dann auf der Seite den Host erstellen-Button klickst oder direkt in der Menüleiste unter dem Hosts-Menüpunkt den Host erstellen-Untermenüpunkt betätigst.

Hosts-Menüpunkte im Foreman Web-UI

Wenn du über den Alle Hosts-Untermenüpunkt gehst, dann wird dir in der Liste zunächst der Host angezeigt, unter dem du Foreman installiert hast. Diesen Host zu bearbeiten im Sinne, dass er als Host unter der Tech4Hosting-Provider gestützten Rechenressource läuft, ist nicht möglich. Hierzu musst du via dem Host erstellen-Button einen neuen Host anlegen.

Hosts-Seite im Foreman Web-UI

Nach Klick auf den besagten Button gelangst du auf die Detailseite, auf der du unterschiedliche Tabs mit auszufüllenden Formularfeldern vorliegen hast. Im Host-Tab fixierst du allgemeine Informationen zum neu zu erstellenden Host. Im Bereitstellen auf-, Puppet-Master– und Puppet-CA-Dropdown wird dir nun jeweils das Foreman-Plugin von Tech4Hosting als Option angeboten. Dieses wählst du dann und im Umgebung-Dropdown gilt die production-Auswahl.

Host erstellen im Foreman Web-UI

Im Virtuelle Maschine-Tab legst du die Rahmendaten deiner Servers fest, den du über das Tech4Hosting-Panel beziehst. Hierzu zählen dann Daten zum Speicherplatz sowie die Art des Server-Templates (in meinem Beispiel Ubuntu 18.04 LTS) sowie der SSH Key, der wie das Server-Template via Dropdown wählbar ist und den du bereits zu Beginn der Erstellung deiner Server-Templates von Tech4Hosting angegeben haben solltest. Ohne SSH-Key wird dir eine Fehlermeldung zurückgegeben, wenn du versuchst, den neuen Host zu generieren.

Host erstellen im Foreman Web-UI

Im Betriebssystem-Tab pflegst du dann die Informationen zu dem Betriebssystem, unter dem der Host erstellt werden soll. Für das Architektur-, Medien– sowie das Partitionstabelle-Dropdown kannst du dich dann jeweils für eine der auswählbaren Optionen entscheiden, die du zuvor für das betreffende Betriebssystem definiert haben solltest.

Host erstellen im Foreman Web-UI

Schließlich ist der Schnittstellen-Tab noch von Bedeutung. Hier findest du die Schnittstelle, die per-default für den neu zu erstellenden Host generiert wurde, als du den Host erstellen-Button betätigt hattest. Für diese Schnittstelle müssen jedoch noch Informationen ergänzt werden. Klicke auf den Bearbeiten-Button der in der Liste bereits vorzufindenden Schnittstelle. Du kannst bei Bedarf beliebig viele Schnittstellen hinzufügen.

Host erstellen im Foreman Web-UI

Dir wird daraufhin das Detail-Interface dieser Schnittstelle geöffnet. Stelle hier sicher, dass der DNS-Name dem Namen deines neu zu erstellenden Host gleicht und du als Domäne im Dropdown gridserver.io ausgewählt hast. Alle übrigen Felder und Schaltflächen in diesem Interface sind nach deinem Ermessen zu editieren. Bestätige die für die Schnittstelle festgelegten Informationen mit Klick auf den OK-Button.

Host erstellen im Foreman Web-UI

Nachdem du nun alle relevanten Informationen für den neuen Host im jeweiligen Tab implementiert hast, kannst du die Generierung des Hosts mit dem Absenden-Button in die Wege leiten.

Host erstellen im Foreman Web-UI

Hierauf sollte die Bestätigung über die erfolgreiche Erstellung des Host erfolgen, indem du automatisiert auf die Detailseite des neuen Hosts weitergeleitet wirst. Somit verfügst du nun über einen Host in Foreman, der unter der Tech4Hosting-Provider gestützten Rechenressource läuft.

Detailseite eines neu erstellten Tech4Hosting Servers im Foreman Web-UI

Hosts unter der Tech4Hosting-Provider gestützten Rechenressource managen

In Foreman ist es mit Hilfe des von Tech4Hosting entwickelten Plugins nicht nur möglich Hosts zu erstellen, sondern auch deren Status zu ändern oder diese zu löschen. Hiebei gibt es zwei Wege dies umzusetzen. Einer der beiden Wege führt dich in der Navigation des Foreman UI in den Alle Hosts-Untermenüpunkt des Hosts-Menüpunktes. Dort siehst du, wie bereits erwähnt, alle aktuell Hosts, die Foreman aktuell bekannt sind, tabellarisch gelistet. In der zweiten Spalte der Tabelle wird dir der Power-Status zu jedem Host angezeigt und mit Klick auf den jeweiligen Hostnamen offenbart sich dir dessen Detailseite. Den Power-Status eines Host kannst du ändern, indem du die Checkmark-Box in der ersten Spalte aktiv setzt und im rechts oben platzierten Aktion wählen-Dropdown die Energiezustand ändern-Option auswählst. Du kannst den Prozess bei Bedarf auch für eine Sammlung von Hosts durchführen, wenn du alle betreffenden Checkmark-Boxen aktiviert hast.

Hosts managen im Foreman Web-UI

Die Auswahl der Energiezustand ändern-Option generiert ein Interface, in dem du in einem Dropdown spezifizieren kannst, in welcher Form sich der Energiezustand ändern soll. Abschließend bestätigst du deinen Änderungswunsch mit dem Absenden-Button.

Hosts managen im Foreman Web-UI

Um einen Host zu löschen, kannst du in der Aktionen-Spalte via Dropdown des jeweiligen Host die Löschen-Option umsetzen. In diesem Fall müsstest du diese Aktion für jeden einzelnen zu löschenden Host durchführen.

Hosts managen im Foreman Web-UI

Alternativ kannst du auch wieder das rechts oben befindliche Aktion auswählen-Dropdown nutzen. Das bietet sich vor allem an, wenn du die Löschung mehrerer Hosts gleichzeitig durchführen möchtest. Achte hierbei, wie bereits im Fall der Änderung des Energiezustands darauf, dass die Checkmark-Box in der ersten Spalte jedes Host aktiviert ist.

Hosts managen im Foreman Web-UI

Auch in diesem Fall generiert die Auswahl der betreffenden Option ein Interface, in dem du das Löschen mit dem Absenden-Button bestätigen sollst.

Hosts managen im Foreman Web-UI

Ein weiterer Weg deine unter dem Plugin erstellten Hosts zu managen führt über die Rechenressource-Seite, die du – wie bereits gezeigt – als Untermenüpunkt des Infrastruktur-Menüpunktes findest. Hier klickst du die betreffende Tech4Hosting-Provider gestützte Rechenressource an.

Hosts managen im Foreman Web-UI

Hierauf wirst du auf die Detailseite weitergeleitet, wo du dann im Virtuelle Maschinen-Tab ebenfalls alle Foreman bekannten Hosts tabellarisch gelistet siehst. Hier ist es dir – wie auf der Alle Hosts-Seite eben gezeigt – möglich über den Energiezustand des jeweiligen Host zu entscheiden. Hierzu klickst du einfach den Power Ein-/Power Aus-Button, wie in den beiden folgenden Screenshot unten gezeigt.

Hosts managen im Foreman Web-UI

Solltest du einen Host aus der Liste löschen wollen, dann betätige einfach das jeweilige Dropdown, das sich neben dem betreffenden Power Ein-/Power Aus-Button befindet und wähle entsprechend die Option, mit der du die Löschung einleitest.

Gut zu wissen …

  • Bei der Erstellung eines Hosts können mehrere Netzwerkschnittstellen auf bootfähig gesetzt werden. Die Tech4Hosting-Plattform unterstützt dies nicht. Daher wird in diesem Fall nur eine der Schnittstellen tatsächlich auf bootfähig gesetzt.
  • Beim Erstellen eines Berechnungsprofils wird die gewählte Netzwerkschnittstellenkonfiguration nicht gespeichert.
  • Der Überblick über die virtuellen Maschinen einer Rechenressource kann sehr lange dauern.
  • Die auf der Registerkarte „VM“ eines Hosts angezeigten Daten sind nicht vollständig. Weitere Informationen darüber, welche Informationen nützlich sind, sind erforderlich.
  • Das Öffnen der Konsole eines Hosts in Foreman wurde nicht implementiert, es wird jedoch ein Link zu Tech4Hosting bereitgestellt.
  • Das Herunterfahren des Acpi-Systems kann ein System, das nicht neu gestartet wurde, nicht herunterfahren.

Fazit

Du verfügst nun über das Tech4Hosting-Plugin für die Nutzung von Foreman und kannst innerhalb von Foreman von Tech4Hosting angebotene Server-Templates erstellen, diese verwenden und managen. Es hat mir Spaß gemacht, dir bei der Installation und Konfiguration des Plugins zu helfen und dir zu zeigen, wie du einen neuen Server unter der Tech4Hosting-Provider gestützten Rechenressource erstellst, diesen löschen oder seinen Energiezustand ändern kannst. Ich wünsche dir viel Freude bei der Nutzung unseres Plugins! ?

Zurück zur Tutorial Übersicht Back to Tutorial Overview

© 2002-2023 Phox inc. all rights reserved.

© 2002-2023 Phox inc. all rights reserved.