AWS OpsWorks for Chef Automate, Teil 3 Chef-Cookbooks im Einsatz

Um mit Chef richtig zu arbeiten, müssen wir ein Cookbook mit zugehörigen Rezepten erstellen. In diesem Anwendungsbeispiel werden wir auf einem Linux-Server zur Laufzeit exemplarisch eine neue Webanwendung mit Hilfe eines Chef-Rezepts bootstrappen.

Anbieter zum Thema

PresseBox - unn | UNITED NEWS NETWORK GmbH

Amazon Web Services Germany GmbH

Für unser Beispiel ist es zunächst erforderlich, ein einfaches Cookbook zu erstellen. „Kochbücher“ sind unter Chef das grundlegende Einheit zur Konfiguration und Verteilung von Richtlinien mit Chef. Ein Cookbook definiert ein Szenario – oder einen Konfigurationsstatus – und enthält alles, was zur Unterstützung dieses Szenarios erforderlich ist.

Hierzu zählen in erster Linie die einzelnen Chef-Rezepte, aber auch weitere Vorlagen- und Konfigurationsdateien. Technisch betrachtet gleicht das Cookbook einem Ordner mit einer vorgegeben Struktur, die etwa so aussieht.

Cookbooks müssen in einem Online-Repository gespeichert sein, wahlweise im ZIP-Format oder (besser) in einem S3-Bucket oder einem Quellcode-Repo, in welchen sich Cookbooks auch versionieren lassen. Unterhalb des Ordners mit dem Cookbook-Namen gibt es eine Unterordner-Struktur, die zumindest Dateien der drei Komponenten „Attributes“, „Templates“ und „Recipes“ enthält.

• Die Recipe-Dateien stellen dabei namensgetreu die eigentlichen Rezepte dar. Sie sind in Prinzip Ruby-Anwendungen, die alles definieren, was zum Konfigurieren eines Systems erforderlich ist. Dies umfasst das Erstellen und Konfigurieren von Ordnern, die Installation und Konfiguration von Paketen sowie das Starten von Diensten.

• Attribute Files enthalten eine Reihe von Attributen, die Werte darstellen, die von den Rezepten und Vorlagen verwendet werden können. Attribute-Dateien tragen wie Rezepte die Endung „.rb“.

• Template Files stellen wiederum Rezepte zum Erstellen „anderer“ Dateien dar, z. B. von Konfigurationsdateien. Templates helfen beim Modifizieren von Konfigurationsdateien durch das Überschreiben von Attributen, ohne dass dazu das Cookbook selbst angefasst werden oder eine neue Konfigurationsdatei geschrieben werden muss. Möchte man eine Konfigurationsdatei in einer Instanz auch nur geringfügig ändern, gelingt das am besten mit Hilfe einer Vorlagendatei. Templates tragen die Endung „.erb“

Folgendes Beispiel für ein Rezept dient der Installation von Apache auf einem beliebigen Linux-Node und muss innerhalb des Cookbooks im Subfolder „recipes“ mit einem Dateinamen gespeichert werden, der auf .rb enden.

Das Starter-Kit stellt bereits einen Cookbook-Folder zur Verfügung. Hierzu navigiert man auf seiner Chef-Workstation zu ~/[Name-des-Starter-Kit-Verzeichnis]/cookbooks. Das Erstellen eines neuen Cookbooks namens „simple-webapp“ mit passenden (leeren) Skeletons für Attributes, Templates und Recipes erfolgt dann z. B. durch Eingeben von:

Die Ausgabe sollte so aussehen:

Danach führt man im Verzeichnis des neuen Cookbooks – hier „simple-webapp“ – folgendes Kommando aus, um eine Template-Datei namens „index.html.erb“ zu generieren.

Die Template-Datei muss nun mit Hilfe eines Editors mit Inhalt gefüllt werden, etwa so:

Nun generieren wir wie folgt auch noch eine passende Attributdatei. Dieser Befehl generiert eine neue Attributdatei mit dem Namen „default“.

Diese „befüllen“ wir dann wie folgt:

Jetzt ist es an der Zeit, das noch leere Standard-Rezept anzupassen, wozu wir die Datei „recipes/default.rb mit im Editor der Wahl bearbeiten. Hier hinein kommt jetzt in Ruby-Syntax der Code hinzu, um Apache zu installieren und die Datei /var/www/html/index.html aus der oben erstellten Vorlage zu erzeugen:

Anschließend erweitern wir unser Cookbook dahingehend, das Standard-Cookbook für den „chef-client“ zu verpacken. Ein gängiger Trick dazu ist das Schreiben eines sogenannten Wrapper-Cookbooks. Hierbei handelt es sich um ein Standard-Cookbook, das von anderen Cookbooks und Rezepten abhängt, bzw. darauf verweist.

Auf diese Weise lassen sich vorhandene Rezepte aus dem Chef-Supermarket, z. B. für den „chef-client“, einfach zugänglich machen. Ansatzpunkt dazu ist das Bearbeiten der Datei „metadata.rb“ im Hauptverzeichnis des jeweiligen Cookbooks. Dieses ergänzen wir um die Zeile …

Danach ändern wir noch das Standardabfrageintervall für den Chef-Client von 30 Minuten auf fünf Minuten (300 Sekunden), wozu wir die attributes.rb-Datei um folgende Zeile ergänzen:

„Splay“ ist eine Funktion, die dem Abfrageintervall eine zufällige Anzahl von Sekunden (standardmäßig zwischen 1 und 300) hinzufügt. Durch das Reduzieren auf Null stellen wir sicher, dass der Chef-Client alle fünf Minuten nach Änderungen abfragt. Jetzt müssen wir nur noch unserer Standard-Rezept für die simple-webapp um den Eintrag

erweitern, um den Chef-Client beim Bootstrapping von simple-webapp gleich mit zu installieren.

Rezepte hochladen und anwenden

Zum Hochladen, bzw. Synchronisieren unserer auf der Chef-Workstation verfassten Rezepte installieren wir zunächst ein weiteres Tool namens berkshelf – ein Abhängigkeitsmanager für Chef-Cookbooks. Mit Hilfe von Berkshelf können sich Nutzer ganz einfach auf Community-Cookbooks verlassen und diese sicher in ihren Workflow aufnehmen.

Mit Berkshelf lässt sich auch sicherstellen, dass die jeweiligen CI-Systeme reproduzierbar die gleichen Cookbook-Versionen auswählen und Abhängigkeiten hochladen oder bündeln, ohne dass eine lokal verwaltete Kopie erforderlich ist. Berkshelf ist im Chef Development Kit enthalten. Wurde das Chef-Developement-Kit „ChefDK“ erfolgreich installiert, lässt sich Berkshelf wie folgt bereitstellen:

Die muss im Haupt-Verzeichnis des jeweiligen Cookbooks passieren, indem auch das Berksfile liegt. Die Ausgabe sollte so aussehen:

Nun können wir Berkshelf verwenden, um das neue Cookbook samt seiner Abhängigkeiten wie folgt auf den Chef-Server hochzuladen.

Anschließend listen wir mit dem knife-Befehl alle Cookbooks auf dem Chef-Server auf.

Die Ausgabe sieht in etwa folgendermaßen aus:

Jetzt sind wir in der Lage, mit folgenden Kommando die Chef-Client-Tools auf dem vorhandenen Webserver zu installieren und das Standardrezept (simple-webapp) anzuwenden.

Hierbei ist [WebServer-PrivateIp] die private IP-Adresse des laufenden, hier EC2-basierten Webservers, [EC2InstanceID] seine Instanz-ID und [KeyName] der Namen des Schlüsselpaars für den SSH-Zugriff auf den Webserver. Um die aktualisierte bzw. hierdurch initial erstellte Website zu testen, kann man die URL des Servers aufrufen.

(ID:45619831)