Rezeptbuch-Repositorys

Wichtig

Der AWS OpsWorks Stacks Service hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für neue als auch für bestehende Kunden deaktiviert. Wir empfehlen Kunden dringend, ihre Workloads so bald wie möglich auf andere Lösungen zu migrieren. Wenn Sie Fragen zur Migration haben, wenden Sie sich an das AWS Support Team auf AWS re:POST oder über den AWS Premium-Support.

Ihre benutzerdefinierten Rezeptbücher müssen in einem Online-Repository gespeichert sein, entweder in einem Archiv, wie z. B. einer ZIP-Datei, oder in einem Source Control Manager wie Git. Ein Stack kann nur ein benutzerdefiniertes Rezeptbuch-Repository haben. Das Repository kann jedoch eine beliebige Anzahl von Rezeptbüchern enthalten. Wenn Sie die Kochbücher installieren oder aktualisieren, installiert AWS OpsWorks Stacks das gesamte Repository in einem lokalen Cache auf jeder der Instanzen des Stacks. Wenn eine Instance z. B. ein oder mehrere Rezepte ausführen muss, verwendet sie den Code aus dem lokalen Cache.

Im Folgenden wird beschrieben, wie Sie Ihr Rezeptbuch-Repository strukturieren, was abhängig vom Typ ist. Der kursive Text in den Abbildungen stellt benutzerdefinierte Verzeichnis- und Dateinamen dar, darunter der Repository- und Archivname.

Source Control Manager

AWS OpsWorks Stacks unterstützt die folgenden Quellcodeverwaltungsmanager:

• Linux-Stacks — Git und Subversion

• Windows-Stapel — Git

Im Folgenden sehen Sie das erforderliche Verzeichnis und die Dateistruktur:

• Die Rezeptbuch-Verzeichnisse müssen sich alle auf der obersten Ebene befinden.

Archiv

AWS OpsWorks Stacks unterstützt die folgenden Archive:

• Linux-Stacks — Zip-, Gzip-, Bzip2- oder Tarball-Dateien, gespeichert auf Amazon S3 oder einer Website (HTTP-Archiv).

  AWS OpsWorks Stacks unterstützt keine unkomprimierten Tarballs.

• Windows-Stacks — Zip- und TGZ-Dateien (GZIP-komprimiertes Tar), gespeichert auf Amazon S3.

Im Folgenden wird das erforderliche Verzeichnis und die Dateistruktur angezeigt, was davon abhängt, ob Sie einen Linux- oder Windows-Stack ausführen. Die Rezeptbuch-Struktur ist die gleiche wie für SCM-Repositorys, sie wird also durch Auslassungszeichen dargestellt (...).

• Linux-Stacks — Die Kochbuchverzeichnisse müssen in einem Stammverzeichnis enthalten sein.

• Windows-Stacks — Die Kochbücher müssen sich auf der obersten Ebene des Archivs befinden.

  Wenn Sie nur ein Rezeptbuch haben, können Sie optional das Rezeptbuch-Verzeichnis weglassen und die Rezeptbuch-Dateien auf der obersten Ebene platzieren. In diesem Fall erhält AWS OpsWorks Stacks den Namen des Rezeptbuchs von metadata.rb.

Jedes Rezeptbuch-Verzeichnis verfügt über mindestens ein und in der Regel über alle der folgenden Standardverzeichnisse und Dateien, die Standardnamen verwenden müssen:

• attributes— Die Attributdateien des Kochbuches.

• recipes— Die Rezeptdateien des Kochbuches.

• templates— Die Vorlagendateien des Kochbuches.

• andere — Optionale benutzerdefinierte Verzeichnisse, die andere Dateitypen wie Definitionen oder Spezifikationen enthalten.

• metadata.rb— Die Metadaten des Kochbuches.

  Für Chef 11.10 und höher: Wenn Ihre Rezepte von anderen Rezeptbüchern abhängen, müssen Sie entsprechende depends Anweisungen in die Rezeptbuch-Datei metadata.rb einfügen. Wenn Ihr Rezeptbuch beispielsweise ein Rezept mit einem Statement wie include_recipe anothercookbook::somerecipe enthält, muss Ihre Rezeptbuch-Datei metadata.rb die folgende Zeile enthalten: depends "anothercookbook". Weitere Informationen finden Sie unter About Cookbook Metadata.

Vorlagen müssen in einem Unterverzeichnis des templates-Verzeichnisses gespeichert sein. Dieses enthält mindestens eine und optional mehrere Unterverzeichnisse. Diese Unterverzeichnisse können optional auch Unterverzeichnisse haben.

• Vorlagen haben in der Regel ein default-Unterverzeichnis. Dieses enthält die Vorlagendateien, die Chef standardmäßig benutzt.

• andere repräsentiert optionale Unterverzeichnisse, die für betriebssystemspezifische Vorlagen benutzt werden können.

• Chef verwendet automatisch die Vorlage aus dem entsprechenden Unterverzeichnis, basierend auf Benennungskonventionen, welche in File Specificity beschrieben werden. Für die Linux- und Ubuntu-Betriebssysteme können Sie beispielsweise betriebssystemspezifische Vorlagen in Unterverzeichnissen mit dem Namen amazonamazon oder ubuntu hinzufügen.

Die Details, wie Sie mit benutzerdefinierten Rezeptbüchern umgehen, hängen von Ihrem bevorzugten Repository-Typ ab.

So benutzen Sie ein S3-Archiv

1. Implementieren Sie Ihre Rezeptbücher mithilfe der im vorigen Abschnitt gezeigten Ordnerstruktur.

2. Erstellen Sie ein komprimiertes Archiv und laden Sie es in einen Amazon S3 S3-Bucket oder eine Website hoch.

   Wenn Sie Ihre Rezeptbücher aktualisieren, müssen Sie eine neue Archivdatei erstellen und hochladen. Inhalte, die an Amazon-S3-Buckets geliefert werden, können Kundeninhalte enthalten. Weitere Informationen zum Entfernen sensibler Daten finden Sie unter Wie entleere ich einen S3 Bucket? oder Wie lösche ich einen S3 Bucket?.

So verwenden Sie eine SCM

1. Richten Sie ein Git- oder Subversion-Repository ein, indem Sie die bereits gezeigte Struktur verwenden.

2. Optional können Sie die Kontrollfunktionen der Repository-Version benutzen, um mehrere Branches oder Versionen zu implementieren.

   Wenn Sie Ihre Kochbücher aktualisieren, können Sie dies in einer neuen Filiale tun und einfach direkt OpsWorks die neue Version verwenden. Sie können auch bestimmte getaggte Versionen angeben. Details hierzu finden Sie unter Festlegen eines benutzerdefinierten Rezeptbuch-Repositorys.

Installieren von benutzerdefinierten Rezeptbüchernbeschreibt, wie AWS OpsWorks Stacks dein Kochbuch-Repository auf den Instanzen des Stacks installieren lässt.

Wichtig

Nachdem Sie die vorhandenen Kochbücher im Repository aktualisiert haben, müssen Sie den Befehl update_cookbooks stack ausführen, um AWS OpsWorks Stacks anzuweisen, den lokalen Cache jeder Online-Instanz zu aktualisieren. Weitere Informationen finden Sie unter Ausführen von Stack-Befehlen.