Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erste Schritte mit OpsWorks Stacks
<a name="gettingstarted_intro"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

OpsWorks Stacks bietet eine Vielzahl anpassbarer Komponenten, die Sie kombinieren können, um einen Stack zu erstellen, der Ihren spezifischen Zwecken entspricht. Die Herausforderung für neue Benutzer besteht darin zu verstehen, wie sie diese Komponenten zu einem funktionierenden Stack zusammenstellen und effektiv verwalten können. In dieser Anleitung erhalten Sie eine Einführung in diese Themen.


| Wenn Sie … | diese Anleitung durcharbeiten möchten: | 
| --- | --- | 
| Erstellen Sie so schnell wie möglich einen Beispiel-Stack. | [Erste Schritte: Beispiel](gettingstarted-intro.md)  | 
| Experimentieren Sie mit einem Linux-basierten Stack. | [Erste Schritte: Linux](gettingstarted-linux.md) | 
| Experimentieren Sie mit einem Windows-basierten Stack. | [Erste Schritte: Windows](gettingstarted-windows.md) | 
| Lernen Sie, wie Sie Ihre eigenen Chef-Rezeptbücher erstellen. | [Erste Schritte: Rezeptbücher](gettingstarted-cookbooks.md) | 

Wenn Sie über vorhandene Rechenressourcen verfügen — EC2 *Amazon-Instances oder sogar lokale* Instances, die auf Ihrer eigenen Hardware ausgeführt werden — können Sie [diese zusammen mit Instances, die Sie mit Stacks erstellt haben, in einen Stack integrieren](registered-instances.md). OpsWorks Anschließend können Sie OpsWorks Stacks verwenden, um alle zugehörigen Instances als Gruppe zu verwalten, unabhängig davon, wie sie erstellt wurden.

## Unterstützung von Regionen
<a name="gettingstarted-intro-region"></a>

Sie können global auf OpsWorks Stacks zugreifen; Sie können Instanzen auch global erstellen und verwalten. Benutzer können OpsWorks Stacks-Instances so konfigurieren, dass sie in jeder AWS Region außer AWS GovCloud (USA West) und der Region China (Peking) gestartet werden. Um mit OpsWorks Stacks arbeiten zu können, müssen Instances in der Lage sein, eine Verbindung zu einem der folgenden API-Endpunkte für den OpsWorks Stacks-Instanzdienst herzustellen.

Ressourcen können nur in der Region verwaltet werden, in der sie erstellt wurden. Ressourcen, die in einem regionalen Endpunkt erstellt wurden, sind für einen anderen regionalen Endpunkt nicht verfügbar und können auf diesen auch nicht geklont werden. Sie können Instances in beliebigen der folgenden Regionen starten.
+ Region USA Ost (Ohio)
+ Region USA Ost (Nord-Virginia)
+ Region USA West (Oregon)
+ Region USA West (Nordkalifornien)
+ Region Kanada (Zentral) (nur API, nicht verfügbar für Stacks, die in der erstellt wurden AWS-Managementkonsole.)
+ Region Asien-Pazifik (Mumbai)
+ Region Asien-Pazifik (Singapur)
+ Region Asien-Pazifik (Sydney)
+ Region Asien-Pazifik (Tokio)
+ Region Asien-Pazifik (Seoul)
+ Region Europa (Frankfurt)
+ Region Europa (Irland)
+ Region Europa (London)
+ Region Europa (Paris)
+ Region Südamerika (São Paulo)

# Erste Schritte mit einem Beispiel-Stack
<a name="gettingstarted-intro"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Diese exemplarische Vorgehensweise zeigt, wie Sie mit OpsWorks Stacks schnell eine Beispielanwendungsumgebung für Node.js mit nur wenigen Mausklicks und ohne das Schreiben von Code erstellen können. Wenn Sie fertig sind, verfügen Sie über eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance, auf der Chef 12 ausgeführt wird, einen Node.js HTTP-Server und eine Web-App, mit der Sie mit Twitter interagieren und Kommentare auf einer Webseite hinterlassen können.

**Anmerkung**  
[Da beim Abschluss dieser exemplarischen Vorgehensweise automatisch eine Instance mit dem Typ c3.large erstellt wird, können Sie diese exemplarische Vorgehensweise oder das Tool zur Erstellung von **Sample Stacks** in OpsWorks Stacks im kostenlosen Kontingent nicht verwenden.AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/free-tier-limits.html) [Durch die Verwendung des Tools zur Erstellung von **Sample Stacks** in einer VPC wird zwar eine t2.medium-Instance erstellt, diese VPCs sind jedoch derzeit nicht im AWS kostenlosen Kontingent verfügbar.](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/free-tier-limits.html)

# Schritt 1: Erfüllen der Voraussetzungen
<a name="gettingstarted-intro-prerequisites"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Um mit der Anleitung beginnen zu können, müssen Sie die folgenden Einrichtungsschritte ausführen. Zu diesen Einrichtungsschritten gehören die Registrierung für ein AWS Konto, die Erstellung eines Administratorbenutzers und die Zuweisung von Zugriffsberechtigungen für Stacks. OpsWorks 

**Topics**
+ [Registriere dich für ein AWS-Konto](#sign-up-for-aws)
+ [Erstellen eines Benutzers mit Administratorzugriff](#create-an-admin)
+ [Weisen Sie Dienstzugriffsberechtigungen zu](#gettingstarted-intro-prerequisites-permissions)

## Registriere dich für ein AWS-Konto
<a name="sign-up-for-aws"></a>

Wenn Sie noch keine haben AWS-Konto, führen Sie die folgenden Schritte aus, um eine zu erstellen.

**Um sich für eine anzumelden AWS-Konto**

1. Öffnen Sie [https://portal.aws.amazon.com/billing/die Anmeldung.](https://portal.aws.amazon.com/billing/signup)

1. Folgen Sie den Online-Anweisungen.

   Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben.

   Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Benutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

AWS sendet Ihnen nach Abschluss des Anmeldevorgangs eine Bestätigungs-E-Mail. Sie können Ihre aktuellen Kontoaktivitäten jederzeit einsehen und Ihr Konto verwalten, indem Sie zu [https://aws.amazon.com/](https://aws.amazon.com/)gehen und **Mein Konto** auswählen.

## Erstellen eines Benutzers mit Administratorzugriff
<a name="create-an-admin"></a>

Nachdem Sie sich für einen angemeldet haben AWS-Konto, sichern Sie Ihren Root-Benutzer des AWS-Kontos AWS IAM Identity Center, aktivieren und erstellen Sie einen Administratorbenutzer, sodass Sie den Root-Benutzer nicht für alltägliche Aufgaben verwenden.

**Sichern Sie Ihre Root-Benutzer des AWS-Kontos**

1.  Melden Sie sich [AWS-Managementkonsole](https://console.aws.amazon.com/)als Kontoinhaber an, indem Sie **Root-Benutzer** auswählen und Ihre AWS-Konto E-Mail-Adresse eingeben. Geben Sie auf der nächsten Seite Ihr Passwort ein.

   Hilfe bei der Anmeldung mit dem Root-Benutzer finden Sie unter [Anmelden als Root-Benutzer](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) im *AWS-Anmeldung -Benutzerhandbuch* zu.

1. Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA) für den Root-Benutzer.

   Anweisungen finden Sie unter [Aktivieren eines virtuellen MFA-Geräts für Ihren AWS-Konto Root-Benutzer (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) im *IAM-Benutzerhandbuch*.

**Erstellen eines Benutzers mit Administratorzugriff**

1. Aktivieren Sie das IAM Identity Center.

   Anweisungen finden Sie unter [Aktivieren AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-set-up-for-idc.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Gewähren Sie einem Administratorbenutzer im IAM Identity Center Benutzerzugriff.

   *Ein Tutorial zur Verwendung von IAM-Identity-Center-Verzeichnis als Identitätsquelle finden Sie IAM-Identity-Center-Verzeichnis im Benutzerhandbuch unter [Benutzerzugriff mit der Standardeinstellung konfigurieren](https://docs.aws.amazon.com/singlesignon/latest/userguide/quick-start-default-idc.html).AWS IAM Identity Center *

**Anmelden als Administratorbenutzer**
+ Um sich mit Ihrem IAM-Identity-Center-Benutzer anzumelden, verwenden Sie die Anmelde-URL, die an Ihre E-Mail-Adresse gesendet wurde, als Sie den IAM-Identity-Center-Benutzer erstellt haben.

  Hilfe bei der Anmeldung mit einem IAM Identity Center-Benutzer finden Sie [im *AWS-Anmeldung Benutzerhandbuch* unter Anmeldung beim AWS Access-Portal](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html).

**Weiteren Benutzern Zugriff zuweisen**

1. Erstellen Sie im IAM-Identity-Center einen Berechtigungssatz, der den bewährten Vorgehensweisen für die Anwendung von geringsten Berechtigungen folgt.

   Anweisungen hierzu finden Sie unter [ Berechtigungssatz erstellen](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-started-create-a-permission-set.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Weisen Sie Benutzer einer Gruppe zu und weisen Sie der Gruppe dann Single Sign-On-Zugriff zu.

   Eine genaue Anleitung finden Sie unter [ Gruppen hinzufügen](https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

## Weisen Sie Dienstzugriffsberechtigungen zu
<a name="gettingstarted-intro-prerequisites-permissions"></a>

Ermöglichen Sie den Zugriff auf den OpsWorks Stacks-Dienst (und die zugehörigen Dienste, auf die OpsWorks Stacks angewiesen ist), indem Sie Ihrer Rolle oder Ihrem `AmazonS3FullAccess` Benutzer die Berechtigungen `AWSOpsWorks_FullAccess` und hinzufügen.

Weitere Informationen zum Hinzufügen von Berechtigungen finden Sie unter [Hinzufügen von IAM-Identitätsberechtigungen (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policies-console).

Nun haben Sie alle Einrichtungsschritte abgeschlossen und können [mit dieser Anleitung beginnen](gettingstarted-intro-create-stack.md).

# Schritt 2: Erstellen eines Stacks
<a name="gettingstarted-intro-create-stack"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

In diesem Schritt verwenden Sie die OpsWorks Stacks-Konsole, um einen Stack zu erstellen. Ein *Stack* ist eine Sammlung von Instances (z. B. EC2 Amazon-Instances) und zugehörigen AWS Ressourcen, die einen gemeinsamen Zweck haben und die Sie gemeinsam verwalten möchten. (Weitere Informationen finden Sie unter [Stacks](workingstacks.md).) Für diese Anleitung wird nur eine Instance verwendet.

Bevor Sie beginnen, müssen Sie die [Voraussetzungen](gettingstarted-intro-prerequisites.md) erfüllen.

**So erstellen Sie den Stack**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die OpsWorks Konsole unter [https://console.aws.amazon.com/opsworks/](https://console.aws.amazon.com/opsworks/).

1. Führen Sie von den folgenden Schritten die zutreffenden aus:
   + Wenn die Seite **Willkommen bei OpsWorks Stacks** angezeigt wird, wählen Sie **Add your first stack** oder **Add your OpsWorks first Stacks stack** (beide Optionen bewirken dasselbe). Die Seite **Add stack (Stack hinzufügen)** wird angezeigt.
   + Wenn die **OpsWorks Dashboard-Seite** angezeigt wird, wählen Sie Stapel **hinzufügen**. Die Seite **Add stack (Stack hinzufügen)** wird angezeigt.

1. Wählen Sie bei geöffneter Seite **Add stack (Stack hinzufügen)** die Option **Sample stack (Beispiel-Stack)** aus, falls sie nicht bereits für Sie ausgewählt ist.

1. Wenn **Linux (Linux)** bereits als **Operating system type (Betriebssystemtyp)** ausgewählt ist, wählen Sie **Create Stack (Stack erstellen)** aus:

     
![\[Add stack interface with options for Sample stack, Chef 12 stack, and Chef 11 stack.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-add-stack-console.png)

   

1. OpsWorks Stacks erstellt einen Stack mit dem Namen **My Sample Stack (Linux)**. OpsWorks Stacks fügt dem Stack außerdem alle für die Bereitstellung der App erforderlichen Komponenten hinzu:
   + Eine *Ebene* als Vorlage für eine Gruppe von Instances. Über den Layer werden unter anderem die Einstellungen, Ressourcen, installierten Pakete und Sicherheitsgruppen der Instance festgelegt. (Weitere Informationen finden Sie unter [Layer](workinglayers.md).) Die Ebene hat den Namen **Node.js App Server (Node.js-Anwendungsserver)**.
   + Eine *Instance*, in diesem Fall eine Amazon Linux EC2 2-Instance. Weitere Informationen zu Instances finden Sie unter [Instances](workinginstances.md). Der Hostname der Instance ist **nodejs-server1 (nodejs-server1)**.
   + Eine *Anwendung*, also Code, der auf der Instance ausgeführt wird. Weitere Informationen zu Apps finden Sie unter [Apps](workingapps.md). Die Anwendung hat den Namen **Node.js Sample App (Node.js-Beispielanwendung)**.

1. **Nachdem OpsWorks Stacks den Stack erstellt hat, wählen Sie **Explore the sample stack** (Linux), um die Seite **My Sample Stack (Linux)** aufzurufen (wenn Sie diese exemplarische Vorgehensweise mehrmals durchführen, kann hinter **My Sample Stack (Linux)** eine fortlaufende Nummer stehen, z. B. **2 oder 3**):**

     
![\[Checklist showing completed steps for setting up a sample stack with Node.js App Server.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-add-stack-explore-console.png)

   

Im [nächsten Schritt](gettingstarted-intro-start-instance.md) starten Sie die Instance und stellen die Anwendung in der Instance bereit.

# Schritt 3: Starten der Instance und Bereitstellen der App
<a name="gettingstarted-intro-start-instance"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Nachdem Sie nun eine Instance und eine App haben, starten Sie die Instance und stellen Sie die App auf der Instance bereit.

**So starten Sie die Instance und stellen die App bereit**

1. Führen Sie eine der folgenden Aktionen aus:
   + Wählen Sie im Service-Navigationsbereich **Instances** aus:

       
![\[Menu options including Stack, Layers, and Instances with Instances circled in red.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-nav-pane-console.png)

     
   + Wählen Sie auf der Seite **My Sample Stack (Linux) (Mein Beispiel-Stack (Linux))** die Option **Instances** aus:

       
![\[AWS stack interface showing layers and instances, with one Node.js App Server instance stopped.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-instances-console.png)

     

1. Wählen Sie auf der Seite **Instances** für **Node.js App Server (Node.js-Anwendungsserver)** und **nodejs server1 (nodejs-server1)** die Option **start (Starten)** aus:

     
![\[Node.js App Server interface showing a stopped instance with start and delete options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-start-instance-console.png)

   

1. Fahren Sie erst fort, wenn der Punkt neben **online (Online)** grün leuchtet. Wenn eine Fehlermeldung angezeigt wird, lesen Sie unter [Handbuch zur Fehlersuche und Fehlerbehebung](troubleshoot.md) weiter.

1. Während die Instanz eingerichtet wird, stellt OpsWorks Stacks die App auf der Instanz bereit.

1. Bevor Sie fortfahren, muss Ihr Ergebnis wie auf der Abbildung dargestellt aussehen. Falls eine Fehlermeldung angezeigt wird, lesen Sie unter [Handbuch zur Fehlersuche und Fehlerbehebung](troubleshoot.md) weiter:

     
![\[OpsWorks instance dashboard showing one online Node.js App Server instance.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-instance-started-console.png)

   

Sie verfügen jetzt über eine Instance mit einer darauf bereitgestellten App.

Im [nächsten Schritt](gettingstarted-intro-test-app.md) werden Sie die Anwendung in der Instance testen.

# Schritt 4: Testen der bereitgestellten Anwendung in der Instance
<a name="gettingstarted-intro-test-app"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Testen Sie die Ergebnisse der App-Bereitstellung auf der Instance.

**So testen Sie die Bereitstellung auf der Instance**

1. Wählen Sie auf der im letzten Schritt angezeigten Seite **Instances** unter **Node.js App Server (Node.js-Anwendungsserver)**, **nodejs server1 (nodejs-server1)** und **Public IP (Öffentliche IP)** die IP-Adresse aus.

     
![\[OpsWorks instance dashboard showing one online Node.js server in us-west-2a.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-instance-ip-console.png)

   

1. Geben Sie auf der Glückwunsch-Webseite im Textfeld **Leave a comment (Kommentar eingeben)** einen Kommentar ein und wählen Sie **Send (Senden)** aus, um die Anwendung zu testen. Die Anwendung fügt den Kommentar zur Webseite hinzu. Sie können beliebig oft Kommentare hinterlassen und **Send (Senden)** auswählen.

     
![\[Congratulatory message for deploying first app with AWS OpsWorks, featuring stylized landmarks.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-test-app.png)

   

1. Wenn du ein Twitter-Konto hast, wähle **Tweet** oder **Follow @ AWSOps Works und folge** den Anweisungen auf dem Bildschirm, um über die App zu twittern oder @ Works zu folgen. AWSOps

Sie haben jetzt die bereitgestellte Anwendung erfolgreich auf der Instance getestet.

In den verbleibenden Schritten können Sie die OpsWorks Stacks-Konsole verwenden, um die Einstellungen des Stacks und seiner Komponenten zu erkunden. Im [nächsten Schritt](gettingstarted-intro-explore-stack.md)beginnen Sie dann damit, die Einstellungen des Stacks genauer zu untersuchen.

# Schritt 5: Betrachten der Stack-Einstellungen
<a name="gettingstarted-intro-explore-stack"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Untersuchen Sie, wie OpsWorks Stacks den Stack eingerichtet hat.

**So zeigen Sie die Einstellungen des Stacks an**

1. Wählen Sie in der Service-Navigationsleiste **Stack (Stack)** aus. Die Seite **My Sample Stack (Linux) (Mein Beispiel-Stack (Linux))** wird angezeigt.

1. Wählen Sie **Stack Settings (Stack-Einstellungen)** aus. Die Seite **Settings My Sample Stack (Linux) (Einstellungen von Mein Beispiel-Stack (Linux))** wird angezeigt:

     
![\[Settings page for My Sample Stack (Linux) showing configuration details like region and OS.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-stack-page-console.png)

   

Um weitere Informationen zu vielen der Einstellungen zu erhalten, wählen Sie **Edit (Bearbeiten)** aus und bewegen Sie den Mauszeiger über die einzelnen Einstellungen. Es sind jedoch nicht für alle Einstellungen Beschreibungen verfügbar. Weitere Informationen zu diesen Einstellungen finden Sie unter [Erstellen eines neuen Stacks](workingstacks-creating.md).

Um das in dieser Komplettlösung verwendete Chef-Kochbuch zu erkunden, öffnen Sie das [opsworks-linux-demo-cookbooks-nodejs-Repository](https://github.com/awslabs/opsworks-linux-demo-cookbook-nodejs) unter. GitHub

Im [nächsten Schritt](gettingstarted-intro-explore-layer.md) können Sie die Einstellungen der Ebene genauer untersuchen.

# Schritt 6: Betrachten der Einstellungen des Layers
<a name="gettingstarted-intro-explore-layer"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Untersuchen Sie, wie OpsWorks Stacks die Ebene eingerichtet hat.

**So zeigen Sie die Einstellungen des Layers an**

1. Wählen Sie im Service-Navigationsbereich **Layers** aus. Die Seite **Layers** wird angezeigt.

1. Wählen Sie **Node.js App Server (Node.js-Anwendungsserver)** aus. Die Seite **Layer Node.js App Server (Ebene von Node.js-Anwendungsserver)** wird angezeigt. Um die Einstellungen der Ebene anzusehen, wählen Sie **General Settings (Allgemeine Einstellungen)**, **Recipes (Rezepte)**, **Network (Netzwerk)**, **EBS Volumes (EBS-Volumes)** und **Security (Sicherheit)** aus.

     
![\[Node.js App Server layer settings with name, short name, and configuration options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-layers-page-console.png)

   

Um weitere Informationen zu vielen der Einstellungen zu erhalten, wählen Sie **Edit (Bearbeiten)** aus und bewegen Sie den Mauszeiger über die einzelnen Einstellungen. Es sind jedoch nicht für alle Einstellungen Beschreibungen verfügbar. Weitere Informationen zu diesen Einstellungen finden Sie unter [Bearbeiten der Konfiguration einer Ebene OpsWorks](workinglayers-basics-edit.md).

Im [nächsten Schritt](gettingstarted-intro-explore-instance.md) können Sie die Einstellungen und Protokolle der Instance genauer betrachten.

# Schritt 7: Betrachten der Einstellungen und Protokolle der Instance
<a name="gettingstarted-intro-explore-instance"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Untersuchen Sie die Einstellungen, die OpsWorks Stacks zum Starten der Instance verwendet hat. Sie können auch die Instanzprotokolle untersuchen, die OpsWorks Stacks erstellt hat.

**So zeigen Sie die Einstellungen und Protokolle der Instance an**

1. Wählen Sie im Service-Navigationsbereich **Instances** aus. Die Seite **Instances** wird angezeigt.

1. Wählen Sie für **Node.js App Server (Node.js-Anwendungsserver)** den Namen **nodejs-server1 (nodejs-server1)** aus. Die Eigenschaftenseite der Instance wird angezeigt.

     
![\[Details of a stopped Node.js server instance on AWS, showing configuration and resource information.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-instance-details-page-console.png)

   

1. Um die Protokolle der Instance zu betrachten, wählen Sie im Bereich **Logs (Protokolle)** für **Log (Protokoll)** die Option **show (Anzeigen)** aus.

     
![\[Log entries showing configure and setup commands with timestamps and durations.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-instance-details-logs-console.png)

   

1. OpsWorks Stacks zeigt das Protokoll in einem separaten Webbrowser-Tab an.

     
![\[Log output showing AWS OpsWorks instance startup and chef-client initialization process.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-instance-log-console.png)

   

Um weitere Informationen zur Bedeutung einzelner Instance-Einstellungen zu erhalten, rufen Sie die Seite **nodejs-server1 (nodejs-server1)** erneut auf und wählen Sie **Stop (Anhalten)** aus. Nachdem die Bestätigung angezeigt wurde, wählen Sie **Stop (Anhalten)** aus. Wählen Sie **Edit (Bearbeiten)** aus, nachdem der **Status** von **stopping (Wird angehalten)** zu **stopped (Angehalten)** gewechselt hat, und bewegen Sie den Mauszeiger über die einzelnen Einstellungen. Es sind jedoch nicht für alle Einstellungen Beschreibungen verfügbar. Weitere Informationen zu diesen Einstellungen finden Sie unter [Hinzufügen einer Instance zu einem Layer](workinginstances-add.md).

Nachdem Sie die Einstellungen überprüft haben, wählen Sie **Start (Starten)** aus, um die Instance neu zu starten, und warten Sie, bis **Status (Status)** zu **online (Online)** wechselt. Solange die Instance angehalten ist, können Sie später die App sonst nicht testen.

**Anmerkung**  
Wenn Sie sich bei der Instance anmelden möchten, um sie weiter zu erkunden, müssen Sie OpsWorks Stacks zunächst Informationen über Ihren öffentlichen SSH-Schlüssel zur Verfügung stellen (den Sie mit Tools wie ssh-keygen oder Pu erstellen könnenTTYgen) und dann müssen Sie Berechtigungen für den **My Sample Stack (Linux) -Stack** festlegen, damit sich Ihr Benutzer bei der Instance anmelden kann. Anweisungen finden Sie unter [Registrierung des öffentlichen SSH-Schlüssels eines Benutzers](security-settingsshkey.md) und [Anmelden mit SSH](workinginstances-ssh.md).

Im [nächsten Schritt](gettingstarted-intro-explore-app.md) lernen Sie die Anwendungseinstellungen kennen.

# Schritt 8: Betrachten der App-Einstellungen
<a name="gettingstarted-intro-explore-app"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Untersuchen Sie die Einstellungen, die OpsWorks Stacks für die App verwendet hat.

**So zeigen Sie die App-Einstellungen an**

1. Wählen Sie im Service-Navigationsbereich **Apps (Anwendungen)** aus. Die Seite **Apps (Anwendungen)** wird angezeigt.

1. Wählen Sie **Node.js Sample App (Node.js-Beispielanwendung)** aus. Die Seite **App Node.js Sample App (Anwendung Node.js-Beispielanwendung)** wird angezeigt:

     
![\[Node.js Sample App settings page showing app details, source, and data sources.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-app-details-page-console.png)

   

Um zu erfahren, was die einzelnen Einstellungen bewirken, wählen Sie **Edit (Bearbeiten)** aus und bewegen Sie den Mauszeiger über die einzelnen Einstellungen. Es sind jedoch nicht für alle Einstellungen Beschreibungen verfügbar. Weitere Informationen zu den Einstellungen finden Sie unter [Hinzufügen von Apps](workingapps-creating.md).

Im [nächsten Schritt](gettingstarted-intro-explore-monitoring.md) können Sie die Überwachungsberichte für die Ebene betrachten.

# Schritt 9: Betrachten der Layer-Überwachungsberichte
<a name="gettingstarted-intro-explore-monitoring"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Untersuchen Sie Berichte, die OpsWorks Stacks über die Rechenleistung der Ebene generiert.

**So zeigen Sie die Layer-Überwachungsberichte an**

1. Wählen Sie im Service-Navigationsbereich **Monitoring (Überwachung)** aus. Die Seite **Monitoring Layers (Ebenenüberwachung)** wird angezeigt.

1. Um weitere Ansichten zu betrachten, wählen Sie die Pfeile neben **CPU (CPU)**, **Memory (Arbeitsspeicher)**, **Load (Load)** und der Uhrzeit aus:  
![\[Monitoring Layers dashboard showing CPU, Memory, Load, and Processes metrics with expandable options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-monitoring-page-console.png)

Weitere Informationen zu diesen und anderen Berichten finden Sie unter [Amazon verwenden CloudWatch](monitoring-cloudwatch.md) und [Überwachen](monitoring.md).

Im [nächsten Schritt](gettingstarted-intro-explore-more.md) können Sie zusätzliche Stack-Einstellungen betrachten.

# Schritt 10: Betrachten von zusätzlichen Stack-Einstellungen
<a name="gettingstarted-intro-explore-more"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

In diesem Schritt können Sie zusätzliche Stack-Einstellungen betrachten.

OpsWorks ****Stacks führte keine separaten Bereitstellungen durch, stellte keine zusätzlichen Ressourcen bereit und passte keine zusätzlichen Berechtigungen als Teil dieses Stacks an, sodass die Seiten **Bereitstellungen und Befehle, Ressourcen und** Berechtigungen nicht sonderlich interessant sind.**** Wenn Sie sich diese Einstellungen trotzdem ansehen möchten, wählen Sie im Service-Navigationsbereich entsprechend **Deployments (Bereitstellungen)**, **Resources (Ressourcen)** und **Permissions (Berechtigungen)** aus. Wenn Sie Informationen zu diesen Seiten benötigen, finden Sie diese unter [Bereitstellen von Anwendungen](workingapps-deploying.md), [Ressourcenmanagement](resources.md) und [Verwalten von Benutzerberechtigungen](opsworks-security-users.md).

Im [nächsten Schritt](gettingstarted-intro-clean-up.md) können Sie die AWS Ressourcen bereinigen, die Sie für diese exemplarische Vorgehensweise verwendet haben. Dieser nächste Schritt ist optional. Möglicherweise möchten Sie diese AWS Ressourcen weiterhin verwenden, wenn Sie mehr über OpsWorks Stacks erfahren. Wenn Sie diese AWS Ressourcen behalten, kann dies jedoch zu laufenden Gebühren für Ihr AWS Konto führen. Wenn Sie diese AWS Ressourcen für eine spätere Verwendung behalten möchten, haben Sie diese exemplarische Vorgehensweise nun abgeschlossen, und Sie können [Nächste Schritte](gettingstarted-intro-next-steps.md) weitermachen.

# Schritt 11 (Optional): Bereinigen
<a name="gettingstarted-intro-clean-up"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Um zu verhindern, dass zusätzliche Gebühren für dein AWS Konto anfallen, kannst du die App und die AWS Ressourcen, die für diese Komplettlösung verwendet wurden, löschen, einschließlich der Instanz und des Stacks-Stacks. OpsWorks [(Weitere Informationen finden Sie unter Preisgestaltung.)OpsWorks](https://aws.amazon.com/opsworks/pricing/) Möglicherweise möchten Sie diese AWS Ressourcen jedoch weiterhin nutzen, um mehr über OpsWorks Stacks zu erfahren. Wenn Sie diese AWS Ressourcen weiterhin verfügbar halten möchten, haben Sie diese exemplarische Vorgehensweise nun abgeschlossen, und Sie können weitermachen. [Nächste Schritte](gettingstarted-intro-next-steps.md)

Inhalte, die in den Ressourcen gespeichert sind, die Sie für diese schrittweise Anleitung erstellt haben, können persönlich identifizierende Informationen enthalten. Wenn Sie nicht mehr möchten, dass diese Informationen von AWS gespeichert werden, führen Sie die in diesem Thema beschriebenen Schritte aus.

**So löschen Sie die Anwendung aus dem Stack**

1. Wählen Sie im Service-Navigationsbereich **Apps (Anwendungen)** aus. Die Seite **Apps (Anwendungen)** wird angezeigt.

1. Wählen Sie für **Node.js Sample App (Node.js-Beispielanwendung)** und **Actions (Aktionen)** die Option **delete (Löschen)** aus. Wählen Sie im Bestätigungsdialogfeld **Delete (Löschen)** aus. Nachdem die Anwendung gelöscht wurde, wird die Meldung **No apps (Keine Anwendungen)** angezeigt.

**So löschen Sie die Instance für den Stack**

1. Wählen Sie im Service-Navigationsbereich **Instances** aus. Die Seite **Instances** wird angezeigt.

1. Wählen Sie für **Node.js App Server (Node.js-Anwendungsserver)**, **nodejs-server1 (nodejs-server1)** und **Actions (Aktionen)** die Option **stop (Anhalten)** aus. Wählen Sie im Bestätigungsdialogfeld **Stop** aus.

   Dieser Vorgang kann einige Minuten dauern. Wenn OpsWorks Stacks fertig ist, werden die folgenden Ergebnisse angezeigt.

     
![\[Node.js App Server instance details showing one stopped server in us-west-2a.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-example-instance-stopped-console.png)

   

1. Wählen Sie bei **Actions (Aktionen)** die Option **delete (löschen)** aus. Wählen Sie im Bestätigungsdialogfeld **Delete (Löschen)** aus. Die Instance wird gelöscht und die Meldung **No instances (Keine Instances)** wird angezeigt.

**So löschen Sie den Stack**

1. Wählen Sie im Service-Navigationsbereich **Stack** aus. Die Seite **My Sample Stack (Linux) (Mein Beispiel-Stack (Linux))** wird angezeigt.

1. Wählen Sie **Delete Stack**. Wählen Sie im Bestätigungsdialogfeld **Delete (Löschen)** aus. Der Stapel wird gelöscht und die **OpsWorksDashboard-Seite** wird angezeigt.

Optional können Sie das Benutzer- und EC2 Amazon-Schlüsselpaar, das Sie für diese exemplarische Vorgehensweise verwendet haben, löschen, wenn Sie es nicht für den Zugriff auf andere AWS Services und EC2 Instances wiederverwenden möchten. Anweisungen finden Sie unter [Löschen eines IAM-Benutzers](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_deleting) und [ EC2 Amazon-Schlüsselpaare und Linux-Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#delete-key-pair).

Sie haben diese Anleitung nun abgeschlossen. Weitere Informationen finden Sie unter [Nächste Schritte](gettingstarted-intro-next-steps.md).

# Nächste Schritte
<a name="gettingstarted-intro-next-steps"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Nachdem Sie diese exemplarische Vorgehensweise abgeschlossen haben, können Sie mehr über die Verwendung von Stacks erfahren: OpsWorks 
+ Üben Sie, diesen Stapel mithilfe von Stacks manuell neu zu erstellen. OpsWorks Siehe [Erste Schritte: Linux](gettingstarted-linux.md).
+ Erkunden Sie das Kochbuch und die App, die OpsWorks Stacks für diese Komplettlösung verwendet hat. Weitere Informationen erhalten Sie auch unter [Weiterführende Informationen: Arbeiten mit dem Rezeptbuch, das in dieser Anleitung verwendet wird](gettingstarted-linux-explore-cookbook.md) und [Weiterführende Informationen: Arbeiten mit der Anwendung, die in dieser Anleitung verwendet wird](gettingstarted-linux-explore-app-source.md) in der begleitenden Anleitung [Erste Schritte: Linux](gettingstarted-linux.md).
+ Üben Sie die Verwendung von OpsWorks Stacks mit Windows-Instanzen. Siehe [Erste Schritte: Windows](gettingstarted-windows.md).
+ Weitere Informationen zu Stacks finden Sie auch unter [Erstellen eines neuen Stacks](workingstacks-creating.md).
+ Weitere Informationen zu Layern finden Sie unter [Bearbeiten der Konfiguration einer Ebene OpsWorks](workinglayers-basics-edit.md).
+ Weitere Informationen zu Instances finden Sie unter [Hinzufügen einer Instance zu einem Layer](workinginstances-add.md).
+ Weitere Informationen zu Apps finden Sie unter [Bereitstellen von Anwendungen](workingapps-deploying.md).
+ Weitere Informationen zu [Cookbooks und Rezepte](workingcookbook.md).
+ Erstellen Sie Ihre eigenen Rezeptbücher. Siehe [Erste Schritte: Rezeptbücher](gettingstarted-cookbooks.md).
+ Weitere Informationen zur Zugriffssteuerung für Stacks finden Sie unter [Sicherheit und Berechtigungen](workingsecurity.md).

# Erste Schritte mit Linux-Stacks
<a name="gettingstarted-linux"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

In dieser exemplarischen Vorgehensweise erfahren Sie, wie Sie OpsWorks Stacks verwenden, um eine Node.js Anwendungsumgebung zu erstellen. Wenn Sie fertig sind, verfügen Sie über eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance, auf der Chef 12 ausgeführt wird, einen Node.js HTTP-Server und eine Web-App, mit der Sie mit Twitter interagieren und Kommentare auf einer Webseite hinterlassen können.

Chef ist ein Drittanbieter-Framework für die Konfiguration und Wartung von Servern wie EC2 Instances und für die Bereitstellung und Wartung von Apps auf diesen Servern. Wenn Sie mit Chef nicht vertraut sind, empfehlen wir Ihnen, nach Abschluss dieser exemplarischen Vorgehensweise mehr über Chef zu erfahren, damit Sie alle Vorteile von OpsWorks Stacks voll ausschöpfen können. (Weitere Informationen finden Sie auf der Website [Learn Chef](https://learn.chef.io/).)

OpsWorks Stacks unterstützt vier Linux-Distributionen: Amazon Linux, Ubuntu Server, CentOS und Red Hat Enterprise Linux. Für diese exemplarische Vorgehensweise verwenden wir Ubuntu Server. OpsWorks Stacks funktioniert auch mit Windows Server. Wir haben zwar eine entsprechende exemplarische Vorgehensweise für Windows Server-Stacks, wir empfehlen jedoch, dass Sie zuerst diese exemplarische Vorgehensweise durchführen, um grundlegende Konzepte zu OpsWorks Stacks und Chef zu erlernen, die dort nicht wiederholt werden. Nachdem Sie diese Anleitung durchgearbeitet haben, rufen Sie die Anleitung [Erste Schritte: Windows](gettingstarted-windows.md) auf.



**Topics**
+ [Schritt 1: Erfüllen der Voraussetzungen](gettingstarted-linux-prerequisites.md)
+ [Schritt 2: Erstellen eines Stacks](gettingstarted-linux-create-stack.md)
+ [Schritt 3: Hinzufügen eines Layers zum Stack](gettingstarted-linux-add-layer.md)
+ [Schritt 4: Angeben der Anwendung zum Bereitstellen der Instance](gettingstarted-linux-specify-app.md)
+ [Schritt 5: Starten einer Instance](gettingstarted-linux-launch-instance.md)
+ [Schritt 6: Bereitstellen der Anwendung für die Instance](gettingstarted-linux-deploy-app.md)
+ [Schritt 7: Testen der bereitgestellten Anwendung auf der Instance](gettingstarted-linux-test-app.md)
+ [Schritt 8 (Optional): Bereinigen](gettingstarted-linux-clean-up.md)
+ [Nächste Schritte](gettingstarted-linux-next-steps.md)
+ [Weiterführende Informationen: Arbeiten mit dem Rezeptbuch, das in dieser Anleitung verwendet wird](gettingstarted-linux-explore-cookbook.md)
+ [Weiterführende Informationen: Arbeiten mit der Anwendung, die in dieser Anleitung verwendet wird](gettingstarted-linux-explore-app-source.md)

# Schritt 1: Erfüllen der Voraussetzungen
<a name="gettingstarted-linux-prerequisites"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Um mit der Anleitung beginnen zu können, müssen Sie die folgenden Einrichtungsschritte ausführen. Zu diesen Einrichtungsschritten gehören die Registrierung für ein AWS Konto, die Erstellung eines Administratorbenutzers und die Zuweisung von Zugriffsberechtigungen für Stacks. OpsWorks 

Wenn Sie bereits die Anleitung [Erste Schritte: Beispiel](https://docs.aws.amazon.com/opsworks/latest/userguide/gettingstarted-intro.html) durchgearbeitet haben, erfüllen Sie bereits die Voraussetzungen für diese Anleitung und können direkt mit [Schritt 2: Erstellen eines Stacks](gettingstarted-linux-create-stack.md) fortfahren.

**Topics**
+ [Registriere dich für ein AWS-Konto](#sign-up-for-aws)
+ [Erstellen eines Benutzers mit Administratorzugriff](#create-an-admin)
+ [Weisen Sie Dienstzugriffsberechtigungen zu](#gettingstarted-linux-prerequisites-permissions)

## Registriere dich für ein AWS-Konto
<a name="sign-up-for-aws"></a>

Wenn Sie noch keine haben AWS-Konto, führen Sie die folgenden Schritte aus, um eine zu erstellen.

**Um sich für eine anzumelden AWS-Konto**

1. Öffnen Sie [https://portal.aws.amazon.com/billing/die Anmeldung.](https://portal.aws.amazon.com/billing/signup)

1. Folgen Sie den Online-Anweisungen.

   Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben.

   Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Benutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

AWS sendet Ihnen nach Abschluss des Anmeldevorgangs eine Bestätigungs-E-Mail. Du kannst jederzeit deine aktuellen Kontoaktivitäten einsehen und dein Konto verwalten, indem du zu [https://aws.amazon.com/](https://aws.amazon.com/)gehst und **Mein Konto** auswählst.

## Erstellen eines Benutzers mit Administratorzugriff
<a name="create-an-admin"></a>

Nachdem Sie sich für einen angemeldet haben AWS-Konto, sichern Sie Ihren Root-Benutzer des AWS-Kontos AWS IAM Identity Center, aktivieren und erstellen Sie einen Administratorbenutzer, sodass Sie den Root-Benutzer nicht für alltägliche Aufgaben verwenden.

**Sichern Sie Ihre Root-Benutzer des AWS-Kontos**

1.  Melden Sie sich [AWS-Managementkonsole](https://console.aws.amazon.com/)als Kontoinhaber an, indem Sie **Root-Benutzer** auswählen und Ihre AWS-Konto E-Mail-Adresse eingeben. Geben Sie auf der nächsten Seite Ihr Passwort ein.

   Hilfe bei der Anmeldung mit dem Root-Benutzer finden Sie unter [Anmelden als Root-Benutzer](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) im *AWS-Anmeldung -Benutzerhandbuch* zu.

1. Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA) für den Root-Benutzer.

   Anweisungen finden Sie unter [Aktivieren eines virtuellen MFA-Geräts für Ihren AWS-Konto Root-Benutzer (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) im *IAM-Benutzerhandbuch*.

**Erstellen eines Benutzers mit Administratorzugriff**

1. Aktivieren Sie das IAM Identity Center.

   Anweisungen finden Sie unter [Aktivieren AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-set-up-for-idc.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Gewähren Sie einem Administratorbenutzer im IAM Identity Center Benutzerzugriff.

   *Ein Tutorial zur Verwendung von IAM-Identity-Center-Verzeichnis als Identitätsquelle finden Sie IAM-Identity-Center-Verzeichnis im Benutzerhandbuch unter [Benutzerzugriff mit der Standardeinstellung konfigurieren](https://docs.aws.amazon.com/singlesignon/latest/userguide/quick-start-default-idc.html).AWS IAM Identity Center *

**Anmelden als Administratorbenutzer**
+ Um sich mit Ihrem IAM-Identity-Center-Benutzer anzumelden, verwenden Sie die Anmelde-URL, die an Ihre E-Mail-Adresse gesendet wurde, als Sie den IAM-Identity-Center-Benutzer erstellt haben.

  Hilfe bei der Anmeldung mit einem IAM Identity Center-Benutzer finden Sie [im *AWS-Anmeldung Benutzerhandbuch* unter Anmeldung beim AWS Access-Portal](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html).

**Weiteren Benutzern Zugriff zuweisen**

1. Erstellen Sie im IAM-Identity-Center einen Berechtigungssatz, der den bewährten Vorgehensweisen für die Anwendung von geringsten Berechtigungen folgt.

   Anweisungen hierzu finden Sie unter [ Berechtigungssatz erstellen](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-started-create-a-permission-set.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Weisen Sie Benutzer einer Gruppe zu und weisen Sie der Gruppe dann Single Sign-On-Zugriff zu.

   Eine genaue Anleitung finden Sie unter [ Gruppen hinzufügen](https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

## Weisen Sie Dienstzugriffsberechtigungen zu
<a name="gettingstarted-linux-prerequisites-permissions"></a>

Ermöglichen Sie den Zugriff auf den OpsWorks Stacks-Dienst (und die zugehörigen Dienste, auf die OpsWorks Stacks angewiesen ist), indem Sie Ihrer Rolle oder Ihrem `AmazonS3FullAccess` Benutzer die Berechtigungen `AWSOpsWorks_FullAccess` und hinzufügen.

Weitere Informationen zum Hinzufügen von Berechtigungen finden Sie unter [Hinzufügen von IAM-Identitätsberechtigungen (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policies-console).

Nun haben Sie alle Einrichtungsschritte abgeschlossen und können [mit dieser Anleitung beginnen](gettingstarted-linux-create-stack.md).

# Schritt 2: Erstellen eines Stacks
<a name="gettingstarted-linux-create-stack"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Sie werden die OpsWorks Stacks-Konsole verwenden, um einen Stack zu erstellen. Ein *Stack* ist eine Sammlung von Instanzen und zugehörigen AWS Ressourcen, die einem gemeinsamen Zweck dienen und die Sie gemeinsam verwalten möchten. (Weitere Informationen finden Sie unter [Stacks](workingstacks.md).) Für diese Anleitung gibt es nur eine Instance.

Erfüllen Sie, bevor Sie beginnen, die [Voraussetzungen](gettingstarted-linux-prerequisites.md), falls noch nicht geschehen.

**So erstellen Sie den Stack**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die OpsWorks Konsole unter [https://console.aws.amazon.com/opsworks/](https://console.aws.amazon.com/opsworks/).

1. Führen Sie von den folgenden Schritten die zutreffenden aus:
   + Wenn die Seite **Willkommen bei OpsWorks Stacks** angezeigt wird, wählen Sie **Add your first stack** oder **Add your OpsWorks first Stacks stack** (beide Optionen bewirken dasselbe). Die Seite **Add stack (Stack hinzufügen)** wird angezeigt.
   + Wenn die **OpsWorks Dashboard-Seite** angezeigt wird, wählen Sie Stapel **hinzufügen**. Die Seite **Add stack (Stack hinzufügen)** wird angezeigt.

1. Wählen Sie bei geöffneter Seite **Add stack (Stack hinzufügen)** die Option **Chef 12 stack (Chef 12-Stack)** aus, falls sie nicht bereits für Sie ausgewählt ist.

1. Geben Sie in das Feld **Stack name (Stack-Name)** einen Namen ein, z. B. **MyLinuxDemoStack**. (Sie können auch einen anderen Namen eingeben. Stellen Sie jedoch sicher, diesen anstelle von `MyLinuxDemoStack` zu nutzen.)

1. Wählen Sie für **Region** die Option **US West (Oregon)** aus.

1. Führen Sie für **VPC** einen der folgenden Schritte aus:
   + Wählen Sie eine VPC aus, falls verfügbar. (Weitere Informationen finden Sie unter [Ausführen eines Stacks in einer VPC](workingstacks-vpc.md).)
   + Wählen Sie andernfalls **No VPC (Keine VPC)** aus.

1. Wählen Sie für **Default operating system (Standardbetriebssystem)** die Optionen **Linux** und **Ubuntu 18.04 LTS** aus.

1. Bestätigen Sie die Option **Use custom Chef cookbooks (Benutzerdefinierte Chef-Rezeptbücher verwenden)** mit **Yes**.

1. Wählen Sie für **Repository type (Repository-Typ)** die Option **Http Archive (HTTP-Archiv)** aus.

1. Geben Sie als **Repository URL (Repository-URL)** die URL **https://s3.amazonaws.com/opsworks-demo-assets/opsworks-linux-demo-cookbooks-nodejs.tar.gz**

1. Übernehmen Sie die Standardeinstellungen für die folgenden Schritte:
   + **Default Availability Zone** (**us-west-2a**)
   + **Default SSH key** (**Do not use a default SSH key**)
   + **User name (Benutzername)** (leer)
   + **Password (Passwort)** (leer)
   + **Stack color** (dark blue)

1. Wählen Sie **Erweitert** aus.

1. Führen Sie für die **IAM-Rolle** einen der folgenden Schritte aus (weitere Informationen finden Sie unter[OpsWorks Stacks erlauben, in Ihrem Namen zu handeln](opsworks-security-servicerole.md)):
   + Wählen Sie **aws-opsworks-service-role** aus, sofern verfügbar.
   + Falls **aws-opsworks-service-role**nicht verfügbar, wählen Sie **Neue IAM-Rolle** aus.

1. Führen Sie für das **Standard-IAM-Instanzprofil** einen der folgenden Schritte aus (weitere Informationen finden Sie unter[Angeben von Berechtigungen für Apps, die auf Instanzen ausgeführt werden EC2](opsworks-security-appsrole.md)):
   + Wenn **aws-opsworks-ec2 Rollen** verfügbar sind, wählen Sie sie aus.
   + Wenn **aws-opsworks-ec2 Rollen** nicht verfügbar sind, wählen Sie **Neues IAM-Instanzprofil** aus.

1. Wählen Sie für **API endpoint region (API-Endpunktregion)** den regionalen API-Endpunkt aus, mit dem der Stack verknüpft sein soll. Wenn sich der Stack in der Region USA West (Oregon) innerhalb des regionalen Endpunkts USA Ost (Nord-Virginia) befinden soll, wählen Sie **us-east-1**. Wenn der Stack sowohl in der Region USA West (Oregon) als auch mit dem regionalen Endpunkt USA West (Oregon) verknüpft sein soll, wählen Sie **us-west-2**.
**Anmerkung**  
Der regionale Endpunkt USA Ost (Nord-Virginia) enthält aus AWS-Regionen Gründen der Abwärtskompatibilität den älteren Endpunkt. Es hat sich jedoch bewährt, den regionalen Endpunkt zu wählen, der dem Standort, an dem Sie verwalten, am nächsten liegt. AWS Weitere Informationen finden Sie unter [Unterstützung von Regionen](gettingstarted_intro.md#gettingstarted-intro-region).

1. Übernehmen Sie die Standardeinstellungen für die folgenden Schritte:
   + **Default root device type** (**EBS backed**)
   + **Hostname theme** (**Layer Dependent**)
   + **OpsWorks Agentenversion** (neueste Version)
   + **Custom JSON (Benutzerdefinierte JSON-Datei)** (leer)
   + **Verwenden Sie OpsWorks Sicherheitsgruppen** (**Ja**)

1. Ihre Ergebnisse sollten mit den folgenden Screenshots übereinstimmen, mit Ausnahme von **VPC**, **IAM-Rolle** und **Standard-IAM-Instanzprofil**:

     
![\[AWS OpsWorks Stacks interface for creating a Chef 12 stack with configuration options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-add-stack-top-console.png)

     
![\[AWS OpsWorks stack configuration form with repository, IAM, and security options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-add-stack-bottom-console.png)

   

1. **Wählen Sie „Stack hinzufügen“.** OpsWorks Stacks erstellt den Stapel und zeigt die **MyLinuxDemoStack**Seite an.

Sie haben nun einen Stack mit den richtigen Einstellungen für diese Anleitung.

Im [nächsten Schritt](gettingstarted-linux-add-layer.md) fügen Sie dem Stack eine Ebene hinzu.

# Schritt 3: Hinzufügen eines Layers zum Stack
<a name="gettingstarted-linux-add-layer"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

 Eine *Ebene* ist eine Blaupause für eine Reihe von Instances, z. B. EC2 Amazon-Instances. Er legt Informationen fest, wie die Instance-Einstellungen, Ressourcen, installierte Pakete und Sicherheitsgruppen. Fügen Sie dem Stack als Nächstes einen Layer hinzu. (Weitere Informationen über Layer finden Sie unter [Layer](workinglayers.md).)

**So fügen Sie den Layer dem Stack hinzu**

1. Wenn die **MyLinuxDemoStack**Seite aus dem vorherigen Schritt angezeigt wird, wählen Sie für **Ebenen** die Option **Ebene hinzufügen** aus: 

     
![\[Layers section with icon and description, highlighting "Add a layer" option.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-add-layer-console.png)

   

1. Die Seite **Add Layer (Ebene hinzufügen)** wird angezeigt. Geben Sie auf der **OpsWorks**Registerkarte als **Name den** Text ein**MyLinuxDemoLayer**. (Sie können auch einen anderen Namen eingeben. Stellen Sie jedoch sicher, diesen anstelle von `MyLinuxDemoLayer` zu nutzen.)

1. Geben Sie für **Short name (Kurzname)** den Namen **demo** ein (Sie können einen anderen Wert eingeben, sollten aber sicherstellen, diesen in der gesamten Anleitung anstelle von `demo` zu nutzen):

     
![\[Form to add a layer with fields for name and short name, and options for OpsWorks, ECS, and RDS.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-add-layer-page-console.png)

   

1. Wählen Sie **Ebene hinzufügen aus**. OpsWorks Stacks erstellt die Ebene und zeigt die Seite „**Ebenen**“ an.

1. Wählen Sie auf der Seite „**Ebenen**“ für die **MyLinuxDemoLayer**Option **Netzwerk** aus.

1. Überprüfen Sie auf der Registerkarte **Network (Netzwerk)** unter **Automatically Assign IP Addresses (IP-Adressen automatisch zuweisen)**, ob **Public IP addresses (Öffentliche IP-Adressen)** auf **yes (Ja)** festgelegt ist. Wenn Sie Änderungen vorgenommen haben, wählen Sie **Save (Speichern)** aus.  
![\[Network settings showing Public IP addresses set to yes and Elastic IP addresses set to No.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/add_layer_publicip.png)

1. Wählen Sie auf der Seite **Layers (Ebenen)** die Option **Security (Sicherheit)** aus:

     
![\[AWS Layers interface showing MyLinuxDemoLayer with Security tab highlighted.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-layer-page-console.png)

   

1. Die MyLinuxDemoLayer Seite „**Layer**“ wird mit geöffneter Registerkarte „**Sicherheit**“ angezeigt. Wählen Sie für **Sicherheitsgruppen** **AWS- OpsWorks - WebApp** und dann **Save** aus:

     
![\[Security settings interface showing security group selection and EC2 instance profile options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-layer-security-console.png)

   

1. Die `AWS-OpsWorks-WebApp`-Sicherheitsgruppe wird dem Layer hinzugefügt. (Diese Sicherheitsgruppe ermöglicht es Benutzern, später in dieser exemplarischen Vorgehensweise eine Verbindung mit der App auf der Instance herzustellen. Ohne diese Sicherheitsgruppe erhalten Benutzer in ihrem Webbrowser eine Meldung, dass sie keine Verbindung mit der Instanz herstellen können.)

Sie haben nun einen Layer mit den richtigen Einstellungen für diese Anleitung.

Im [nächsten Schritt](gettingstarted-linux-specify-app.md) legen Sie die Anwendung fest, die für die Instance bereitgestellt werden soll. 

# Schritt 4: Angeben der Anwendung zum Bereitstellen der Instance
<a name="gettingstarted-linux-specify-app"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Informieren Sie OpsWorks Stacks später in dieser exemplarischen Vorgehensweise über die App, die Sie auf der Instanz bereitstellen werden. In diesem Kontext definiert OpsWorks Stacks eine *App* als Code, den Sie auf einer Instanz ausführen möchten. (Weitere Informationen finden Sie unter [Apps](workingapps.md).)

Das Verfahren in diesem Abschnitt gilt für Chef 12 und neuere Stacks. Weitere Informationen darüber, wie Anwendungen Ebenen in Chef 11-Stacks hinzugefügt werden, finden Sie unter [Schritt 2.4: Erstellen und Bereitstellen einer Anwendung – Chef 11](gettingstarted-simple-app.md).

**So legen Sie die Anwendung für die Bereitstellung fest**

1. Wählen Sie im Service-Navigationsbereich **Apps (Anwendungen)** aus:

     
![\[Navigation menu with options including Stack, Layers, Instances, and Apps highlighted.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-nav-pane-console.png)

   

1. Die Seite **Apps (Anwendungen)** wird angezeigt. Wählen Sie **Add an app (App hinzufügen)** aus. Die Seite **Add App (Anwendung hinzufügen)** wird angezeigt.

1. Geben Sie unter **Settings (Einstellungen)** für **Name** den Namen **MyLinuxDemoApp** ein. (Sie können auch einen anderen Namen eingeben. Stellen Sie jedoch sicher, diesen anstelle von `MyLinuxDemoApp` zu nutzen.)

1. Geben Sie bei **Application Source (Anwendungsquelle)**, für **Repository URL (Repository-URL)** die URL **https://github.com/awslabs/opsworks-windows-demo-nodejs.git** ein.

1. Übernehmen Sie die Standardeinstellungen für die folgenden Schritte:
   + **Settings (Einstellungen)**, **Document root (Basisverzeichnis)** (leer)
   + **Data Sources (Datenquelle)**, **Data source type (Datenquellentyp)** (**None (Kein)**)
   + **Repository type (Repository-Typ)** (**Git**)
   + **Repository SSH key (Repository-SSH-Schlüssel)** (leer)
   + **Branch/Revision (Zweig/Version)** (leer)
   + **Environment Variables (Umgebungsvariablen)** (leer **KEY (SCHLÜSSEL)**, leer **VALUE (WERT)**, deaktiviert **Protected Value (Geschützer Wert)**)
   + **Add Domains (Domänen hinzufügen)**, **Domain Name (Domänenname)** (leer)
   + **SSL Settings (SSL-Einstellungen)**, **Enable SSL (SSL aktivieren)** (**No (Nein)**)

     
![\[Add App form with settings for name, document root, data sources, and application source.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-add-app-top-console.png)

     
![\[Application configuration form with environment variables, domain settings, and SSL options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-add-app-bottom-console.png)

   

1. Wählen Sie **App hinzufügen**. OpsWorks Stacks fügt die App hinzu und zeigt die **Apps-Seite** an.

Sie haben nun eine Anwendung mit den richtigen Einstellungen für diese Anleitung.

Im [nächsten Schritt](gettingstarted-linux-launch-instance.md) starten Sie die Instance.

# Schritt 5: Starten einer Instance
<a name="gettingstarted-linux-launch-instance"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Verwenden Sie OpsWorks Stacks, um eine EC2 Ubuntu-Server-Amazon-Instance zu starten. Diese Instance verwendet die Einstellungen, die Sie in dem Layer festgelegt haben, den Sie zuvor in dieser Anleitung erstellt haben. (Weitere Informationen finden Sie unter [Instances](workinginstances.md).)

**So starten Sie die Instance**

1. Wählen Sie im Service-Navigationsbereich **Instances** aus. Die Seite **Instances** wird angezeigt.

1. Wählen Sie für **MyLinuxDemoLayer****Instance hinzufügen** aus.

1. Behalten Sie auf der Registerkarte **New (Neu)** die folgenden Standardeinstellungen bei:
   + **Hostname (Hostname)** (**demo1 (demo1)**)
   + **Size** (**c3.large**)
   + **Subnetz** (*IP address***us-west-2a**)

1. Wählen Sie **Erweitert** aus.

1. Übernehmen Sie die Standardeinstellungen für die folgenden Schritte:
   + **Scaling type** (**24/7**)
   + **SSH key** (**Do not use a default SSH key**)
   + **Operating system** (**Ubuntu 18.04 LTS**)
   + **OpsWorks Agentenversion (vom Stapel** **erben**)
   + **Tenancy** (**Default - Rely on VPC settings**)
   + **Root device type** (**EBS backed**)
   + **Volume type** (**General Purpose (SSD)**)
   + **Volume size** (**8**)

1. Ihre Ergebnisse sollten ähnlich wie im folgenden Screenshot aussehen:

     
![\[Form for configuring a new EC2 instance with options for hostname, size, subnet, and other settings.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-add-instance-console.png)

   

1. Wählen Sie „**Instanz hinzufügen**“. OpsWorks Stacks fügt die Instanz dem Layer hinzu und zeigt die Seite „**Instanzen**“ an.

1. **Wählen Sie für **MyLinuxDemoLayer**, für **demo1**, für **Actions**, Start:**

     
![\[Instance management interface showing a stopped demo1 instance with start and delete options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-start-instance-console.png)

   

1. Nach mehreren Minuten geschieht Folgendes:
   + Der Kreis **setting up (Wird eingerichtet)** ändert sich von **0** auf **1**. 
   + **Status** wechselt von **stopped (Angehalten)** zu **requested (Angefragt)** zu **pending (Ausstehend)** zu **booting (Wird gebootet)** zu **running\$1setup (Einrichtung wird ausgeführt)** und schließlich zu **online**. Beachten Sie, dass dieser Vorgang einige Minuten dauern kann.
   + Nachdem sich der **Status** in **online** geändert hat, ändert sich die Kreisanzeige **setting up (Wird eingerichtet)** von **1** in **0** und der **online**-Kreis von **0** in **1** und wechselt zu hellgrün. Fahren Sie nicht fort, bevor der **online (Online)**-Kreis hellgrün angezeigt wird und **1** Instance online anzeigt. 

1. Bevor Sie fortfahren, muss Ihr Ergebnis wie auf der Abbildung dargestellt aussehen. Falls eine Fehlermeldung angezeigt wird, lesen Sie unter [Handbuch zur Fehlersuche und Fehlerbehebung](troubleshoot.md) weiter:

     
![\[EC2 instance details showing one online c3.large instance in us-west-2a with stop and ssh options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-instance-started-console.png)

   

Jetzt haben Sie eine Instance, die bereit ist, für die Anwendung bereitgestellt zu werden. 

**Anmerkung**  
Wenn Sie sich bei der Instance anmelden möchten, um sie weiter zu erkunden, müssen Sie OpsWorks Stacks zunächst Informationen über Ihren öffentlichen SSH-Schlüssel zur Verfügung stellen (den Sie mit Tools wie ssh-keygen oder Pu erstellen könnenTTYgen). Anschließend müssen Sie Berechtigungen für den `MyLinuxDemoStack` Stack festlegen, damit sich Ihr Benutzer bei der Instance anmelden kann. Anweisungen finden Sie unter [Registrierung des öffentlichen SSH-Schlüssels eines Benutzers](security-settingsshkey.md) und [Anmelden mit SSH](workinginstances-ssh.md). Wenn Sie SSH verwenden möchten, um über PuTTY eine Verbindung zu Instanzen herzustellen, finden Sie in der Dokumentation Informationen [unter Herstellen einer Verbindung zu Ihrer Linux-Instance von Windows aus](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html). AWS 

Im [nächsten Schritt](gettingstarted-linux-deploy-app.md) stellen Sie die Anwendung für die Instance bereit.

# Schritt 6: Bereitstellen der Anwendung für die Instance
<a name="gettingstarted-linux-deploy-app"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

In diesem Schritt werden Sie die App von der laufenden Instanz aus GitHub bereitstellen. (Weitere Informationen finden Sie unter [Bereitstellen von Anwendungen](workingapps-deploying.md).) Bevor Sie die Anwendung bereitstellen, müssen Sie das zu verwendende *Rezept* zur Koordinierung der Bereitstellung auswählen. Ein Rezept ist ein Chef-Konzept. Rezepte sind Anweisungen, geschrieben in Ruby-Sprachsyntax, die die Ressourcen für die Nutzung auswählen und die Reihenfolge bestimmen, in der diese Ressourcen angewendet werden. (Weitere Informationen finden Sie unter [About Recipes](https://docs.chef.io/recipes.html) auf der Website [Learn Chef](https://learn.chef.io/).) 

**So legen Sie das Rezept für die Bereitstellung der Anwendung für die Instance fest**

1. Wählen Sie im Service-Navigationsbereich **Layers** aus. Die Seite **Layers** wird angezeigt.

1. Wählen Sie für **MyLinuxDemoLayer**„**Rezepte**“:

     
![\[Layer interface showing MyLinuxDemoLayer with tabs for Settings, Recipes, Network, EBS Volumes, and Security.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-layers-page-console.png)

   

   Die ** MyLinuxDemoLayerLayer-Seite** wird mit geöffnetem Tab „**Rezepte**“ angezeigt.

1. Geben Sie bei **Custom Chef Recipes (Benutzerdefinierte Chef-Rezepte)** für **Deploy (Bereitstellen)** die Zeichenfolge **nodejs\$1demo::default** ein und drücken Sie dann die **Eingabetaste**. `nodejs_demo` ist der Name des Rezeptbuches und `default` ist der Name des Zielrezepts innerhalb des Rezeptbuches. (Wenn Sie sich einen Überblick über die Rezept-Codes verschaffen möchten, lesen Sie [Weiterführende Informationen: Arbeiten mit dem Rezeptbuch, das in dieser Anleitung verwendet wird](gettingstarted-linux-explore-cookbook.md).) Ihre Ergebnisse müssen wie auf dem folgenden Screenshot abgebildet aussehen:

     
![\[Custom Chef Recipes configuration panel with Repository URL and lifecycle stages for a Linux demo layer.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-recipes-page-console.png)

   

1. Wählen Sie „**Speichern**“. OpsWorks Stacks fügt das Rezept zum Deploy-Lifecycle-Ereignis des Layers hinzu.

**So stellen Sie die Anwendung für die Instance bereit**

1. Wählen Sie im Service-Navigationsbereich **Apps (Anwendungen)** aus. Die Seite **Apps (Anwendungen)** wird angezeigt. 

1. Wählen Sie für **Aktionen** die Option **Deploy** aus, wie im folgenden Screenshot dargestellt: **MyLinuxDemoApp**

     
![\[Apps table showing MyLinuxDemoApp with deploy, edit, and delete options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-apps-page-console.png)

   

1. Behalten Sie auf der Seite **Deploy App (Anwendung bereitstellen)** die folgenden Standardeinstellungen bei:
   + **Command (Befehl)** (**Deploy (Bereitstellen)**)
   + **Comment (Kommentar)** (leer)
   + **Settings (Einstellungen)**, **Advanced (Erweitert)**, **Custom Chef JSON (Benutzerdefinierte JSON-Chef-Datei)** (leer)
   + **Instanzen**, **Erweitert** (aktiviert **Alle auswählen**, aktiviert **MyLinuxDemoLayer**, **demo1** aktiviert)

1. Ihre Ergebnisse müssen wie auf dem folgenden Screenshot abgebildet aussehen:

     
![\[Deploy App interface with settings for MyLinuxDemoApp, including command and instance selection.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-deploy-app-console.png)

   

1. Wählen Sie **Bereitstellen**. Die Seite **Bereitstellung MyLinuxDemoApp — Bereitstellung** wird angezeigt. **Status** ändert sich von **running (Wird ausgeführt)** in **successful (Erfolgreich)**. Ein rotierender Kreis wird neben **demo1 (demo1)** angezeigt, der dann zu einem grünen Häkchen wird. Beachten Sie, dass dieser Vorgang einige Minuten dauern kann. Fahren Sie nicht fort, bis **Status (Status)** den Wert **successful (Erfolgreich)** hat und das grüne Häkchen-Symbol zu sehen ist.

1. Die Ergebnisse müssen mit dem folgenden Screenshot übereinstimmen, außer natürlich für **Created at (Erstellt um)**, **Completed at (Abgeschlossen um)**, **Duration (Dauer)** und **User (Benutzer)**. Wenn **status (Status)** auf **failed (Fehler)** gesetzt ist, wählen Sie zur Fehlerbehebung für **Log (Protokoll)** die Option **show (Anzeigen)** aus, um Fehlerdetails zu erhalten:

     
![\[Deployment details for MyLinuxDemoApp showing successful status and duration of 1 minute 13 seconds.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-app-deployed-console.png)

   

Sie haben die Anwendung nun erfolgreich auf der Instance bereitgestellt.

Im [nächsten Schritt](gettingstarted-linux-test-app.md) werden Sie die bereitgestellte Anwendung auf der Instance testen.

# Schritt 7: Testen der bereitgestellten Anwendung auf der Instance
<a name="gettingstarted-linux-test-app"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Jetzt testen Sie die Anwendungsbereitstellung auf der Instance.

**So testen Sie die Bereitstellung auf der Instance**

1. Wählen Sie im Service-Navigationsbereich **Instances** aus. Die Seite **Instances** wird angezeigt.

1. Wählen Sie für **MyLinuxDemoLayer**, für **demo1**, für **Public IP**, die IP-Adresse aus:

     
![\[EC2 instance details showing one online c3.large instance in us-west-2a with stop and ssh options.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-instance-ip-console.png)

   

   Eine neue Registerkarte des Webbrowsers zeigt die Anwendung an.

1. Geben Sie auf der Glückwunsch-Webseite im Textfeld **Leave a comment (Kommentar eingeben)** einen Kommentar ein und wählen Sie **Send (Senden)** aus, um die Anwendung zu testen. Die Anwendung fügt den Kommentar zur Webseite hinzu. Sie können beliebig oft Kommentare hinterlassen und **Send (Senden)** auswählen:

     
![\[Congratulatory message for deploying first app with AWS OpsWorks, featuring stylized tree and buildings.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-test-app.png)

   

1. Wenn du ein Twitter-Konto hast, wähle **Tweet** oder **Follow @ AWSOps Works** und folge den Anweisungen auf dem Bildschirm, um über die App zu twittern oder @ AWSOps Works zu folgen.

Sie haben jetzt die bereitgestellte Anwendung erfolgreich auf der Instance getestet.

Im [nächsten Schritt](gettingstarted-linux-clean-up.md) können Sie die AWS Ressourcen bereinigen, die Sie für diese exemplarische Vorgehensweise verwendet haben. Dieser nächste Schritt ist optional. Möglicherweise möchten Sie diese AWS Ressourcen weiterhin verwenden, wenn Sie mehr über OpsWorks Stacks erfahren. Wenn Sie diese AWS Ressourcen behalten, kann dies jedoch zu laufenden Gebühren für Ihr AWS Konto führen. Wenn Sie diese AWS Ressourcen für eine spätere Verwendung behalten möchten, haben Sie diese exemplarische Vorgehensweise nun abgeschlossen, und Sie können [Nächste Schritte](gettingstarted-linux-next-steps.md) weitermachen.

# Schritt 8 (Optional): Bereinigen
<a name="gettingstarted-linux-clean-up"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Um zu verhindern, dass zusätzliche Gebühren für Ihr AWS Konto anfallen, können Sie die AWS Ressourcen löschen, die für diese Komplettlösung verwendet wurden. Zu diesen AWS Ressourcen gehören der OpsWorks Stacks-Stack und die Komponenten des Stacks. (Weitere Informationen finden Sie unter [OpsWorks Preisgestaltung](https://aws.amazon.com/opsworks/pricing/).) Möglicherweise möchten Sie diese AWS Ressourcen jedoch weiterhin nutzen, um mehr über OpsWorks Stacks zu erfahren. Wenn Sie diese AWS Ressourcen weiterhin verfügbar halten möchten, haben Sie diese exemplarische Vorgehensweise nun abgeschlossen, und Sie können weitermachen. [Nächste Schritte](gettingstarted-linux-next-steps.md)

Inhalte, die in den Ressourcen gespeichert sind, die Sie für diese schrittweise Anleitung erstellt haben, können persönlich identifizierende Informationen enthalten. Wenn Sie nicht mehr möchten, dass diese Informationen von AWS gespeichert werden, führen Sie die in diesem Thema beschriebenen Schritte aus.

**So löschen Sie die Anwendung aus dem Stack**

1. **Wählen Sie in der OpsWorks Stacks-Konsole im Servicenavigationsbereich Apps aus.** Die Seite **Apps (Anwendungen)** wird angezeigt.

1. Wählen Sie für **Aktionen** die Option **Löschen** aus. **MyLinuxDemoApp** Wenn die Bestätigungsmeldung angezeigt wird, wählen Sie **Löschen**. OpsWorks Stacks löscht die App.

**So löschen Sie die Instance für den Stack**

1. Wählen Sie im Service-Navigationsbereich **Instances** aus. Die Seite **Instances** wird angezeigt.

1. **Wählen Sie für **MyLinuxDemoLayer**, für **demo1**, für **Actions, Stopp**.** Wählen Sie im Bestätigungsdialogfeld **Stop** aus. Es geschieht Folgendes.
   + Der **Status** ändert sich von **online** zu **stopping (Wird angehalten)** und schließlich zu **stopped (Angehalten)**.
   + **online** ändert sich von **1** zu **0**.
   + **shutting down (Wird heruntergefahren)** ändert sich von **0** zu **1** und schließlich wieder zu **0**.
   + **stopped** ändert sich schließlich von **0** zu **1**.

   Dieser Vorgang kann einige Minuten dauern. Wenn OpsWorks Stacks fertig ist, werden die folgenden Ergebnisse angezeigt.

     
![\[Instances dashboard showing one stopped Linux instance in the us-west-2a availability zone.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/gs-linux-instance-stopped-console.png)

   

1. Wählen Sie bei **Actions (Aktionen)** die Option **delete (löschen)** aus. Wenn Sie die Bestätigungsmeldung sehen, wählen Sie **Löschen**. OpsWorks Stacks löscht die Instanz und zeigt die Meldung **Keine Instanzen** an.

**So löschen Sie den Stack**

1. Wählen Sie im Service-Navigationsbereich **Stack** aus. Die Seite **MyLinuxDemoStack** wird angezeigt.

1. Wählen Sie **Delete Stack**. **Wenn Sie die Bestätigungsmeldung sehen, wählen Sie Löschen.** OpsWorks Stacks löscht den Stapel und zeigt die **OpsWorks Dashboard-Seite** an.

Optional können Sie das Benutzer- und EC2 Amazon-Schlüsselpaar, das Sie für diese exemplarische Vorgehensweise verwendet haben, löschen, wenn Sie es nicht für den Zugriff auf andere AWS Services und EC2 Instances wiederverwenden möchten. Anweisungen finden Sie unter [Löschen eines IAM-Benutzers](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_deleting) und [ EC2 Amazon-Schlüsselpaare und Linux-Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#delete-key-pair).

Sie haben diese Anleitung nun abgeschlossen. Weitere Informationen finden Sie unter [Nächste Schritte](gettingstarted-linux-next-steps.md).

# Nächste Schritte
<a name="gettingstarted-linux-next-steps"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Nachdem Sie diese exemplarische Vorgehensweise abgeschlossen haben, können Sie mehr über die Verwendung von Stacks erfahren: OpsWorks 
+ Erfahren Sie mehr über das Rezeptbuch und die Anwendung, die Sie in dieser Anleitung verwendet haben. Siehe [Weiterführende Informationen: Arbeiten mit dem Rezeptbuch, das in dieser Anleitung verwendet wird](gettingstarted-linux-explore-cookbook.md) und [Weiterführende Informationen: Arbeiten mit der Anwendung, die in dieser Anleitung verwendet wird](gettingstarted-linux-explore-app-source.md).
+ Üben Sie die Verwendung von OpsWorks Stacks mit Windows-Instanzen. Siehe [Erste Schritte: Windows](gettingstarted-windows.md).
+ Weitere Informationen zu Stacks finden Sie auch unter [Erstellen eines neuen Stacks](workingstacks-creating.md).
+ Weitere Informationen zu Layern finden Sie unter [Bearbeiten der Konfiguration einer Ebene OpsWorks](workinglayers-basics-edit.md).
+ Weitere Informationen zu Instances finden Sie unter [Hinzufügen einer Instance zu einem Layer](workinginstances-add.md).
+ Weitere Informationen zu Apps finden Sie unter [Bereitstellen von Anwendungen](workingapps-deploying.md).
+ Weitere Informationen zu [Cookbooks und Rezepte](workingcookbook.md).
+ Erstellen Sie Ihre eigenen Rezeptbücher. Siehe [Erste Schritte: Rezeptbücher](gettingstarted-cookbooks.md).
+ Weitere Informationen zur Zugriffssteuerung für Stacks finden Sie unter [Sicherheit und Berechtigungen](workingsecurity.md).

# Weiterführende Informationen: Arbeiten mit dem Rezeptbuch, das in dieser Anleitung verwendet wird
<a name="gettingstarted-linux-explore-cookbook"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

In diesem Thema wird das Kochbuch beschrieben, das OpsWorks Stacks für die Komplettlösung verwendet hat.

Ein *Rezeptbuch* ist ein Chef-Konzept. Rezeptbücher sind Archivdateien mit Konfigurationsinformationen, z. B. Rezepten, Attributwerten, Dateien, Vorlagen, Bibliotheken, Definitionen und benutzerdefinierten Ressourcen. Ein *Rezept* ist auch ein Chef-Konzept. Rezepte sind Anweisungen, geschrieben in Ruby-Sprachsyntax, die die Ressourcen für die Nutzung auswählen und die Reihenfolge bestimmen, in der diese Ressourcen angewendet werden. Weitere Informationen finden Sie unter [About Cookbooks](https://docs.chef.io/cookbooks.html) und [About Recipes](https://docs.chef.io/recipes.html) auf der Website [Learn Chef](https://learn.chef.io/).

Um den Inhalt des in dieser exemplarischen Vorgehensweise verwendeten Kochbuches zu sehen, extrahieren Sie den Inhalt der Datei [opsworks-linux-demo-cookbooks-nodejs.tar.gz](https://s3.amazonaws.com/opsworks-demo-assets/opsworks-linux-demo-cookbooks-nodejs.tar.gz) in ein leeres Verzeichnis auf Ihrer lokalen Workstation. (Sie können sich auch in der Instance anmelden, auf der Sie das Rezeptbuch bereitgestellt haben, und sich mit den Inhalten des Verzeichnisses `/var/chef/cookbooks` vertraut machen.)

Das Rezeptbuch führt den Code in der Datei `default.rb` im Verzeichnis `cookbooks/nodejs_demo/recipes` aus: 

```
app = search(:aws_opsworks_app).first
app_path = "/srv/#{app['shortname']}"

package "git" do
  options "--force-yes" if node["platform"] == "ubuntu" && node["platform_version"] == "18.04"
end

application app_path do
  javascript "4"
  environment.update("PORT" => "80")

  git app_path do
    repository app["app_source"]["url"]
    revision app["app_source"]["revision"]
  end

  link "#{app_path}/server.js" do
    to "#{app_path}/index.js"
  end

  npm_install
  npm_start
end
```

Die Datei geht folgendermaßen vor:
+ `search(:aws_opsworks_app).first` verwendet die Chef-Suche, um Informationen über die Anweisung zu suchen, die letztendlich für die Instance bereitgestellt wird. Diese Information umfasst Einstellungen wie die Kurzbezeichnung der Anwendung und die Details ihres Quell-Repositorys. Da nur eine Anwendung in dieser Anleitung bereitgestellt wurde, bekommt die Chef-Suche diese Einstellungen von dem ersten Informationselement innerhalb des `aws_opsworks_app`-Suchindex auf der Instance. Immer wenn eine Instance gestartet wird, speichert OpsWorks Stacks diese und andere zugehörige Informationen als Satz von Datenbeuteln auf der Instance selbst, und Sie erhalten den Inhalt der Datentasche über die Chef-Suche. Obwohl Sie diese Einstellungen in dieses Rezept fest programmieren können, ist die Nutzung von Data Bags und der Chef-Suche ein solideres Konzept. Weitere Informationen zu Data Bags finden Sie unter [OpsWorks Referenz für Stacks Data Bag](data-bags.md). Sie können sich auch unter [About Data Bags](https://docs.chef.io/data_bags.html) auf der Website [Learn Chef](https://learn.chef.io/) informieren. Weitere Informationen über die Chef-Suche finden Sie unter [About Search](https://docs.chef.io/chef_search.html) auf der Website [Learn Chef](https://learn.chef.io/).
+ Die `package`-Ressource installiert Git auf der Instance.
+ Die `application`-Ressource beschreibt und stellt Webanwendungen bereit:
  + `javascript`ist die Version der JavaScript Runtime, die installiert werden soll.
  + `environment` legt eine Umgebungsvariable fest.
  + `git` bekommt den Quellcode von dem angegebenen Repository und der Branch.
  + `app_path` ist der Pfad auf dem das Repository geklont werden soll. Wenn der Pfad auf der Instanz nicht existiert, erstellt OpsWorks Stacks ihn.
  + `link` erstellt einen symbolischen Link.
  + `npm_install` installiert Node Package Manager, den standardmäßigen Paket-Manager für Node.js.
  + `npm_start` führt Node.js aus.

 OpsWorks Stacks hat zwar das für diese Komplettlösung verwendete Kochbuch erstellt, Sie können jedoch auch Ihre eigenen Kochbücher erstellen. Um zu erfahren wie dies geht, vgl. [Erste Schritte: Rezeptbücher](gettingstarted-cookbooks.md). Weitere Informationen finden Sie unter [About Cookbooks](https://docs.chef.io/cookbooks.html), [About Recipes](https://docs.chef.io/recipes.html) und [Learn the Chef Basics on Ubuntu](https://learn.chef.io/modules/learn-the-basics/ubuntu#/) auf der Website [Learn Chef](https://learn.chef.io/) und im Abschnitt "Our first Chef cookbook" unter [First steps with Chef](http://gettingstartedwithchef.com/first-steps-with-chef.html) auf der Website [Getting started with Chef](http://gettingstartedwithchef.com/).

# Weiterführende Informationen: Arbeiten mit der Anwendung, die in dieser Anleitung verwendet wird
<a name="gettingstarted-linux-explore-app-source"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

In diesem Thema wird die App beschrieben, die OpsWorks Stacks für diese exemplarische Vorgehensweise auf der Instanz bereitstellt.

Um den Quellcode der App zu sehen, extrahieren Sie den Inhalt des [opsworks-windows-demo-nodejs](https://github.com/awslabs/opsworks-windows-demo-nodejs) GitHub Repositorys in ein leeres Verzeichnis auf Ihrer lokalen Workstation. Sie können sich auch in der Instance anmelden, auf der Sie das Rezeptbuch bereitgestellt haben, und sich mit den Inhalten des Verzeichnisses `/srv/mylinuxdemoapp` vertraut machen.

Die Datei `index.js` enthält den höchstwertigsten Code für die Anwendung:

```
var express = require('express');
var app = express();
var path = require('path');
var os = require('os');
var bodyParser = require('body-parser');
var fs = require('fs');

var add_comment = function(comment) {
  var comments = get_comments();
  comments.push({"date": new Date(), "text": comment});
  fs.writeFileSync('./comments.json', JSON.stringify(comments));
};

var get_comments = function() {
  var comments;
  if (fs.existsSync('./comments.json')) {
    comments = fs.readFileSync('./comments.json');
    comments = JSON.parse(comments);
  } else {
    comments = [];
  }
  return comments;
};

app.use(function log (req, res, next) {
  console.log([req.method, req.url].join(' '));
  next();
});
app.use(express.static('public'));
app.use(bodyParser.urlencoded({ extended: false }))

app.set('view engine', 'jade');
app.get('/', function(req, res) {
  var comments = get_comments();
  res.render("index",
    { agent: req.headers['user-agent'],
      hostname: os.hostname(),
      nodeversion: process.version,
      time: new Date(),
      admin: (process.env.APP_ADMIN_EMAIL || "admin@unconfigured-value.com" ),
      comments: get_comments()
    });
});

app.post('/', function(req, res) {
  var comment = req.body.comment;
  if (comment) {
    add_comment(comment);
    console.log("Got comment: " + comment);
  }
  res.redirect("/#form-section");
});

var server = app.listen(process.env.PORT || 3000, function() {
  console.log('Listening on %s', process.env.PORT);
});
```

Die Datei geht folgendermaßen vor:
+ `require` lädt Module mit einigen abhängigen Codes, die diese Webanwendung benötigt, um wie erwartet ausgeführt zu werden.
+ Die Funktionen `add_comment` und `get_comments` schreiben Informationen in die Datei `comments.json` und entnehmen sie ihr auch.
+ Weitere Informationen zu `app.get`, `app.listen`, `app.post`, `app.set` und `app.use` finden Sie unter [Express API Reference](http://expressjs.com/4x/api.html).

 Informationen dazu, wie Sie Ihre Anwendung für die Bereitstellung erstellen und packen, finden Sie unter [Anwendungsquelle](workingapps-creating.md#workingapps-creating-source).

# Erste Schritte mit Windows-Stacks
<a name="gettingstarted-windows"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Cloud-basierte Anwendungen erfordern in der Regel eine Gruppe verwandter Ressourcen — Anwendungsserver, Datenbankserver usw. —, die gemeinsam erstellt und verwaltet werden müssen. Diese Instances-Sammlung wird *Stack* genannt. Ein einfacher Anwendungs-Stack hat beispielsweise folgende Struktur.

![\[Diagram showing users connecting to app servers through internet, elastic IP, and load balancer.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/windows_walkthrough_arch.png)


Die grundlegende Architektur umfasst Folgendes:
+ Einer Elastic IP-Adresse, um Benutzeranfragen zu empfangen
+ Einem Load Balancer, um eingehende Anfragen gleichmäßig auf die Anwendungsserver zu verteilen
+ So viele Anwendungsserver-Instances wie erforderlich, um den Datenverkehr handhaben zu können.

Darüber hinaus benötigen Sie in der Regel eine Methode, um Anwendungen auf den Anwendungsservern zu verteilen, Benutzerberechtigungen zu verwalten usw.

OpsWorks Stacks bietet eine einfache und unkomplizierte Möglichkeit, Stacks und die zugehörigen Anwendungen und Ressourcen zu erstellen und zu verwalten. In diesem Kapitel werden die Grundlagen von OpsWorks Stacks — zusammen mit einigen der komplexeren Funktionen — vorgestellt, indem Sie im Diagramm Schritt für Schritt durch den Prozess der Erstellung des Anwendungsserver-Stacks geführt werden. Es verwendet ein inkrementelles Entwicklungsmodell, das mit OpsWorks Stacks leicht nachzuvollziehen ist: Richten Sie einen Basis-Stack ein und fügen Sie, nachdem er ordnungsgemäß funktioniert, Komponenten hinzu, bis Sie zu einer Implementierung mit vollem Funktionsumfang kommen.
+ [Schritt 1: Erfüllen der Voraussetzungen](gettingstarted-windows-prerequisites.md) erläutert die vorbereitenden Maßnahmen, um mit der Anleitung zu beginnen.
+ [Schritt 2: Erstellen eines Basis-Stacks für einen Anwendungsserver](gettingstarted-windows-basic.md)zeigt, wie Sie einen grundlegenden Stack zur Unterstützung von Internetinformationsdiensten (IIS) erstellen und eine App auf dem Server bereitstellen.
+ [Schritt 3: Skalieren IISExample](gettingstarted-windows-scale.md) zeigt, wie Sie einen Stack skalieren, um zusätzliche Auslastung zu verarbeiten, indem Sie weitere Anwendungsserver, einen Load Balancer zur Verteilung des eingehenden Datenverkehrs und eine Elastic IP-Adresse zum Annehmen eingehender Anfragen hinzufügen.

**Topics**
+ [Schritt 1: Erfüllen der Voraussetzungen](gettingstarted-windows-prerequisites.md)
+ [Schritt 2: Erstellen eines Basis-Stacks für einen Anwendungsserver](gettingstarted-windows-basic.md)
+ [Schritt 3: Skalieren IISExample](gettingstarted-windows-scale.md)
+ [Nächste Schritte](gettingstarted-windows-what-next.md)

# Schritt 1: Erfüllen der Voraussetzungen
<a name="gettingstarted-windows-prerequisites"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Um mit der Anleitung beginnen zu können, müssen Sie die folgenden Einrichtungsschritte ausführen. Zu diesen Einrichtungsschritten gehören die Registrierung für ein AWS Konto, die Erstellung eines Administratorbenutzers und die Zuweisung von Zugriffsberechtigungen für Stacks. OpsWorks 

Wenn Sie bereits eine der Anleitungen [Erste Schritte: Beispiel](gettingstarted-intro.md) oder [Erste Schritte: Linux](gettingstarted-linux.md) durchgearbeitet haben, erfüllen Sie bereits die Voraussetzungen für diese Anleitung und können direkt mit [Schritt 2: Erstellen eines Basis-Stacks für einen Anwendungsserver](gettingstarted-windows-basic.md) fortfahren.

**Topics**
+ [Registriere dich für ein AWS-Konto](#sign-up-for-aws)
+ [Erstellen eines Benutzers mit Administratorzugriff](#create-an-admin)
+ [Weisen Sie Dienstzugriffsberechtigungen zu](#gettingstarted-windows-prerequisites-permissions)
+ [Stellen Sie sicher, dass OpsWorks Stacks-Benutzer zu Ihrer Domain hinzugefügt wurden](#gettingstarted-windows-prerequisites-adusers)

## Registriere dich für ein AWS-Konto
<a name="sign-up-for-aws"></a>

Wenn Sie noch keine haben AWS-Konto, führen Sie die folgenden Schritte aus, um eine zu erstellen.

**Um sich für eine anzumelden AWS-Konto**

1. Öffnen Sie [https://portal.aws.amazon.com/billing/die Anmeldung.](https://portal.aws.amazon.com/billing/signup)

1. Folgen Sie den Online-Anweisungen.

   Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben.

   Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Benutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

AWS sendet Ihnen nach Abschluss des Anmeldevorgangs eine Bestätigungs-E-Mail. Du kannst jederzeit deine aktuellen Kontoaktivitäten einsehen und dein Konto verwalten, indem du zu [https://aws.amazon.com/](https://aws.amazon.com/)gehst und **Mein Konto** auswählst.

## Erstellen eines Benutzers mit Administratorzugriff
<a name="create-an-admin"></a>

Nachdem Sie sich für einen angemeldet haben AWS-Konto, sichern Sie Ihren Root-Benutzer des AWS-Kontos AWS IAM Identity Center, aktivieren und erstellen Sie einen Administratorbenutzer, sodass Sie den Root-Benutzer nicht für alltägliche Aufgaben verwenden.

**Sichern Sie Ihre Root-Benutzer des AWS-Kontos**

1.  Melden Sie sich [AWS-Managementkonsole](https://console.aws.amazon.com/)als Kontoinhaber an, indem Sie **Root-Benutzer** auswählen und Ihre AWS-Konto E-Mail-Adresse eingeben. Geben Sie auf der nächsten Seite Ihr Passwort ein.

   Hilfe bei der Anmeldung mit dem Root-Benutzer finden Sie unter [Anmelden als Root-Benutzer](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) im *AWS-Anmeldung -Benutzerhandbuch* zu.

1. Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA) für den Root-Benutzer.

   Anweisungen finden Sie unter [Aktivieren eines virtuellen MFA-Geräts für Ihren AWS-Konto Root-Benutzer (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) im *IAM-Benutzerhandbuch*.

**Erstellen eines Benutzers mit Administratorzugriff**

1. Aktivieren Sie das IAM Identity Center.

   Anweisungen finden Sie unter [Aktivieren AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-set-up-for-idc.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Gewähren Sie einem Administratorbenutzer im IAM Identity Center Benutzerzugriff.

   *Ein Tutorial zur Verwendung von IAM-Identity-Center-Verzeichnis als Identitätsquelle finden Sie IAM-Identity-Center-Verzeichnis im Benutzerhandbuch unter [Benutzerzugriff mit der Standardeinstellung konfigurieren](https://docs.aws.amazon.com/singlesignon/latest/userguide/quick-start-default-idc.html).AWS IAM Identity Center *

**Anmelden als Administratorbenutzer**
+ Um sich mit Ihrem IAM-Identity-Center-Benutzer anzumelden, verwenden Sie die Anmelde-URL, die an Ihre E-Mail-Adresse gesendet wurde, als Sie den IAM-Identity-Center-Benutzer erstellt haben.

  Hilfe bei der Anmeldung mit einem IAM Identity Center-Benutzer finden Sie [im *AWS-Anmeldung Benutzerhandbuch* unter Anmeldung beim AWS Access-Portal](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html).

**Weiteren Benutzern Zugriff zuweisen**

1. Erstellen Sie im IAM-Identity-Center einen Berechtigungssatz, der den bewährten Vorgehensweisen für die Anwendung von geringsten Berechtigungen folgt.

   Anweisungen hierzu finden Sie unter [ Berechtigungssatz erstellen](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-started-create-a-permission-set.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Weisen Sie Benutzer einer Gruppe zu und weisen Sie der Gruppe dann Single Sign-On-Zugriff zu.

   Eine genaue Anleitung finden Sie unter [ Gruppen hinzufügen](https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

## Weisen Sie Dienstzugriffsberechtigungen zu
<a name="gettingstarted-windows-prerequisites-permissions"></a>

Ermöglichen Sie den Zugriff auf den OpsWorks Stacks-Dienst (und die zugehörigen Dienste, auf die OpsWorks Stacks angewiesen ist), indem Sie Ihrer Rolle oder Ihrem `AmazonS3FullAccess` Benutzer die Berechtigungen `AWSOpsWorks_FullAccess` und hinzufügen.

Weitere Informationen zum Hinzufügen von Berechtigungen finden Sie unter [Hinzufügen von IAM-Identitätsberechtigungen (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policies-console).

## Stellen Sie sicher, dass OpsWorks Stacks-Benutzer zu Ihrer Domain hinzugefügt wurden
<a name="gettingstarted-windows-prerequisites-adusers"></a>

In einem Chef 12.2 Stack erstellt das enthaltene Rezeptbuch `aws_opsworks_users` Nutzer, die einen SSH- und Remote Desktop Protocol (RDP)-Zugriff auf Windows-basierte Instances haben. Wenn Sie Windows-Instanzen in Ihrem Stack mit einer Active Directory-Domäne verbinden, kann dieser Cookbook-Lauf fehlschlagen, wenn die OpsWorks Stacks-Benutzer nicht in Active Directory existieren. Werden die Benutzer im Active Directory nicht erkannt, können Instances in einen `setup failed`-Status übergehen, wenn Sie sie nach dem Hinzufügen zu einer Domäne neu starten. Für Windows-Instanzen, die in eine Domäne eingebunden sind, reicht es nicht aus, OpsWorks Stacks-Benutzern SSH/RDP Zugriff auf der Seite mit den Benutzerberechtigungen zu gewähren.

Bevor Sie Windows-Instanzen in einem Chef 12.2-Stack mit einer Active Directory-Domäne verbinden, stellen Sie sicher, dass alle OpsWorks Stacks-Benutzer des Windows-basierten Stacks Mitglieder der Domäne sind. Der beste Weg, dies zu tun, besteht darin, die föderierte Identität mit IAM zu konfigurieren, bevor Sie Ihren Windows-basierten Stack erstellen, und dann Verbundbenutzer in OpsWorks Stacks zu importieren, bevor Sie Instanzen in Ihrem Stack zu einer Domäne verbinden. Weitere Informationen dazu finden Sie unter [Enabling Federation to AWS Using Windows Active Directory, ADFS, and SAML 2.0](https://aws.amazon.com/blogs/security/enabling-federation-to-aws-using-windows-active-directory-adfs-and-saml-2-0/) im AWS-Sicherheitsblog und [Federating Existing Users im](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html#intro-identity-federation) *IAM-Benutzerhandbuch*.

# Schritt 2: Erstellen eines Basis-Stacks für einen Anwendungsserver
<a name="gettingstarted-windows-basic"></a>

**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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Ein Basis-Anwendungsserver-Stack besteht aus einer einzelnen Anwendungsserver-Instance mit einer öffentlichen IP-Adresse für den Empfang von Benutzeranforderungen. Der Anwendungscode und zugehörige Dateien werden in einem separaten Repository gespeichert und von dort auf dem Server bereitgestellt. Das folgende Diagramm veranschaulicht einen solchen Stack.

![\[Diagram showing application server stack with Windows instance, IIS layer, and AWS cloud integration.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/php_walkthrough_arch_2_windows.png)


Der Stack besteht aus folgenden Komponenten:
+ Einer *Ebene*, die eine Gruppe von Instances repräsentiert und festlegt, wie diese konfiguriert werden.

  Der Layer in diesem Beispiel steht für eine Gruppe von IIS-Instances.
+ Eine *Instance*, die eine EC2 Amazon-Instance darstellt.

  In diesem Fall konfiguriert der Layer eine einzelne Instance, um IIS auszuführen. Layer können jedoch auch mehrere Instances haben.
+ Eine *Anwendung*, die die erforderlichen Informationen zur Installation einer Anwendung in der Instance enthält.
+ Ein *Rezeptbuch* mit benutzerdefinierten Chef-Rezepten, die benutzerdefinierte IIS-Ebene unterstützen. Das Kochbuch und der App-Code werden in Remote-Repositorys gespeichert, z. B. in einer Archivdatei in einem Amazon S3 S3-Bucket oder einem Git-Repository.

In den folgenden Abschnitten wird beschrieben, wie Sie die OpsWorks Stacks-Konsole verwenden, um den Stack zu erstellen und die Anwendung bereitzustellen.

**Topics**
+ [Schritt 2.1: Erstellen des Stacks](gettingstarted-windows-stack.md)
+ [Schritt 2.2: Autorisieren von RDP-Zugriff](gettingstarted-windows-rdp.md)
+ [Schritt 2.3: Implementieren eines benutzerdefinierten Rezeptbuchs](gettingstarted-windows-cookbook.md)
+ [Schritt 2.4: Hinzufügen eines IIS-Layers](gettingstarted-windows-iis-layer.md)
+ [Schritt 2.5: Bereitstellen einer App](gettingstarted-windows-deploy.md)

# Schritt 2.1: Erstellen des Stacks
<a name="gettingstarted-windows-stack"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Sie starten ein OpsWorks Stacks-Projekt, indem Sie einen Stack erstellen, der als Container für Ihre Instances und andere Ressourcen fungiert. Die Stack-Konfiguration legt einige grundlegende Einstellungen fest, wie z. B. die AWS-Region und das Standardbetriebssystem, die von allen Stack-Instances gemeinsam genutzt werden. 

**Erstellen eines neuen Stacks**

1. 

**Hinzufügen eines Stacks**

   Falls Sie sich noch nicht bei der [OpsWorks  Stacks-Konsole](https://console.aws.amazon.com/opsworks/) angemeldet haben, tun Sie das jetzt.
   + Wenn für das Konto keine vorhandenen Stacks vorhanden sind, wird die OpsWorks Seite **Willkommen bei AWS** angezeigt. Wählen Sie **Add your first stack** aus.
   + **Andernfalls wird das OpsWorks Stacks-Dashboard angezeigt, in dem die Stacks Ihres Kontos aufgeführt sind. Wählen Sie Stack hinzufügen.**

1. 

**Konfigurieren des Stacks**

   Wählen Sie auf der Seite **Add Stack (Stack hinzufügen)** die Option **Chef 12 stack (Chef 12-Stack) ** aus und geben Sie die folgenden Einstellungen an:  
**Stack name**  
Geben Sie einen Namen für Ihren Stack ein, der alphanumerische Zeichen (a—z, A—Z und 0—9) und Bindestriche (-) enthalten kann. Der Beispiel-Stack in dieser Anleitung hat den Namen **IISWalkthrough**.  
**Region**  
Wählen Sie US West (Oregon) als Region des Stacks aus.  
Sie können einen Stack in jeder Region erstellen, wir empfehlen jedoch US West (Oregon) für Tutorials.  
**Standard-Betriebssystem**  
Wählen Sie **Windows** und geben Sie dann **Microsoft Windows Server 2022 Base** an, was die Standardeinstellung ist.  
**Verwenden von benutzerdefinierten Chef-Rezeptbüchern**  
Wählen Sie für diese Anleitung den Wert **No (Nein)** aus.

1. Wählen Sie **Advanced (Erweitert)** aus, um zu bestätigen, dass Sie über die IAM-Rolle verfügen und das Standard-IAM-Instance-Profil ausgewählt ist.  
IAM role (IAM-Rolle)  
Geben Sie die IAM (AWS Identity and Access Management) -Rolle des Stacks an. OpsWorks Stacks muss auf andere AWS-Services zugreifen, um Aufgaben wie das Erstellen und Verwalten von EC2 Amazon-Instances auszuführen. Die **IAM-Rolle** gibt die Rolle an, die OpsWorks Stacks annimmt, um in Ihrem Namen mit anderen AWS-Services zusammenzuarbeiten. Weitere Informationen finden Sie unter [OpsWorks Stacks erlauben, in Ihrem Namen zu handeln](opsworks-security-servicerole.md).  
   + Wenn Ihr Konto bereits über eine OpsWorks Stacks-IAM-Rolle verfügt, können Sie diese aus der Liste auswählen.

     Wenn die Rolle von OpsWorks Stacks erstellt wurde, erhält sie einen Namen. `aws-opsworks-service-role`
   + Wählen Sie andernfalls **Neue IAM-Rolle** aus, um OpsWorks Stacks anzuweisen, eine neue Rolle mit den richtigen Berechtigungen für Sie zu erstellen. 

     **Hinweis:** Wenn Sie umfassende Zugriffsberechtigungen für OpsWorks  Stacks haben, benötigen Sie für das Erstellen einer neuen Rolle einige zusätzliche IAM-Berechtigungen. Weitere Informationen finden Sie unter [Beispielrichtlinien](opsworks-security-users-examples.md).

1. Übernehmen Sie die Standardwerte für die restlichen Einstellungen und wählen Sie **Add Stack (Stack hinzufügen)** aus. Weitere Informationen zu den verschiedenen Stack-Einstellungen finden Sie unter [Erstellen eines neuen Stacks](workingstacks-creating.md).

# Schritt 2.2: Autorisieren von RDP-Zugriff
<a name="gettingstarted-windows-rdp"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Nachdem Sie einen Stack erstellt haben, erstellen Sie nun einen Layer und fügen diesem eine Windows-Instance hinzu. Zunächst müssen Sie jedoch den Stack so konfigurieren, dass RDP für die Verbindung mit den benutzerdefinierten Instances des Layers verwendet wird. Gehen Sie dazu wie folgt vor:
+ Fügen Sie der Sicherheitsgruppe, die für den RDP-Zugriff zuständig ist, eine Regel für eingehenden Datenverkehr hinzu.
+ Lege deine OpsWorks Stacks-Berechtigungen für diesen Stack fest, um RDP-Zugriff zu ermöglichen. 

Wenn Sie den ersten Stack in einer Region erstellen, erstellt OpsWorks Stacks eine Reihe von Sicherheitsgruppen. Dazu gehört eine mit dem Namen etwa`AWS-OpsWorks-RDP-Server`, die OpsWorks Stacks an alle Windows-Instanzen anhängt, um RDP-Zugriff zu ermöglichen. Standardmäßig sind in diesen Sicherheitsgruppe jedoch keine Regeln enthalten. Daher müssen Sie eine Regel für den eingehenden Datenverkehr zum Zulassen von RDP-Zugriff auf Ihre Instances hinzufügen.

**So ermöglichen Sie den RDP-Zugriff**

1. Öffnen Sie die [ EC2 Amazon-Konsole](https://console.aws.amazon.com/ec2/v2/), stellen Sie sie auf die Region des Stacks ein und wählen Sie im Navigationsbereich **Sicherheitsgruppen** aus.

1. **Wählen Sie **AWS- OpsWorks -RDP-Server**, klicken Sie auf die Registerkarte **Inbound** und dann auf Bearbeiten.**

1. Wählen Sie **Add Rule (Regel hinzufügen)** aus und legen Sie die folgenden Einstellungen fest:
   + ****Typ — RDP.****
   + **Quelle** — Die zulässigen Quell-IP-Adressen.

     In der Regel erlauben Sie eingehende RDP-Anfragen von Ihrer eigenen IP-Adresse oder einem festen IP-Adressbereich (üblicherweise der IP-Adressbereich Ihres Unternehmens). Für diese Anleitung können Sie einfach 0.0.0.0/0 verwenden, um RDP-Zugriff von beliebigen IP-Adressen zuzulassen.

Die Sicherheitsgruppe ermöglicht der Instance, RDP-Verbindungsanfragen zu empfangen. Das ist jedoch noch nicht alles. Ein normaler Benutzer meldet sich mit einem von OpsWorks Stacks bereitgestellten Passwort bei der Instanz an. Damit OpsWorks Stacks dieses Passwort generiert, müssen Sie den RDP-Zugriff für den Benutzer explizit autorisieren.

**So autorisieren Sie RDP-Zugriff für einen Benutzer**

1. Wählen Sie im OpsWorks Stacks-Dashboard den Stack aus. **IISWalkthrough**

1. Wählen Sie im Navigationsbereich des Stacks **Permissions (Berechtigungen)** aus.

1. Wählen Sie auf der Seite "Permissions" (Berechtigungen) die Option **Edit (Bearbeiten)** aus.

1. Wählen Sie in der Benutzerliste das Kontrollkästchen für **SSH/RDP** für den Benutzer aus, dem Sie die erforderlichen Berechtigungen erteilen möchten. Wenn Sie dem Benutzer außerdem auch Administratorberechtigungen gewähren möchten, wählen Sie noch **sudo/admin (sudo/admin)** aus.  
![\[SSH- und Sudo-Berechtigungen für Benutzer\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/permissions.png)

1. Wählen Sie **Speichern**.

Jetzt kann der Benutzer ein Passwort erhalten und sich damit wie nachfolgend beschrieben bei der Instance anmelden.

**Anmerkung**  
Sie können sich auch als Administrator anmelden. Weitere Informationen finden Sie unter [Anmelden als Administrator](workinginstances-rdp.md#workinginstances-rdp-admin).

# Schritt 2.3: Implementieren eines benutzerdefinierten Rezeptbuchs
<a name="gettingstarted-windows-cookbook"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Obwohl ein Stack im Grunde ein Container für Instances ist, fügen Sie einem Stack Instances nicht direkt hinzu. Sie fügen mindestens einen Layer hinzu. Jeder Layer repräsentiert dabei eine Gruppe zusammengehöriger Instances, die Sie dann den Layers hinzufügen.

Eine Ebene ist im Grunde eine Blaupause, die OpsWorks Stacks verwendet, um eine Reihe von EC2 Amazon-Instances mit derselben Konfiguration zu erstellen. Eine Instance beginnt mit einer Basisversion des Betriebssystems und der Layer der Instance führt verschiedene Aufgaben auf der Instance aus, um dieses Konzept zu implementieren, darunter:
+ Erstellen von Verzeichnissen und Dateien
+ Verwalten von Benutzern
+ Installieren und Konfigurieren von Software
+ Starten oder Beenden von Servern
+ Bereitstellen von Anwendungscode und zugehörigen Dateien

Eine Ebene führt Aufgaben auf Instances durch, indem sie [Chef-Rezepte — kurz Rezepte](https://docs.chef.io/recipes.html) — ausführt. Ein Rezept ist eine Ruby-Anwendung, die mithilfe der domänenspezifischen Sprache von Chef den endgültigen Zustand der Instance beschreibt. Bei OpsWorks Stacks wird jedes Rezept normalerweise einem der [Lebenszyklusereignisse](workingcookbook-events.md) der Ebene zugewiesen: Setup, Configuration, Deploy, Undeploy und Shutdown. Wenn ein Lebenszyklusereignis auf einer Instanz eintritt, führt OpsWorks Stacks die Rezepte des Ereignisses aus, um die entsprechenden Aufgaben auszuführen. Das Setup-Ereignis tritt beispielsweise ein, nachdem der Startvorgang einer Instanz abgeschlossen ist. OpsWorks Stacks führt dann die Setup-Rezepte aus, mit denen normalerweise Aufgaben wie das Installieren und Konfigurieren von Serversoftware und das Starten der zugehörigen Dienste ausgeführt werden.

OpsWorks Stacks stellt jeder Ebene eine Reihe von integrierten Rezepten zur Verfügung, mit denen Standardaufgaben ausgeführt werden. Mithilfe von benutzerdefinierten Rezepten, die Sie den einzelnen Lebenszyklusereignissen eines Layers zuweisen, können Sie die Funktionalität eines Layers um zusätzliche Aufgaben erweitern. Windows-Stacks unterstützen [benutzerdefinierte Ebenen](workinglayers-custom.md) mit einem minimalen Rezeptsatz ausschließlich für einige Basisaufgaben. Um Ihren Windows-Instances Funktionen hinzuzufügen, müssen Sie benutzerdefinierte Rezepte implementieren, um beispielsweise Software zu installieren oder Anwendungen bereitzustellen. In diesem Thema wird beschrieben, wie Sie einen einzelnen benutzerdefinierten Layer erstellen, um IIS-Instances zu unterstützen.

**Topics**
+ [Eine kurze Einführung in Rezeptbücher und Rezepte](#gettingstarted-windows-layer-recipes)
+ [Implementieren eines Rezepts zum Installieren und Starten von IIS](#gettingstarted-windows-layer-recipe-iis)
+ [Aktivieren des benutzerdefinierten Rezeptbuchs](#gettingstarted-windows-layer-enable-cookbook)

## Eine kurze Einführung in Rezeptbücher und Rezepte
<a name="gettingstarted-windows-layer-recipes"></a>

Ein Rezept definiert mindestens einen Aspekt des erwarteten Status einer Instance: welche Verzeichnisse sie haben sollte, welche Softwarepakete installiert sein sollten, welche Apps bereitgestellt werden sollten usw. Rezepte sind in einem *Rezeptbuch* zusammengefasst. Dieses enthält in der Regel ein oder mehrere zusammengehörige Rezepte sowie die zugehörigen Dateien wie Vorlagen zum Erstellen von Konfigurationsdateien.

In diesem Thema werden Sie grundlegend an Rezepte herangeführt und erfahren, wie Sie ein Rezeptbuch implementieren, um einen einfachen benutzerdefinierten IIS-Layer zu unterstützen. Weitere allgemeine Informationen zu Rezeptbüchern finden Sie unter [Cookbooks und Rezepte](workingcookbook.md). Eine detaillierte Einführung in die Implementierung von Rezeptbüchern einschließlich Windows-spezifischer Themen finden Sie unter [Rezeptbücher 101](cookbooks-101.md).

Chef-Rezepte sind technisch gesehen Ruby-Anwendungen. Ein Großteil des Codes ist jedoch in Chef DSL geschrieben. DSL besteht größtenteils aus einer Reihe von *Ressourcen*, mithilfe derer sich Aspekte des Zustands einer Instance beschreiben lassen. Eine [`directory`-Ressource](https://docs.chef.io/chef/resources.html#directory) definiert beispielsweise ein Verzeichnis, das einem System hinzugefügt werden soll. Im folgenden Beispiel wird das Verzeichnis `C:\data` des angegebenen Benutzers mit umfassenden Rechten definiert, das keine Rechte vom übergeordneten Verzeichnis erbt.

```
directory 'C:\data' do
  rights :full_control, 'WORKGROUP\username'
  inherits false
  action :create
end
```

Wenn Chef ein Rezept ausführt, wird jede Ressource einzeln ausgeführt. Dabei werden die Daten an einen zugehörigen *Anbieter* übergeben, ein Ruby-Objekt, das die Einzelheiten bei der Modifizierung des Instance-Zustands verarbeitet. In diesem Fall erstellt der Anbieter ein neues Verzeichnis mit der angegebenen Konfiguration.

Das benutzerdefinierte Rezeptbuch für den benutzerdefinierten IIS-Layer muss die folgenden Aufgaben ausführen:
+ Installieren der IIS-Funktion und Starten des Service

  Diese Aufgabe wird in der Regel während der Einrichtung direkt nach dem Hochfahren der Instance ausgeführt.
+ Bereitstellen einer App für die Instance, in diesem Beispiel eine einfache HTML-Seite

  Diese Aufgabe wird in der Regel während der Einrichtung ausgeführt. Apps müssen üblicherweise jedoch regelmäßig aktualisiert werden, daher müssen Sie auch Updates bereitstellen, während die Instance bereits online ist.

Sie können alle diese Aufgaben mit nur einem Rezept ausführen. Es empfiehlt sich jedoch, für Einrichtung und Bereitstellung jeweils eigene Rezepte zu verwenden. So können Sie App-Updates jederzeit bereitstellen, ohne dafür Einrichtungscode ausführen zu müssen. Nachfolgend wird beschrieben, wie Sie ein Rezeptbuch einrichten, um einen benutzerdefinierten IIS-Layer zu unterstützen. In den nachfolgenden Themen erfahren Sie, wie Sie die Rezepte implementieren.

**Dies sind Ihre ersten Schritte**

1. Erstellen Sie ein Verzeichnis namens `iis-cookbook` in einem lokalen Verzeichnis auf Ihrem Computer.

1. Fügen Sie eine Datei `metadata.rb` mit dem folgenden Inhalt zu `iis-cookbook` hinzu.

   ```
   name "iis-cookbook"
   version "0.1.0"
   ```

   In diesem Beispiel enthält die Datei `metadata.rb` nur minimale Daten. Weitere Informationen zur Verwendung dieser Datei finden Sie unter [metadata.rb](https://docs.chef.io/config_rb_metadata.html).

1. Fügen Sie ein Verzeichnis `recipes` zu `iis-cookbook` hinzu.

   Dieses Verzeichnis, das den Namen `recipes` haben muss, enthält die Rezepte des Rezeptbuchs.

Im Allgemeinen können Rezeptbücher verschiedene andere Verzeichnisse enthalten. Wenn ein Rezept beispielsweise eine Vorlage zum Erstellen einer Konfigurationsdatei enthält, wird diese Vorlage normalerweise im Verzeichnis `templates\default` gespeichert. Das Rezeptbuch in diesem Beispiel besteht nur aus Rezepten und benötigt daher keine weiteren Verzeichnisse. In diesem Beispiel wird außerdem nur ein einziges Rezeptbuch verwendet. Für komplexere Projekte können Sie jedoch auch beliebig viele Rezeptbücher verwenden. Es bietet sich beispielsweise an, für Einrichtung und Bereitstellung jeweils eigene Rezeptbücher zu verwenden. Weitere Beispiele für Rezeptbücher finden Sie unter [Cookbooks und Rezepte](workingcookbook.md).

## Implementieren eines Rezepts zum Installieren und Starten von IIS
<a name="gettingstarted-windows-layer-recipe-iis"></a>

 IIS ist eine Windows-*Funktion*, die zu einer Reihe optionaler Systemkomponenten gehört, die Sie auf Windows Server installieren können. Sie können IIS mithilfe eines Rezepts auf eine der folgenden Weisen installieren:
+ Verwenden Sie eine [https://docs.chef.io/chef/resources.html#powershell-script](https://docs.chef.io/chef/resources.html#powershell-script)-Ressource, um das [https://docs.microsoft.com/en-us/powershell/module/servermanager/install-windowsfeature?view=winserver2012-ps](https://docs.microsoft.com/en-us/powershell/module/servermanager/install-windowsfeature?view=winserver2012-ps)-Cmdlet auszuführen.
+ Verwenden Sie das Chef-[Windows-Rezeptbuch](https://github.com/opscode-cookbooks/windows)`windows_feature`.

  Das `windows`-Rezeptbuch enthält eine Reihe von Ressourcen, deren Anbieter mithilfe von [Abbildbereitstellung und Verwaltung](https://technet.microsoft.com/en-us/library/dd744256%28v=ws.10%29.aspx) (Deployment Image Servicing and Management, DISM)) verschiedene Aufgaben wie die Installation von Funktionen auf Windows-Instances ausführen.

**Anmerkung**  
`powershell_script` ist eine der wichtigsten Ressourcen für Windows-Rezepte. Sie können damit eine Vielzahl von Aufgaben auf einer Instanz ausführen, indem Sie ein PowerShell Skript oder ein Cmdlet ausführen. Skripte sind insbesondere für Aufgaben hilfreich, die von Chef-Ressourcen nicht unterstützt werden.

In diesem Beispiel wird ein PowerShell Skript zum Installieren und Starten des Webservers (IIS) ausgeführt. Das `windows`-Rezeptbuch wird im weiteren Verlauf dieser Anleitung beschrieben. Ein Beispiel für die Installation von IIS mithilfe von `windows_feature` finden Sie unter [Installieren einer Windows-Funktion: IIS](cookbooks-101-opsworks-install-software-feature.md).

Fügen Sie ein Rezept namens `install.rb` mit dem folgenden Inhalt zum Verzeichnis `recipes` des Rezeptbuchs hinzu.

```
powershell_script 'Install IIS' do
  code 'Install-WindowsFeature Web-Server'
  not_if "(Get-WindowsFeature -Name Web-Server).Installed"
end

service 'w3svc' do
  action [:start, :enable]
end
```

Das Rezept enthält zwei Ressourcen.

**powershell\$1script**  
`powershell_script`führt das angegebene PowerShell Skript oder Cmdlet aus. Das Beispiel verwendet folgende Attributeinstellungen:  
+ `code`— Die auszuführenden PowerShell Cmdlets.

  In diesem Beispiel wird ein `Install-WindowsFeature`-Cmdlet zur Installation von Web Server (IIS) ausgeführt. Allgemein kann das Attribut `code` beliebig viele Zeilen haben. Sie können also alle Cmdlets ausführen, die Sie benötigen.
+ `not-if`— Ein [https://docs.chef.io/chef/resources.html#guards](https://docs.chef.io/chef/resources.html#guards), das sicherstellt, dass das Rezept IIS nur installiert, wenn es noch nicht installiert wurde.

  Rezepte sind in der Regel *idempotent*, damit sie dieselbe Aufgabe nur einmal ausführen.
Jede Ressource hat eine Aktion, über die die Aktion festgelegt ist, die der Anbieter ausführt. Für dieses Beispiel gibt es keine explizite Aktion, daher ergreift der Anbieter die `:run` Standardaktion, bei der das angegebene PowerShell Skript ausgeführt wird. Weitere Informationen finden Sie unter [Ein PowerShell Windows-Skript ausführen](cookbooks-101-opsworks-opsworks-powershell.md).

**Service nicht zulässig**  
Ein [https://docs.chef.io/chef/resources.html#service](https://docs.chef.io/chef/resources.html#service) verwaltet einen Service, in diesem Fall den Web Server IIS-Service (W3SVC). Im Beispiel werden Standardattribute verwendet und zwei Aktionen festgelegt, `:start` und `:enable`, um IIS zu starten und zu aktivieren.

**Anmerkung**  
Wenn Sie Software über ein Paketinstallationsprogramm wie MSI installieren möchten, können Sie eine `windows_package`-Ressource verwenden. Weitere Informationen finden Sie unter [Installieren eines Pakets](cookbooks-101-opsworks-install-software-package.md).

## Aktivieren des benutzerdefinierten Rezeptbuchs
<a name="gettingstarted-windows-layer-enable-cookbook"></a>

OpsWorks Stacks führt auf jeder Instanz Rezepte aus einem lokalen Cache aus. Gehen Sie wie folgt vor, um eigene benutzerdefinierte Rezepte auszuführen:
+ Speichern Sie das Rezeptbuch in einem Remote-Repository.

  OpsWorks Stacks lädt die Kochbücher aus diesem Repository in den lokalen Cache jeder Instanz herunter.
+ Bearbeiten Sie den Stack, um benutzerdefinierte Rezeptbücher zu aktivieren.

  Benutzerdefinierte Rezeptbücher sind standardmäßig deaktiviert und müssen für den Stack zunächst aktiviert werden. Außerdem müssen Sie die URL des Repositorys sowie die dazugehörigen Informationen angeben.

OpsWorks Stacks unterstützt S3-Archive und Git-Repositorys für benutzerdefinierte Kochbücher. In diesem Beispiel wird ein S3-Archiv verwendet. Weitere Informationen finden Sie unter [Rezeptbuch-Repositorys](workingcookbook-installingcustom-repo.md).

**So verwenden Sie ein S3-Archiv**

1. Erstellen Sie ein `.zip`-Archiv des Verzeichnisses `iis-cookbook`.

   OpsWorks Stacks unterstützt auch `.tgz` (mit Gzip komprimierte Tar-) Archive für Windows-Stacks.

1. Laden Sie das Archiv in einen S3-Bucket in der Region USA West (Nordkalifornien) hoch und veröffentlichen Sie die Datei. Sie können auch private S3-Archive verwenden, öffentliche Archive sind für dieses Beispiel jedoch ausreichend und einfacher zu handhaben. 

   1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

   1. Wenn Sie noch keinen Bucket angelegt haben`us-west-1`, wählen Sie **Create Bucket** und erstellen Sie einen Bucket in der Region USA West (Nordkalifornien).

   1. Wählen Sie in der Bucket-Liste den Namen des Buckets aus, in den Sie die Datei hochladen möchten, und danach **Upload (Hochladen)**. 

   1. Wählen Sie **Add Files (Dateien hinzufügen)** aus.

   1. Wählen Sie die hochzuladende Archivdatei und danach **Open (Öffnen)**.

   1. Wählen Sie unten im Dialog **Upload - Select Files and Folders (Hochladen - Dateien und Ordner auswählen)** die Option **Set Details (Details festlegen)** aus.

   1. Wählen Sie unten im Dialog**Set Details (Details festlegen)** die Option **Set Permissions (Berechtigungen festlegen)** aus.

   1. Wählen Sie im Dialog **Set Permissions (Berechtigungen festlegen)** die Option **Make everything public (Alles veröffentlichen)** aus.

   1. Wählen Sie unten im Dialog**Set Permissions (Berechtigungen festlegen)** die Option **Start Upload (Hochladen starten)** aus. Nach dem Upload wird die Datei `iis-cookbook.zip` in Ihrem Bucket angezeigt.

   1. Wählen Sie den Bucket und danach die Registerkarte **Properties (Eigenschaften)** für den Bucket aus. Notieren Sie sich neben **Link (Link)** die URL der Archivdatei.

   Weitere Informationen zum Hochladen von Dateien in einen Amazon S3 S3-Bucket finden Sie unter [Wie lade ich Dateien und Ordner in einen S3-Bucket](https://docs.aws.amazon.com/AmazonS3/latest/UG/UploadingObjectsintoAmazonS3.html) hoch? im *Amazon S3 S3-Konsolen-Benutzerhandbuch*.

**Wichtig**  
Bisher hat diese Anleitung Sie nur wenig Zeit gekostet und OpsWorks  Stacks selbst ist kostenlos. Sie müssen jedoch für alle AWS-Ressourcen bezahlen, die Sie verwenden, z. B. Amazon S3 S3-Speicher. Sobald Sie das Archiv hochladen, entstehen Ihnen Kosten. Weitere Informationen finden Sie unter [AWS-Preise](https://aws.amazon.com/pricing/).

**So aktivieren Sie benutzerdefinierte Rezeptbücher für den Stack**

1. Wählen Sie in der OpsWorks Stacks-Konsole im Navigationsbereich **Stack** und dann oben rechts **Stack-Einstellungen** aus.

1. Wählen Sie oben rechts auf der Seite **Settings (Einstellungen)** die Option **Edit (Bearbeiten)** aus.

1. Legen Sie auf der Seite **Settings (Einstellungen)** die Option **Use custom Chef cookbooks (Benutzerdefinierte Chef-Rezeptbücher verwenden)** auf **Yes (Ja)** fest und geben Sie die folgenden Informationen ein:
   + Repository-Typ — **S3-Archiv**.
   + Repository-URL — Die S3-URL der Kochbuch-Archivdatei, die Sie zuvor aufgenommen haben.

1. Wählen Sie **Save (Speichern)** aus, um die Stack-Konfiguration zu aktualisieren.

OpsWorks Stacks installiert dein benutzerdefiniertes Kochbuch auf allen neuen Instanzen. Auf Online-Instances werden benutzerdefinierte Rezeptbücher jedoch nicht automatisch durch OpsWorks Stacks installiert oder aktualisiert. Dies können Sie, wie im weiteren Verlauf dieser Anleitung beschrieben, manuell tun.

# Schritt 2.4: Hinzufügen eines IIS-Layers
<a name="gettingstarted-windows-iis-layer"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Ihr Rezeptbuch enthält ein Rezept, mit dem IIS installiert und gestartet wird. Dies ist ausreichend, um den Layer zu erstellen und sicherzustellen, dass die IIS-Instance ordnungsgemäß funktioniert. Später werden Sie eine Funktion zur Anwendungsbereitstellung zum Layer hinzufügen.

## Erstellen eines Layers
<a name="w2ab1c14c47c17c23c23b7"></a>

Fügen Sie dem Stack zunächst einen Layer hinzu. Dann fügen Sie dem Layer Funktionen hinzu, indem Sie den entsprechenden Lebenszyklusereignissen benutzerdefinierte Rezepte hinzufügen.

**So fügen Sie einem Stack einen IIS-Layer hinzu**

1. Wählen Sie im Navigationsbereich **Layers (Layer)** und dann **Add a layer (Layer hinzufügen)** aus.

1. Konfigurieren Sie den Layer wie folgt:
   + **Name —** **IISExample** 
   + **Kurzname** — **iisexample**

     OpsWorks Stacks verwendet den Kurznamen, um die Ebene intern zu identifizieren. Außerdem wird der kurze Name verwendet, um den Layer in Rezepten zu identifizieren (nicht in diesem Beispiel). Sie können einen beliebigen kurzen Namen angeben. Er darf jedoch nur Kleinbuchstaben und eine geringe Anzahl an Satzzeichen enthalten. Weitere Informationen finden Sie unter [Benutzerspezifische Layers](workinglayers-custom.md).

1. Wählen Sie **Add Layer (Ebene hinzufügen)** aus.

Wenn Sie IISWalkthrough an dieser Stelle eine Instanz hinzufügen und sie starten würden, würde OpsWorks Stacks die Kochbücher automatisch installieren, aber sie würden nicht ausgeführt. `install.rb` Sobald eine Instance online ist, können Sie Rezepte mit dem [Stack-Befehl "execute recipes"](workingstacks-commands.md) manuell ausführen. Ein besserer Ansatz besteht jedoch darin, das Rezept einem der [Lebenszyklusereignisse](workingcookbook-events.md) der Ebene zuzuweisen. OpsWorks Stacks führt das Rezept dann automatisch an der entsprechenden Stelle im Lebenszyklus der Instanz aus.

Installieren und starten Sie IIS, sobald die Instance gestartet wurde. Zu diesem Zweck weisen Sie dem `Setup`-Ereignis des Layers `install.rb` zu.

**So weisen Sie das Rezept einem Lebenszyklusereignis zu**

1. Wählen Sie im Navigationsbereich **Layers (Ebenen)** aus.

1. Wählen Sie im Feld für die **IISExample**Ebene die Option **Rezepte** aus.

1. Wählen Sie rechts oben **Edit (Bearbeiten)** aus.

1. Geben Sie unter **Custom Chef Recipes (Benuterdefinierte Chef-Rezepte)** im Rezeptfeld **Setup (Einrichten)** die Option **iis-cookbook::install** ein. 
**Anmerkung**  
Rezepte werden anhand von `cookbook-name::recipe-name` identifiziert, wobei das Suffix `.rb` des Rezeptnamens weggelassen wird.

1. Wählen Sie das **\$1**-Symbol aus, um das Rezept der Ebene hinzuzufügen. Neben dem Rezept wird ein rotes "X" angezeigt, über das Sie es später einfach entfernen können.

1. Wählen Sie **Save (Speichern)** aus, um die neue Konfiguration zu speichern. Die benutzerdefinierten Einrichtungsrezepte sollten nun `iis-cookbook::install` enthalten.

## Hinzufügen einer Instance zum Layer und Starten der Instance
<a name="w2ab1c14c47c17c23c23b9"></a>

Sie können das Rezept ausprobieren, indem Sie der Ebene eine Instanz hinzufügen und die Instanz starten. OpsWorks Stacks installiert die Kochbücher automatisch und wird `install.rb` während des Setups ausgeführt, sobald die Instanz mit dem Booten fertig ist.

**So fügen Sie einem Layer eine Instance hinzu und starten diese**

1. **Wählen Sie im OpsWorks Stacks-Navigationsbereich die Option Instances aus.**

1. Wählen Sie unter **IISExample**Layer die Option **Instanz hinzufügen** aus. 

1. Wählen Sie die entsprechende Größe aus. **t2.micro (t2.micro)** (oder die kleinste verfügbare Größe) sollte für das Beispiel ausreichen.

1. Wählen Sie **Add Instance (Instance hinzufügen)** aus. **Standardmäßig generiert OpsWorks Stacks Instanznamen, indem eine Ganzzahl an den Kurznamen der Ebene angehängt wird. Daher sollte die Instanz den Namen iisexample1 haben.**

1. Wählen Sie **Start** in der Spalte **Aktionen** der Instanz aus, um die Instanz zu starten. OpsWorks Stacks startet dann eine EC2 Instanz und führt die Setup-Rezepte aus, um sie zu konfigurieren. Wenn der Layer zu diesem Zeitpunkt über Deploy-Rezepte verfügte, würde OpsWorks Stacks diese ausführen, nachdem die Setup-Rezepte abgeschlossen sind.

   Dies kann einige Minuten dauern. Der Status in der Spalte **Status (Status)** wechselt in dieser Zeit mehrfach. Sobald der Status **online (Online)** angezeigt wird, ist der Einrichtungsvorgang abgeschlossen und die Instance kann verwendet werden.

## Bestätigen, dass IIS installiert ist und ausgeführt wird
<a name="w2ab1c14c47c17c23c23c11"></a>

Sie können sich über RDP bei der Instance anmelden und überprüfen, ob das Einrichtungsrezept korrekt ausgeführt wurde.

**So überprüfen Sie, dass IIS installiert ist und ausgeführt wird**

1. **Wählen Sie im Navigationsbereich **Instances** und in der Spalte Actions der **iisexample1-Instanz** die Option **rdp** aus.** OpsWorks Stacks generiert automatisch ein RDP-Passwort für Sie, das nach einem bestimmten Zeitraum abläuft.

1. Legen Sie **Session valid for (Sitzung gültig für)** auf 2 Stunden fest und wählen Sie **Generate Password (Passwort generieren)** aus.

1. OpsWorks Stacks zeigt das Passwort und der Einfachheit halber auch den öffentlichen DNS-Namen und den Benutzernamen der Instanz an. Kopieren Sie alle drei und klicken Sie auf **Acknowledge and close (Bestätigen und schließen)**.

1. Öffnen Sie den RDP-Client und verwenden Sie die Daten aus Schritt 3, um eine Verbindung zur Instance herzustellen.

1. Öffnen Sie den Windows Explorer in der Instance und untersuchen Sie das Laufwerk `C:`. Hier sollte während der Installation von IIS ein Verzeichnis namens `C:\inetpub` angelegt worden sein.

1. Öffnen Sie in der Systemsteuerung die Anwendung **Verwaltung** und dann **Dienste**. Der IIS-Service sollte unten in der Liste angezeigt werden. Er hat den Namen "World Wide Web Publishing Service" und sollte den Status **Wird ausgeführt** haben.

1. Kehren Sie zur OpsWorks Stacks-Konsole zurück und wählen Sie die öffentliche IP-Adresse der **iisexample1-Instanz** aus. Stellen Sie sicher, dass Sie dies in OpsWorks Stacks und nicht in der EC2 Amazon-Konsole tun. Hierüber wird automatisch eine HTTP-Anfrage an die Adresse gesendet. Es sollte sich die Standard-IIS-Willkommensseite öffnen.

Im nächsten Thema wird erläutert, wie eine App auf der Instance bereitgestellt wird. In diesem Beispiel handelt es sich dabei um eine einfache statische HTML-Seite. Wenn Sie allerdings lieber eine Pause machen möchten, wählen Sie in der Spalte **Actions (Aktionen)** der Instance **iisexample1** die Option **stop (Anhalten)** aus, um die Instance anzuhalten und unnötige Gebühren zu vermeiden. Sie können die Instance jederzeit neu starten, wenn Sie bereit sind fortzufahren.

# Schritt 2.5: Bereitstellen einer App
<a name="gettingstarted-windows-deploy"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Service hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für Neu- als auch für Bestandskunden 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Bei der IIS-Installation wird ein Verzeichnis `C:\inetpub\wwwroot` für den Anwendungscode und die zugehörigen Dateien erstellt. Als nächstes installieren Sie eine App in diesem Verzeichnis. Für dieses Beispiel werden Sie eine statische HTML-Homepage, `default.html`, in `C:\inetpub\wwwroot` installieren. Dieser allgemeine Ansatz lässt sich einfach auf komplexere Szenarios wie ASP.NET-Anwendungen erweitern.

Sie können die Anwendungsdateien in Ihr Rezeptbuch aufnehmen und sie über `install.rb` in `C:\inetpub\wwwroot` kopieren. Beispiele für diese Vorgehensweise finden Sie unter [Beispiel 6: Erstellen von Dateien](cookbooks-101-basics-files.md). Dieser Ansatz ist allerdings nicht sonderlich flexibel oder effizient. Es empfiehlt sich daher in der Regel, die Bereitstellung von Rezeptbüchern und Anwendungen zu trennen.

Die bevorzugte Lösung besteht darin, ein separates Bereitstellungsrezept zu implementieren, das den Code der Anwendung und die zugehörigen Dateien aus einem Repository — einem beliebigen Repository, nicht nur dem Cookbook-Repository — abruft und es auf jeder IIS-Serverinstanz installiert. So wird die Bereitstellung von Rezeptbüchern und Anwendungen sauber getrennt, sodass Sie beim Aktualisieren von Anwendungen das Bereitstellungsrezept erneut ausführen können, ohne das Rezeptbuch aktualisieren zu müssen.

In diesem Thema wird gezeigt, wie Sie ein einfaches Bereitstellungsrezept implementieren, über das `default.htm` auf Ihrem IIS-Server bereitgestellt wird. Sie können diese Beispiel einfach auf komplexere Anwendungen übertragen.

**Topics**
+ [Erstellen der Anwendung und Speichern in einem Repository](#w2ab1c14c47c17c23c25c15)
+ [Implementieren eines Rezepts für die Bereitstellung der Anwendung](#w2ab1c14c47c17c23c25c17)
+ [Aktualisieren der Rezeptbücher der Instance](#w2ab1c14c47c17c23c25c19)
+ [Hinzufügen des Rezepts zum benutzerdefinierten IIS-Layer](#w2ab1c14c47c17c23c25c21)
+ [Hinzufügen einer Anwendung](#w2ab1c14c47c17c23c25c23)
+ [Bereitstellen der App und Öffnen der Anwendung](#w2ab1c14c47c17c23c25c25)

## Erstellen der Anwendung und Speichern in einem Repository
<a name="w2ab1c14c47c17c23c25c15"></a>

Sie können für Ihre Anwendungen ein beliebiges Repository verwenden. Der Einfachheit halber wird `default.htm` in diesem Beispiel in einem öffentlichen S3-Bucket gespeichert.

**So erstellen Sie die Anwendung**

1. Erstellen Sie ein Verzeichnis namens `iis-application` in einem lokalen Verzeichnis auf Ihrem Computer.

1. Fügen Sie eine Datei `default.htm` zu `iis-application` mit dem folgenden Inhalt hinzu:

   ```
   <!DOCTYPE html>
   <html>
     <head>
       <title>IIS Example</title>
     </head>
     <body>
       <h1>Hello World!</h1>
     </body>
   </html>
   ```

1. [Erstellen Sie einen S3-Bucket](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html), [laden Sie `default.htm` auf den Bucket](https://docs.aws.amazon.com/AmazonS3/latest/gsg/PuttingAnObjectInABucket.html) hoch und notieren Sie sich die URL. Machen Sie die Datei der Einfachheit halber [öffentlich](https://docs.aws.amazon.com/AmazonS3/latest/gsg/OpeningAnObject.html). 
**Anmerkung**  
Dies ist eine äußerst einfache Anwendung, die Grundprinzipien lassen sich jedoch einfach auf Anwendungen für die Produktion ausweiten.  
Bei komplexeren Anwendungen mit mehreren Dateien ist es in der Regel einfacher, ein ZIP-Archiv von `iis-application` zu erstellen und dieses auf Ihren S3-Bucket hochzuladen.  
Diese ZIP-Datei können Sie dann herunterladen und den Inhalt in das entsprechende Verzeichnis extrahieren. So müssen Sie weder mehrere Dateien herunterladen noch eine Verzeichnisstruktur nachbilden.
Bei Produktionsanwendungen sollten Sie Ihre Dateien privat halten. Ein Beispiel, wie Sie mit einem Rezept Dateien aus einem privaten S3-Bucket herunterladen, finden Sie unter [Verwenden des SDK for Ruby auf einer OpsWorks Stacks-Windows-Instanz](cookbooks-101-opsworks-s3-windows.md).
Sie können Anwendungen in jedem geeigneten Repository speichern.  
Anwendungen werden üblicherweise über die öffentliche API eines Repositorys heruntergeladen. In diesem Beispiel wird die Amazon S3 S3-API verwendet. Wenn Sie Ihre Anwendung beispielsweise auf speichern GitHub, können Sie die [GitHub API](https://developer.github.com/guides/getting-started/) verwenden.

## Implementieren eines Rezepts für die Bereitstellung der Anwendung
<a name="w2ab1c14c47c17c23c25c17"></a>

Fügen Sie ein Rezept namens `deploy.rb` dem Verzeichnis `iis-cookbook` `recipes` hinzu, mit folgendem Inhalt.

```
chef_gem "aws-sdk-s3" do
  compile_time false
  action :install
end

ruby_block "download-object" do
  block do
    require 'aws-sdk-s3'

    #1  
    # Aws.config[:ssl_ca_bundle] = 'C:\ProgramData\Git\bin\curl-ca-bundle.crt'
    Aws.use_bundled_cert!

    #2  
    query = Chef::Search::Query.new
    app = query.search(:aws_opsworks_app, "type:other").first
    s3region = app[0][:environment][:S3REGION]
    s3bucket = app[0][:environment][:BUCKET]
    s3filename = app[0][:environment][:FILENAME]

    #3  
    s3_client = Aws::S3::Client.new(region: s3region)
    s3_client.get_object(bucket: s3bucket,
                         key: s3filename,
                         response_target: 'C:\inetpub\wwwroot\default.htm')
  end 
  action :run
end
```

In diesem Beispiel wird [SDK for Ruby v2](https://docs.aws.amazon.com/sdkforruby/api/index.html) verwendet, um die Datei herunterzuladen. OpsWorks Stacks installiert dieses SDK jedoch nicht auf Windows-Instanzen, sodass das Rezept mit der [https://docs.chef.io/chef/resources.html#chef-gem](https://docs.chef.io/chef/resources.html#chef-gem)Ressource beginnt, die diese Aufgabe erledigt.

**Anmerkung**  
Die Ressource `chef_gem` installiert Gems in der Chef-eigenen Ruby-Version. Dies ist die Version, die in Rezepten verwendet wird. Wenn Sie ein Gem für eine systemweite Ruby-Version installieren möchten, verwenden Sie die Ressource [gem\$1package](https://docs.chef.io/chef/resources.html#gem-package).

Der Großteil des Rezepts ist eine [https://docs.chef.io/chef/resources.html#ruby-block](https://docs.chef.io/chef/resources.html#ruby-block)Ressource, die einen Block von Ruby-Code ausführt, der das SDK for Ruby zum Herunterladen verwendet`default.htm`. Der Code im `ruby_block` lässt sich in folgende Bereiche unterteilen, die den durchnummerierten Kommentaren im Codebeispiel entsprechen. 

**1: Angeben eines Zertifikat-Bundles**  
Amazon S3 verwendet SSL, sodass Sie ein entsprechendes Zertifikat benötigen, um Objekte aus einem S3-Bucket herunterzuladen. Das SDK for Ruby v2 enthält kein Zertifikatspaket, daher müssen Sie eines bereitstellen und das SDK for Ruby konfigurieren, um es verwenden zu können. OpsWorks Stacks installiert ein Zertifikatspaket nicht direkt, aber es installiert Git, das ein Zertifikatspaket (`curl-ca-bundle.crt`) enthält. Der Einfachheit halber konfiguriert dieses Beispiel das SDK for Ruby so, dass es das Git-Zertifikatspaket für SSL verwendet. Sie können auch eigene Bundles installieren und das SDK entsprechend konfigurieren.

**2: Abrufen der Repository-Daten**  
Um ein Objekt von Amazon S3 herunterzuladen, benötigen Sie die AWS-Region, den Bucket-Namen und den Schlüsselnamen. Wie nachfolgend beschrieben werden in diesem Beispiel diese Informationen bereitgestellt, indem eine Reihe von Umgebungsvariablen der Anwendung zugeordnet werden. Wenn Sie eine App bereitstellen, fügt OpsWorks Stacks dem Knotenobjekt der Instance eine Reihe von Attributen hinzu. Diese Attribute bestehen aus einer Hash-Tabelle, die die Anwendungskonfiguration einschließlich der Umgebungsvariablen enthält. Die Anwendungsattribute für diese Anwendung im JSON-Format sehen etwa wie folgt aus.   

```
{
  "app_id": "8f71a9b5-de7f-451c-8505-3f35086e5bb3",
  "app_source": {
      "password": null,
      "revision": null,
      "ssh_key": null,
      "type": "other",
      "url": null,
      "user": null
  },
  "attributes": {
      "auto_bundle_on_deploy": true,
      "aws_flow_ruby_settings": {},
      "document_root": null,
      "rails_env": null
  },
  "data_sources": [{"type": "None"}],
  "domains": ["iis_example_app"],
  "enable_ssl": false,
  "environment": {
      "S3REGION": "us-west-2",
      "BUCKET": "windows-example-app",
      "FILENAME": "default.htm"
  },
  "name": "IIS-Example-App",
  "shortname": "iis_example_app",
  "ssl_configuration": {
      "certificate": null,
      "private_key": null,
      "chain": null
  },
  "type": "other",
  "deploy": true
}
```
Die Umgebungsvariablen der Anwendung werden im Attribut `[:environment]` gespeichert. Um diese abzurufen, verwenden Sie eine Chef-Suchanfrage, mit der Sie die Hash-Tabelle der Anwendung abrufen, die im Knoten `aws_opsworks_app` gespeichert ist. Diese Anwendung hat den Typ `other`, die Anfrage sucht also nach Anwendungen dieses Typs. Das Rezept nutzt die Tatsache, dass sich auf dieser Instance nur eine Anwendung befindet. Die gewünschte Hash-Tabelle ist also einfach `app[0]`. Der Einfachheit halber weist das Rezept dann die Region-, Bucket- und Dateinamen Variablen zu.  
Weitere Informationen zur Verwendung der Chef-Suche finden Sie unter [Abrufen von Attributwerten mit der Chef-Suche](cookbooks-101-opsworks-opsworks-stack-config-search.md).

**3: Herunterladen der Datei**  
Im dritten Teil des Rezepts wird ein [S3-Client-Objekt](https://docs.aws.amazon.com/sdkforruby/api/Aws/S3/Client.html) erstellt und mit der Methode `[get\$1object](https://docs.aws.amazon.com/sdkforruby/api/Aws/S3/Client.html#get_object-instance_method)` die Datei `default.htm` in das Verzeichnis `C:\inetpub\wwwroot` der Instance heruntergeladen. 

**Anmerkung**  
Ein Rezept ist eine Ruby-Anwendung, der Ruby-Code muss sich also nicht unbedingt in einem `ruby_block` befinden. Der Code im Text des Rezepts wird jedoch zuerst ausgeführt. Danach werden die Ressourcen der Reihe nach abgearbeitet. Wenn Sie in diesem Beispiel den Download-Code in den Rezepttext einfügen, schlägt dies fehl, da die `chef_gem` Ressource das SDK for Ruby noch nicht installiert hätte. Der Code in der `ruby_block` Ressource wird ausgeführt, wenn die Ressource ausgeführt wird, nachdem die `chef_gem` Ressource das SDK for Ruby installiert hat.

## Aktualisieren der Rezeptbücher der Instance
<a name="w2ab1c14c47c17c23c25c19"></a>

OpsWorks Stacks installiert automatisch benutzerdefinierte Kochbücher auf neuen Instanzen. Sie arbeiten jedoch mit einer bestehenden Instance und müssen Ihr Rezeptbuch daher manuell aktualisieren.

**So aktualisieren Sie die Rezeptbücher der Instance**

1. Erstellen Sie ein `.zip`-Archiv von `iis-cookbook` und laden Sie es in den S3-Bucket hoch.

   Das vorhandene Rezeptbuch wird dadurch überschrieben. Die URL bleibt jedoch dieselbe, Sie müssen die Stack-Konfiguration also nicht aktualisieren.

1. Wenn Ihre Instance nicht online ist, starten Sie sie neu.

1. Wenn die Instance online ist, wählen Sie im Navigationsbereich **Stack** und dann **Run Command (Befehl ausführen)** aus.

1. Wählen Sie für **Command (Befehl)** [Update Custom Cookbooks (Benutzerdefinierte Rezeptbücher aktualisieren)](workingstacks-commands.md) aus. Mit diesem Befehl installieren Sie das aktualisierte Rezeptbuch auf der Instance.

1. Wählen Sie **Update Custom Cookbooks (Benutzerdefinierte Rezeptbücher aktualisieren)** aus. Die Ausführung dieses Befehls kann einige Minuten dauern.

## Hinzufügen des Rezepts zum benutzerdefinierten IIS-Layer
<a name="w2ab1c14c47c17c23c25c21"></a>

Wie auch bei `install.rb` ist die bevorzugte Methode für die Bereitstellung, `deploy.rb` dem entsprechenden Lebenszyklusereignis zuzuweisen. Rezepte zur Bereitstellung werden normalerweise dem Ereignis "Bereitstellung" zugewiesen und zusammenfassend als Bereitstellungsrezepte bezeichnet. Allein durch die Zuweisung zum Ereignis "Bereitstellung" wird das Ereignis noch nicht ausgelöst. Stattdessen geschieht Folgendes:
+ Bei neuen Instanzen führt OpsWorks Stacks die Deploy-Rezepte automatisch aus, nachdem die Setup-Rezepte abgeschlossen sind, sodass neue Instanzen automatisch über die aktuelle Anwendungsversion verfügen.
+ Bei Online-Instances verwenden Sie einen [Bereitstellungsbefehl](workingapps-deploying.md), um neue oder aktualisierte Anwendungen manuell zu installieren.

  Über diesen Befehl wird ein Bereitstellungsereignis auf den Instances des Stack ausgelöst, das wiederum die Bereitstellungsrezepte ausführt.

**So weisen Sie deploy.rb dem Ereignis "Bereitstellung" des Layers zu**

1. Wählen Sie im Navigationsbereich **Ebenen** und dann unter **Ebene IISExample** die Option **Rezepte** aus.

1. Fügen Sie unter **Custom Chef Recipes (Benutzerdefinierte Chef-Rezepte)** die Zeichenfolge **iis-cookbook::deploy** dem Rezeptfeld **Deploy (Bereitstellen)** hinzu und wählen Sie **\$1** aus, um der Ebene das Rezept hinzuzufügen.

1. Wählen Sie **Save (Speichern)** aus, um die neue Konfiguration zu speichern. Die benutzerdefinierten Bereitstellungsrezepte sollten nun `iis-cookbook::deploy` enthalten.

## Hinzufügen einer Anwendung
<a name="w2ab1c14c47c17c23c25c23"></a>

Die letzte Aufgabe besteht darin, dem Stack eine App hinzuzufügen, um Ihre Anwendung in der OpsWorks Stacks-Umgebung darzustellen. Eine App enthält Metadaten wie den Anzeigenamen der Anwendung sowie die Daten, die Sie zum Herunterladen der App aus dem Repository benötigen.

**So fügen Sie dem Stack die App hinzu**

1. Wählen Sie im Navigationsbereich **Apps (Anwendungen)** und dann **Add an app (Anwendung hinzufügen)** aus.

1. Konfigurieren Sie die App mit den folgenden Einstellungen.
   + **Name** — ich **IIS-Example-App**
   + **Repository-Typ** — **Andere**
   + **Umgebungsvariablen** — Fügen Sie die folgenden drei Umgebungsvariablen hinzu:
     + **S3REGION**— Die Region des Buckets (in diesem Fall`us-west-1`).
     + **BUCKET**— Der Bucket-Name, z. `windows-example-app` B.
     + **FILENAME**— Der Dateiname:**default.htm**.

1. Akzeptieren Sie Standardwerte für die übrigen Einstellungen und wählen Sie dann **Add App (Anwendung hinzufügen)** aus, um dem Stack die Anwendung hinzuzufügen.

**Anmerkung**  
In diesem Beispiel werden die Download-Daten über Umgebungsvariablen bereitgestellt. Ein alternativer Ansatz besteht darin, einen S3-Archive-Repository-Typ zu verwenden und die URL der Datei anzugeben. OpsWorks Stacks fügt die Informationen zusammen mit optionalen Daten wie Ihren AWS-Anmeldeinformationen zum `app_source` Attribut der App hinzu. Ihr Bereitstellungsrezept muss daraufhin die URL aus den App-Attributen abrufen und daraus die Region, den Bucket-Namen und den Dateinamen extrahieren.

## Bereitstellen der App und Öffnen der Anwendung
<a name="w2ab1c14c47c17c23c25c25"></a>

OpsWorks Stacks stellt Apps automatisch für neue Instances bereit, nicht jedoch für Online-Instances. Da Ihre Instance bereits online ist, müssen Sie die App manuell bereitstellen.

**So stellen Sie die App bereit**

1. Wählen Sie im Navigationsbereich **Apps (Anwendungen)** und dann in der Spalte **Actions (Aktionen)** der Anwendung **deploy (Bereitstellen)** aus.

1. **Command (Befehl)** muss auf **Deploy (Bereitstellen)** eingestellt sein. Wählen Sie **Deploy (Bereitstellen)** rechts unten auf der Seite **Deploy App (App bereitstellen)**. Die Ausführung dieses Befehls kann einige Minuten dauern.

   Nachdem die Bereitstellung abgeschlossen wurde, kehren Sie zur Seite **Apps** zurück. Die Anzeige **Status** zeigt in grüner Schrift **successful (Erfolgreich)** an und neben dem Namen der Anwendung wird die erfolgreiche Bereitstellung durch ein grünes Häkchen dargestellt.

**Anmerkung**  
Windows-Apps haben grundsätzlich den App-Typ **Other (Sonstige)**. Durch die Bereitstellung der App geschieht daher Folgendes:  
Die Anwendungsdaten werden wie zuvor beschrieben den [Stack-Konfigurations- und Bereitstellungsattributen](workingcookbook-json.md) hinzugefügt.
Es wird ein Bereitstellungsereignis auf den Instances des Stacks ausgelöst, durch das Ihre benutzerdefinierten Bereitstellungsrezepte ausgeführt werden.

**Anmerkung**  
Weitere Informationen zur Fehlerbehebung bei fehlgeschlagenen Bereitstellungen oder Anwendungen finden Sie unter [Debuggen von Rezepten](troubleshoot-debug.md).

Die App ist jetzt installiert. Um sie zu öffnen, wählen Sie **Instances (Instances)** im **Navigationsbereich** und dann die öffentliche IP-Adresse der Instance aus. Es wird eine HTTP-Anfrage an die Instance gesendet und es wird in etwa Folgendes in Ihrem Browser angezeigt.

![\[Text displaying "Hello World!" in large, bold font against a white background.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/windows-iis-app.png)


# Schritt 3: Skalieren IISExample
<a name="gettingstarted-windows-scale"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Wenn die eingehenden Benutzeranfragen eine einzelne t2.Micro-Instance nahezu auslasten, müssen Sie die Serverkapazitäten erweitern. Sie können auf eine größere Instance wechseln. Dieser Methode sind jedoch Grenzen gesetzt. Flexibler sind Sie, wenn Sie Ihrem Stack weitere Instances hinzufügen und einen Load Balancer davor schalten. Die grundlegende Architektur sieht dabei etwa wie folgt aus.

![\[OpsWorks stack architecture with load balancer, Windows instances, and external repositories.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/php_walkthrough_arch_4_windows.png)


Dieser Ansatz hat unter anderem den Vorteil, dass er weniger fehleranfällig ist als eine einzelne große Instance.
+ Falls eine Instance ausfällt, verteilt der Load Balancer eingehende Anfragen auf die übrigen Instances und die Anwendungen werden weiterhin ausgeführt.
+ Wenn Sie Instances in verschiedenen Availability Zones betreiben (dies ist die empfohlene Vorgehensweise), funktionieren Anwendungen auch dann, wenn in einer Availability Zone Probleme auftreten.

OpsWorks Stacks macht es einfach, Stapel zu skalieren. In diesem Abschnitt werden die Grundlagen beschrieben, wie Sie einen Stack skalieren können, indem Sie eine zweite rund um die Uhr verfügbare PHP App Server-Instance zu einem Elastic Load Balancer hinzufügen IISExample und beide Instanzen hinter einem Elastic Load Balancing Load Balancer platzieren. Sie können das Verfahren einfach erweitern, um eine beliebige Anzahl von 24/7-Instances hinzuzufügen, oder Sie können zeitbasierte Instances verwenden, damit OpsWorks Stacks Ihren Stack automatisch skaliert. Weitere Informationen finden Sie unter [Verwaltung der Last mit zeit- und lastbasierten Instanzen](workinginstances-autoscaling.md). 

# Hinzufügen eines Load Balancers
<a name="gettingstarted-windows-scale-elb"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Elastic Load Balancing ist ein AWS-Service, der den eingehenden Anwendungsdatenverkehr automatisch auf mehrere EC2 Amazon-Instances verteilt. Ein Load Balancer hat zwei Anwendungsgebiete. Das offensichtlichere ist eine gleichmäßige Auslastung Ihrer Anwendungsserver zu gewährleisten. Viele Websites ziehen es vor, die Anwendungsserver und Datenbanken vom direkten Benutzerzugriff zu trennen. Elastic Load Balancing verteilt nicht nur den Traffic, sondern bietet auch folgende Funktionen:
+ Erkennt fehlerhafte EC2 Amazon-Instances.

  Er leitet Datenverkehr auf die übrigen fehlerfreien Instances um, bis die Fehler behoben wurden.
+ Er skaliert als Reaktion auf den eingehenden Datenverkehr automatisch die Kapazität zur Anforderungsbearbeitung.

**Anmerkung**  
OpsWorks Stacks unterstützt den Application Load Balancer nicht. Sie können Classic Load Balancer nur mit OpsWorks Stacks verwenden.

Elastic Load Balancing wird zwar oft als Ebene bezeichnet, funktioniert aber etwas anders als die anderen integrierten Ebenen. Anstatt eine Ebene zu erstellen und ihr Instances hinzuzufügen, erstellen Sie mithilfe der EC2 Amazon-Konsole einen Elastic Load Balancing Load Balancer und fügen ihn dann einer Ihrer vorhandenen Ebenen hinzu, in der Regel einer Anwendungsserverschicht. OpsWorks Stacks registriert dann die vorhandenen Instances der Ebene beim Service und fügt automatisch alle neuen Instances hinzu. Nachfolgend wird beschrieben, wie Sie einen Load Balancer hinzufügen.

**So fügen Sie einen Load Balancer an den benutzerdefinierten IIS-Layer an**

1. Verwenden Sie die EC2 Amazon-Konsole, um einen neuen Load Balancer für IISExample zu erstellen. Weitere Informationen finden Sie unter [Erste Schritte mit Elastic Load Balancing](https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/load-balancer-getting-started.html). Wenn Sie den Assistenten **Load Balancer erstellen** ausführen, konfigurieren Sie den Load Balancer wie folgt:  
**1: Definieren von Load Balancer**  
Weisen Sie dem Load Balancer einen leicht erkennbaren Namen wie IIS-LB zu, damit er in der Stacks-Konsole leichter auffindbar ist. OpsWorks Akzeptieren Sie die Standardwerte für die verbleibenden Einstellungen und wählen Sie dann **Weiter: Zuweisen von Sicherheitsgruppen** aus.  
**2: Zuweisen von Sicherheitsgruppen**  
Wenn Ihr Konto die Standard-VPC unterstützt, zeigt der Assistent diese Seite an, um die Sicherheitsgruppe des Load Balancers festzulegen. Diese Seite für Classic wird nicht angezeigt. EC2   
Geben Sie für diese Anleitung **default VPC security group (Standard-VPC-Sicherheitsgruppe)** an und wählen Sie dann **Weiter: Konfigurieren von Sicherheitseinstellungen** aus.  
**3: Konfigurieren von Sicherheitseinstellungen**  
Für diese Anleitung müssen Sie für Ihren Load Balancer einen sicheren Listener verwenden (d. h. HTTPS oder SSL als Frontend-Verbindung). Wählen Sie daher **Weiter: Konfigurieren der Zustandsprüfung** aus, um fortzufahren.  
**4: Konfigurieren der Zustandsprüfung**  
Setzen Sie den Ping-Pfad auf **/**. Akzeptieren Sie die Standardeinstellungen für die übrigen Einstellungen und wählen Sie dann **Weiter: EC2 Instanzen hinzufügen**.  
**5: Instanzen hinzufügen EC2 **  
OpsWorks Stacks kümmert sich automatisch um die Registrierung von Instances beim Load Balancer. Wählen Sie **Weiter: Hinzufügen von Tags** aus, um fortzufahren.   
**6: Hinzufügen von Tags**  
In diesem Beispiel werden keine Tags verwendet. Wählen Sie **Review and Create (Prüfen und Erstellen)** aus.   
**7: Prüfen**  
Überprüfen Sie Ihre Auswahl und wählen Sie **Create (Erstellen)** und dann **Close (Schließen)** aus, um den Load Balancer zu starten.

1. Wenn Ihr Konto die Standard-VPC unterstützt, müssen Sie nach dem Starten des Load Balancers überprüfen, dass die Sicherheitsgruppe über die erforderlichen Regeln für eingehenden Datenverkehr verfügt. Mit der Standardregel wird eingehender Datenverkehr nicht akzeptiert.

   1. Wählen Sie im EC2 Amazon-Navigationsbereich die Option **Sicherheitsgruppen** aus.

   1. Wählen Sie **default VPC security group (Standard-VPC-Sicherheitsgruppe)** aus.

   1. Klicken Sie auf die Registerkarte **Inbound** und wählen Sie **Edit** aus.

   1. Legen Sie für diese Anleitung für **Source (Quelle)** den Wert **Anywhere (Beliebig)** fest. So akzeptiert der Load Balancer eingehenden Datenverkehr von beliebigen IP-Adressen. 

   1. Klicken Sie auf **Speichern**.

1. Kehren Sie zur OpsWorks Stacks-Konsole zurück. Wählen Sie auf der Seite **Layers (Ebenen)** die Option **Network (Netzwerk)** aus.

1. Wählen Sie unter **Elastic Load Balancing** den IIS-LB-Load Balancer aus, den Sie in Schritt 1 erstellt haben, und klicken Sie auf **Save (Speichern)**.

   Nachdem Sie den Load Balancer mit dem Layer verbunden haben, registriert OpsWorks Stacks automatisch die aktuellen Instanzen des Layers und fügt neue Instanzen hinzu, sobald sie online sind.

1. Klicken Sie auf der Seite **Layers (Ebenen)** auf den Load Balancer-Namen, um dessen Detailseite aufzurufen. An dem grünen Häkchen neben der Instance auf der Seite des Load Balancers erkennen Sie, dass die Instance die Zustandsprüfung bestanden hat.

Sie können jetzt ausführen, IIS-Example-App indem Sie eine Anfrage an den Load Balancer senden.

**Um den Load IIS-Example-App Balancer zu durchlaufen**

1. Wählen Sie **Layers (Ebenen)** aus. Der IIS-ELB-Load Balancer sollte als Layer aufgeführt sein und die Spalte "Zustandsprüfung" sollte eine grüne, also fehlerfreie Instance enthalten.

1. Wählen Sie den DNS-Namen des Load Balancers, der ausgeführt werden soll. IIS-Example-App Die App sollte unter dem Namen des Load Balancers aufgeführt sein und etwa wie folgt aussehen: `IIS-LB-1802910859.us-west-2.elb.amazonaws.com`. Der Load Balancer leitet die Anfrage an die Instance weiter und gibt die Antwort zurück. Diese Antwort sollte mit derjenigen Antwort übereinstimmen, die Sie durch einen Klick auf die öffentliche IP-Adresse der Instance erhalten.

Sie haben bisher nur eine Instance, daher bringt der Load Balancer noch nicht viel. Sie können dem Layer jetzt jedoch weitere Instances hinzufügen.

**So fügen Sie dem Layer eine Instance hinzu**

1. Wählen Sie **Instances** und dann **\$1 instance (\$1 Instance)** aus, um der Ebene eine weitere Instance hinzuzufügen.

1. Starten Sie die Instance.

Da es sich um neue Instanzen handelt, installiert OpsWorks Stacks automatisch die aktuellen benutzerdefinierten Kochbücher und stellt die aktuelle App-Version während der Einrichtung bereit. Wenn die Instance online geht, fügt OpsWorks Stacks sie automatisch dem Load Balancer hinzu, sodass Ihre Instance sofort mit der Bearbeitung von Anfragen beginnt. Um die Funktionsweise der Anwendung zu überprüfen, wählen Sie den DNS-Namen des Load Balancers erneut aus.

# Nächste Schritte
<a name="gettingstarted-windows-what-next"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

In dieser Anleitung haben Sie die Grundlagen der Einrichtung eines einfachen Windows-Anwendungsserver-Stacks kennengelernt. Im Folgenden finden Sie einige Vorschläge für die nächsten Schritte.
+ Wenn du mehr wissen möchtest, [Erste Schritte: Rezeptbücher](gettingstarted-cookbooks.md) bietet es ein Tutorial zur Einführung in die Implementierung von Kochbüchern und enthält eine Reihe von OpsWorks Stacks-spezifischen Beispielen. 
+ Sie können dem Stack eine [Amazon Relational Database Service (Amazon RDS) -Ebene](workinglayers-db-rds.md) hinzufügen, um sie als Backend-Datenbankserver zu verwenden. Weitere Informationen dazu, wie Sie Ihre Anwendung mit der Datenbank verknüpfen, finden Sie unter [Verwenden von benutzerdefinierten Rezepten](workingapps-connectdb.md#workingapps-connectdb-custom).

# Erste Schritte mit Kochbüchern in Stapeln OpsWorks
<a name="gettingstarted-cookbooks"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Ein OpsWorks Stacks-Stack auf Produktionsebene erfordert in der Regel einige Anpassungen, was häufig die Implementierung eines benutzerdefinierten Chef-Kochbuches bedeutet. Ein *Rezeptbuch* ist eine Paket-Datei, die Konfigurationsdaten, einschließlich Anleitungen, die als *Rezepte* bezeichnet werden, enthält. Ein *Rezept* enthält mindestens eine in der Ruby-Sprachsyntax geschriebene Anleitung, die die zu verwendenden Ressourcen sowie deren Anwendungsreihenfolge angibt. Eine *Ressource* in Chef stellt eine Anweisung einer Konfigurationsrichtlinie dar. Diese exemplarische Vorgehensweise bietet eine grundlegende Einführung in die Implementierung von Chef-Kochbüchern für Stacks. OpsWorks Weitere Informationen zu Chef, Rezeptbüchern, Rezepten und Ressourcen erhalten Sie über die folgenden Links: [Nächste Schritte](gettingstarted-cookbooks-next-steps.md).

In dieser Anleitung wird im Wesentlichen das Erstellen eigener Rezeptbücher beschrieben. Sie können auch von der Community bereitgestellte Rezeptbücher auf Websites wie [Chef Supermarket](https://supermarket.chef.io) verwenden. Wir haben weiter hinten Anleitungen zur Nutzung eines Community-Rezeptbuchs aus Chef Supermarket eingefügt, um Ihnen den Einstieg in die Rezeptbücher der Community zu erleichtern.

Ehe Sie mit dieser Anleitung beginnen, nehmen Sie noch einige Einrichtungsschritte vor. Wenn Sie bereits eine der anderen Anleitungen in diesem Kapitel durchgearbeitet haben, beispielsweise [Erste Schritte: Beispiel](gettingstarted-intro.md), dann haben Sie die Voraussetzungen für diese Anleitung erfüllt und können direkt [beginnen](gettingstarted-cookbooks-create-cookbook.md). Wenn Sie die [Voraussetzungen](gettingstarted-intro-prerequisites.md) noch nicht erfüllt haben, sollten Sie dies jetzt nachholen und anschließend zu dieser Anleitung zurückkehren.

**Topics**
+ [Schritt 1: Erstellen des Rezeptbuchs](gettingstarted-cookbooks-create-cookbook.md)
+ [Schritt 2: Erstellen des Stacks und dessen Komponenten](gettingstarted-cookbooks-create-stack.md)
+ [Schritt 3: Ausführen und Testen des Rezepts](gettingstarted-cookbooks-test-recipe.md)
+ [Schritt 4: Aktualisieren des Rezeptbuchs zum Installieren eines Pakets](gettingstarted-cookbooks-install-package.md)
+ [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md)
+ [Schritt 6: Aktualisieren des Rezeptbuchs zum Hinzufügen eines Benutzers](gettingstarted-cookbooks-add-user.md)
+ [Schritt 7: Aktualisieren des Rezeptbuchs, um ein Verzeichnis zu erstellen](gettingstarted-cookbooks-create-directory.md)
+ [Schritt 8: Aktualisieren des Rezeptbuchs, um Dateien zu erstellen und zu kopieren](gettingstarted-cookbooks-create-file.md)
+ [Schritt 9: Aktualisieren des Rezeptbuchs, um einen Befehl auszuführen](gettingstarted-cookbooks-run-command.md)
+ [Schritt 10: Aktualisieren des Rezeptbuchs, um ein Skript auszuführen](gettingstarted-cookbooks-run-script.md)
+ [Schritt 11: Aktualisieren des Rezeptbuchs, um einen Service zu verwalten](gettingstarted-cookbooks-manage-service.md)
+ [Schritt 12: Aktualisieren des Rezeptbuchs, um ein benutzerdefiniertes JSON-Objekt zu verwenden](gettingstarted-cookbooks-custom-json.md)
+ [Schritt 13: Aktualisieren des Rezeptbuchs, um Data Bags zu verwenden](gettingstarted-cookbooks-data-bags.md)
+ [Schritt 14: Aktualisieren des Rezeptbuchs, um Iterationsmethoden zu verwenden](gettingstarted-cookbooks-iteration.md)
+ [Schritt 15: Aktualisieren des Rezeptbuchs, um eine Bedingungslogik zu verwenden](gettingstarted-cookbooks-conditional-logic.md)
+ [Schritt 16: Aktualisieren des Rezeptbuchs, um Community-Rezeptbücher zu verwenden](gettingstarted-cookbooks-community-cookbooks.md)
+ [Schritt 17: (Optional) Bereinigen](gettingstarted-cookbooks-clean-up.md)
+ [Nächste Schritte](gettingstarted-cookbooks-next-steps.md)

# Schritt 1: Erstellen des Rezeptbuchs
<a name="gettingstarted-cookbooks-create-cookbook"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Beginnen Sie, indem Sie ein Rezeptbuch erstellen. Dieses Rezeptbuch ist zunächst recht einfach gehalten, dient aber als Grundlage für den Rest dieser Anleitung.

**Anmerkung**  
In diesem Schritt wird gezeigt, wie Sie ein Rezeptbuch manuell erstellen. Mit dem Chef Development Kit ([Chef DK](https://docs.chef.io/#chef-dk-title)) können Sie Rezeptbücher schneller erstellen, indem Sie den Befehl [https://docs.chef.io/ctl_chef.html#chef-generate-cookbook](https://docs.chef.io/ctl_chef.html#chef-generate-cookbook) auf Ihrer lokalen Workstation ausführen. Dieser Befehl erstellt allerdings mehrere Ordner und Dateien, die Sie für diese Anleitung nicht benötigen.

**So erstellen Sie das Rezeptbuch**

1. Erstellen Sie auf Ihrer lokalen Workstation ein Verzeichnis namens `opsworks_cookbook_demo`. Sie können grundsätzlich auch einen anderen Namen verwenden. Für diese Anleitung sollten Sie aber `opsworks_cookbook_demo` nutzen.

1. Erstellen Sie mithilfe eines Text-Editors im Verzeichnis `opsworks_cookbook_demo` eine Datei mit dem Namen `metadata.rb`. Fügen Sie den folgenden Code ein, um den Namen des Rezeptbuchs festzulegen. Weitere Informationen über `metadata.rb` finden Sie unter [metadata.rb](https://docs.chef.io/config_rb_metadata.html) auf der Chef-Website.

   ```
   name "opsworks_cookbook_demo"
   ```

1. Erstellen Sie in dem Verzeichnis `opsworks_cookbook_demo` ein Unterverzeichnis namens `recipes`. In diesem Unterverzeichnis werden alle Rezepte gespeichert, die Sie für das Rezeptbuch dieser Anleitung erstellen.

1. Erstellen Sie in dem Verzeichnis `recipes` eine Datei namens `default.rb`. Diese Datei enthält ein Rezept mit demselben Namen wie die Datei, allerdings ohne die Dateierweiterung: `default`. Fügen Sie die folgende Codezeile zur Datei `default.rb` hinzu. Dieser Code ist ein Rezept, das nur aus einer Zeile besteht und bei Ausführung eine einfache Nachricht im Protokoll anzeigt:

   ```
   Chef::Log.info("********** Hello, World! **********")
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine Datei mit dem Namen `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen Inhalt enthält. Beispiel:

   ```
   tar -czvf opsworks_cookbook_demo.tar.gz opsworks_cookbook_demo/
   ```

   Sie können grundsätzlich auch einen anderen Dateinamen verwenden. Für diese Anleitung sollten Sie aber `opsworks_cookbook_demo.tar.gz` nutzen.
**Anmerkung**  
Wenn Sie die `tar`-Datei unter Windows erstellt haben, muss das oberste Verzeichnis das übergeordnete Verzeichnis des Rezeptbuchs sein. Diese Anleitung wurde unter Linux mit dem Befehl **tar** getestet, der über das `tar`-Paket bereitgestellt wurde. Für Windows wurde der Befehl **tar** von [Git Bash](https://git-for-windows.github.io/) genutzt. Wenn Sie andere Befehle oder Programme zum Erstellen einer komprimierten TAR-Datei (.tar.gz) nutzen, erhalten Sie möglicherweise nicht das gewünschte Ergebnis.

1. Erstellen Sie einen S3-Bucket oder nutzen Sie einen vorhandenen Bucket. Weitere Informationen finden Sie unter [Bucket erstellen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html).

1. Laden Sie die Datei `opsworks_cookbook_demo.tar.gz` in den S3-Bucket hoch. Weitere Informationen finden Sie unter [Hinzufügen eines Objekts zu einem Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PuttingAnObjectInABucket.html).

Sie verfügen jetzt über ein Rezeptbuch, mit dem Sie im weiteren Verlauf dieser Anleitung arbeiten werden.

Im [nächsten Schritt](gettingstarted-cookbooks-create-stack.md) erstellst du einen OpsWorks Stacks-Stack, den du später verwenden wirst, um dein Kochbuch hochzuladen und die Rezepte des Kochbuches auszuführen.

# Schritt 2: Erstellen des Stacks und dessen Komponenten
<a name="gettingstarted-cookbooks-create-stack"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Erstellen Sie einen OpsWorks Stacks-Stack und seine Komponenten, zu denen eine Ebene und eine Instanz gehören. Später laden Sie zunächst Ihr Rezeptbuch in die Instance hoch und führen dann die Rezepte des Rezeptbuchs auf der Instance aus.

**So erstellen Sie den Stack**

1. [Melden Sie sich bei der OpsWorks Stacks-Konsole unter /opsworks anhttps://console.aws.amazon.com.](https://console.aws.amazon.com/opsworks)

1. Führen Sie einen der folgenden Schritte aus, sofern erforderlich:
   + Wenn die Seite **Willkommen bei OpsWorks Stacks** angezeigt wird, wählen Sie **Add your first stack** oder **Add your first OpsWorks Stacks stack** (beide Optionen bewirken dasselbe). Die Seite **Add stack (Stack hinzufügen)** wird angezeigt.
   + Wenn die **OpsWorks Dashboard-Seite** angezeigt wird, wählen Sie Stapel **hinzufügen**. Die Seite **Add Stack (Stack hinzufügen)** wird angezeigt.

1. Wählen Sie **Chef 12 stack** aus.

1. Geben Sie im Feld **Stack name** den Stack-Namen ein, beispielsweise **MyCookbooksDemoStack**. Sie können grundsätzlich auch einen anderen Namen eingeben. Für diese Anleitung sollten Sie aber `MyCookbooksDemoStack` nutzen.

1. Wählen Sie für **Region** die Option **US West (Oregon)** aus.

1. Führen Sie für **VPC** einen der folgenden Schritte aus:
   + Wählen Sie eine VPC aus, falls verfügbar. Weitere Informationen finden Sie unter [Ausführen eines Stacks in einer VPC](workingstacks-vpc.md).
   + Wählen Sie andernfalls **No VPC (Keine VPC)** aus.

1. Bestätigen Sie die Option **Use custom Chef cookbooks (Benutzerdefinierte Chef-Rezeptbücher verwenden)** mit **Yes**.

1. Wählen Sie für **Repository type** die Option **S3 Archive** aus.
**Anmerkung**  
In der Anleitung [Erste Schritte: Linux](gettingstarted-linux.md) haben Sie an dieser Stelle **HTTP Archive** ausgewählt. Wählen Sie hier stattdessen **S3 Archive** aus.

1. Geben Sie für **Repository URL** den Speicherort zur Datei `opsworks_cookbook_demo.tar.gz` in S3 an. Um den Pfad zu erhalten, wählen Sie in der S3-Konsole die Datei `opsworks_cookbook_demo.tar.gz` aus. Kopieren Sie im Bereich **Properties (Eigenschaften)** den Wert des Felds **Link**. (Es sollte dem Folgenden ähneln: `https://s3.amazonaws.com/amzn-s3-demo-bucket/opsworks_cookbook_demo.tar.gz`.)

1. Wenn Ihr S3-Bucket privat ist, was die Standardeinstellung ist, geben Sie für **Access Key ID** und **Secret Access Key** die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel des IAM-Benutzers ein, den Sie für diese exemplarische Vorgehensweise verwenden. Weitere Informationen finden Sie unter [Bearbeiten von Objektberechtigungen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/EditingPermissionsonanObject.html) und [Ein Objekt mit anderen teilen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html).

1. Übernehmen Sie die Standardeinstellungen für die folgenden Schritte:
   + **Default Availability Zone** (**us-west-2a**)
   + **Standardbetriebssystem** (**Linux** und **Amazon Linux 2016.09**)
   + **Default SSH key** (**Do not use a default SSH key**)
   + **Stack color** (dark blue)

1. Wählen Sie **Erweitert** aus.

1. Führen Sie für **IAM role (IAM-Rolle)** einen der folgenden Schritte aus:
   + Wählen Sie **aws-opsworks-service-role** aus, sofern verfügbar.
   + Falls **aws-opsworks-service-role**nicht verfügbar, wählen Sie **Neue IAM-Rolle**.

1. Führen Sie für das **Standard-IAM-Instanzprofil** einen der folgenden Schritte aus:
   + Wenn **aws-opsworks-ec2 Rollen** verfügbar sind, wählen Sie sie aus.
   + Wenn **aws-opsworks-ec2 Rollen** nicht verfügbar sind, wählen Sie **Neues IAM-Instanzprofil** aus.

1. Übernehmen Sie die Standardeinstellungen für die folgenden Schritte:
   + **Default root device type** (**EBS backed**)
   + **Hostname theme** (**Layer Dependent**)
   + **OpsWorks Agentenversion (neueste Version**)
   + **Custom Chef JSON** (leer)
   + **Sicherheit**, ** OpsWorks Sicherheitsgruppen verwenden** (**Ja**)

1. Wählen Sie **Stack hinzufügen**. OpsWorks Stacks erstellt den Stapel und zeigt die **MyCookbooksDemoStack**Seite an.

**So erstellen Sie den Layer:**

1. Wählen Sie im Service-Navigationsbereich **Layers** aus. Die Seite **Layers** wird angezeigt. 

1. Wählen Sie **Add a layer (Layer hinzufügen)** aus.

1. Geben **MyCookbooksDemoLayer** Sie auf der **OpsWorks**Registerkarte als **Name** den Text ein. Sie können grundsätzlich auch einen anderen Namen eingeben. Für diese Anleitung sollten Sie aber `MyCookbooksDemoLayer` nutzen.

1. Geben Sie für **Short name** **cookbooks-demo** ein. Sie können grundsätzlich auch einen anderen Namen eingeben. Für diese Anleitung sollten Sie aber `cookbooks-demo` nutzen.

1. Wählen Sie **Ebene hinzufügen aus**. OpsWorks Stacks fügt die Ebene hinzu und zeigt die Seite „**Ebenen**“ an.

**So erstellen und starten Sie eine Instance:**

1. Wählen Sie im Service-Navigationsbereich **Instances** aus. Die Seite **Instances** wird angezeigt.

1. Wählen Sie **Add an instance (Instance hinzufügen)** aus.

1. Wählen Sie auf der Registerkarte **New (Neu)** die Option **Advanced (Erweitert)** aus. 

1. Übernehmen Sie die Standardeinstellungen für die folgenden Schritte:
   + **Hostname** (**cookbooks-demo1**)
   + **Size** (**c3.large**)
   + **Subnetz (us-west-2a****) *IP address***
   + **Scaling type** (**24/7**)
   + **SSH key** (**Do not use a default SSH key**)
   + **Betriebssystem** (**Amazon Linux 2016.09**)
   + **OpsWorks Agentenversion (vom** Stack **erben**)
   + **Tenancy** (**Default - Rely on VPC settings**)
   + **Root device type** (**EBS backed**)
   + **Volume type** (**General Purpose (SSD)**)
   + **Volume size** (**8**)

1. Wählen Sie **Add instance (Instance hinzufügen)** aus.

1. ****Für **MyCookbooksDemoLayer**, für **cookbooks-demo1**, für Actions wählen Sie Start.**** Fahren Sie nicht fort, bevor der **Status** zu **online** wechselt. Dieser Vorgang kann einige Minuten dauern. Haben Sie etwas Geduld.

Sie haben nun einen Stack, einen Layer und eine Instance, zu der das Rezeptbuch automatisch aus Ihrem S3-Bucket kopiert wurde. Im [nächsten Schritt](gettingstarted-cookbooks-test-recipe.md) führen Sie das Standardrezept aus dem Rezeptbuch auf der Instance aus und testen es.

# Schritt 3: Ausführen und Testen des Rezepts
<a name="gettingstarted-cookbooks-test-recipe"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Führen Sie das `default` Rezept aus dem Kochbuch aus, das OpsWorks Stacks in die Instanz kopiert hat, und testen Sie es. Wie Sie sich sicherlich erinnern, besteht dieses Rezept aus einer einzelnen Zeile und zeigt eine einfache Nachricht im Protokoll an, wenn es ausgeführt wird.

**So führen Sie das Rezept aus**

1. Wählen Sie im Service-Navigationsbereich **Stack** aus. Die Seite **MyCookbooksDemoStack** wird angezeigt.

1. Wählen Sie **Run Command (Befehl ausführen)** aus. Die Seite **Run Command (Befehl ausführen)** wird angezeigt.

1. Wählen Sie für **Command (Befehl)** die Option **Execute Recipes (Rezepte ausführen)** aus.

1. Geben Sie für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::default** ein.

   **opsworks\$1cookbook\$1demo** ist der Name des Rezeptbuchs, der in der Datei `metadata.rb` festgelegt ist. **default** ist der Name des auszuführenden Rezepts, also der Name der Datei `default.rb` im Unterverzeichnis `recipes` des Rezeptbuchs ohne Dateierweiterung.

1. Lassen Sie die folgenden Standardeinstellungen unverändert:
   + **Comment (Kommentar)** (leer)
   + **Advanced**, **Custom Chef JSON** (leer)
   + **Instanzen** (**Alle ausgewählt**, markiert, **MyCookbooksDemoLayer****cookbooks-demo1** aktiviert)

1. Wählen Sie **Execute Recipes (Rezepte ausführen)** aus. Die Seite **Running command execute\$1recipes (Befehl execute\$1recipes wird ausgeführt)** wird angezeigt. Fahren Sie nicht fort, bevor der **Status** zu **successful (erfolgreich)** wechselt. Dieser Vorgang kann einige Minuten dauern. Haben Sie etwas Geduld.

**So prüfen Sie die Rezeptergebnisse:**

1. Wählen Sie bei geöffneter Seite **Running command execute\$1recipes** für **cookbooks-demo1** und **Log** die Option **show (anzeigen)** aus. Die Protokollseite **execute\$1recipes** wird angezeigt.

1. Führen Sie im Protokoll einen Bildlauf nach unten durch und suchen Sie einen Eintrag, der dem folgenden ähnelt:

   ```
   [2015-11-13T19:14:39+00:00] INFO: ********** Hello, World! **********
   ```

Sie haben Ihr erstes Rezept erfolgreich ausgeführt\$1 Im [nächsten Schritt](gettingstarted-cookbooks-install-package.md)aktualisieren Sie Ihr Rezeptbuch durch Hinzufügen eines Rezepts, das ein Paket auf der Instance installiert.

# Schritt 4: Aktualisieren des Rezeptbuchs zum Installieren eines Pakets
<a name="gettingstarted-cookbooks-install-package"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das auf der Instance ein Paket installiert, das den beliebten Texteditor GNU Emacs enthält.

Sie können sich zwar genauso einfach bei der Instanz anmelden und das Paket einmal installieren, aber wenn Sie ein Rezept schreiben, können Sie das Rezept einmal von OpsWorks Stacks aus ausführen, um mehrere Pakete auf mehreren Instanzen in einem Stack gleichzeitig zu installieren. 

**So aktualisieren Sie das Rezeptbuch zum Installieren eines Pakets:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `install_package.rb` mit dem folgenden Code: 

   ```
   package "Install Emacs" do
     package_name "emacs"
   end
   ```

   Dieses Rezept installiert das `emacs`-Paket auf der Instance. (Weitere Informationen finden Sie unter [package](https://docs.chef.io/resource_package.html).)
**Anmerkung**  
Sie können dem Rezept einen beliebigen Dateinamen geben. Achten Sie nur darauf, den richtigen Rezeptnamen anzugeben, wann immer OpsWorks Stacks das Rezept ausführen soll.

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

Dieses neue Rezept wird ausgeführt, wenn Sie das Rezeptbuch auf der Instance aktualisieren und anschließend das neue Rezept aus dem aktualisierten Rezeptbuch ausführen. Der nächste Schritt beschreibt die notwendige Vorgehensweise. 

Nachdem Sie den [nächsten Schritt](gettingstarted-cookbooks-copy-cookbook.md) abgeschlossen haben, können Sie sich bei der Instance anmelden und an der Eingabeaufforderung **emacs** eingeben, um GNU Emacs zu starten. (Weitere Informationen finden Sie unter [Verbinden Sie sich mit der Linux-Instanz](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html).) Zum Beenden von GNU Emacs drücken Sie **STRG\$1X** und anschließend **STRG\$1C**.

**Wichtig**  
Um sich bei der Instanz anzumelden, müssen Sie OpsWorks Stacks zunächst Informationen über Ihren öffentlichen SSH-Schlüssel zur Verfügung stellen (den Sie mit Tools wie ssh-keygen oder Pu erstellen könnenTTYgen). Anschließend müssen Sie Berechtigungen für den `MyCookbooksDemoStack` Stack festlegen, damit sich Ihr Benutzer bei der Instanz anmelden kann. Anweisungen finden Sie unter [Registrierung des öffentlichen SSH-Schlüssels eines Benutzers](security-settingsshkey.md) und [Anmelden mit SSH](workinginstances-ssh.md).

# Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts
<a name="gettingstarted-cookbooks-copy-cookbook"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst hat am 26. Mai 2024 das Ende seiner Nutzungsdauer 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie das Rezeptbuch auf der Instance und führen Sie das Rezept aus dem aktualisierten Rezeptbuch auf der Instance aus. Im weiteren Verlauf dieser Anleitung werden Sie diesen Schritt immer dann wiederholen, wenn Sie das Rezeptbuch durch Hinzufügen eines neuen Rezepts aktualisieren.

**So aktualisieren Sie das Rezeptbuch auf der Instance:**

1. Wählen Sie im Service-Navigationsbereich **Stack** aus. Die Seite **MyCookbooksDemoStack** wird angezeigt.

1. Wählen Sie **Run Command (Befehl ausführen)** aus. Die Seite **Run Command (Befehl ausführen)** wird angezeigt.

1. Wählen Sie für **Command (Befehl)** **Update Custom Cookbooks (Benutzerdefinierte Rezeptbücher aktualisieren)** aus.

1. Lassen Sie die folgenden Standardeinstellungen unverändert:
   + **Comment (Kommentar)** (leer)
   + **Advanced**, **Custom Chef JSON** (leer)
   + **Erweitert**, **Instanzen** (**Alle auswählen** aktiviert, aktiviert, **MyCookbooksDemoLayer****cookbooks-demo1** aktiviert)

1. Wählen Sie **Update Custom Cookbooks (Benutzerdefinierte Rezeptbücher aktualisieren)** aus. Die Seite **Running command update\$1custom\$1cookbooks (Befehl update\$1custom\$1cookbooks wird ausgeführt)** wird angezeigt. Fahren Sie nicht fort, bevor der **Status** zu **successful (erfolgreich)** wechselt. Dieser Vorgang kann einige Minuten dauern. Haben Sie etwas Geduld.

**So führen Sie das Rezept aus**

1. Wählen Sie im Service-Navigationsbereich **Stack** aus. Die Seite **MyCookbooksDemoStack** wird angezeigt.

1. Wählen Sie **Run Command (Befehl ausführen)** aus. Die Seite **Run Command (Befehl ausführen)** wird angezeigt.

1. Wählen Sie für **Command (Befehl)** die Option **Execute Recipes (Rezepte ausführen)** aus.

1. Geben Sie für **Recipes to execute** den Namen des auszuführenden Rezepts an. Beim ersten Mal hat das Rezept die Bezeichnung **opsworks\$1cookbook\$1demo::install\$1package**.
**Anmerkung**  
Wenn Sie dieses Verfahren wiederholen, geben Sie den Namen des Rezeptbuchs (**opsworks\$1cookbook\$1demo**), gefolgt von zwei Doppelpunkten (**::**), gefolgt vom Namen des Rezepts (der Dateiname des Rezepts ohne die Dateierweiterung `.rb`) ein.

1. Lassen Sie die folgenden Standardeinstellungen unverändert:
   + **Comment (Kommentar)** (leer)
   + **Advanced**, **Custom Chef JSON** (leer)
   + **Instanzen** ****Alle auswählen** (aktiviert, markiert, cookbooks-demo1 **MyCookbooksDemoLayer**aktiviert)**

1. Wählen Sie **Execute Recipes (Rezepte ausführen)** aus. Die Seite **Running command execute\$1recipes (Befehl execute\$1recipes wird ausgeführt)** wird angezeigt. Fahren Sie nicht fort, bevor der **Status** zu **successful (erfolgreich)** wechselt. Dieser Vorgang kann einige Minuten dauern. Haben Sie etwas Geduld.

**Anmerkung**  
Sie müssen Rezepte nicht manuell ausführen. Sie können den Lebenszyklusereignissen einer Ebene Rezepte zuweisen, z. B. den Ereignissen Setup und Configure, und OpsWorks Stacks führt diese Rezepte automatisch aus, wenn das Ereignis eintritt. Weitere Informationen finden Sie unter [OpsWorks Stapelt Lifecycle-Ereignisse](workingcookbook-events.md).

Im [nächsten Schritt](gettingstarted-cookbooks-add-user.md) aktualisieren Sie das Rezeptbuch, um einen Benutzer zur Instance hinzuzufügen.

# Schritt 6: Aktualisieren des Rezeptbuchs zum Hinzufügen eines Benutzers
<a name="gettingstarted-cookbooks-add-user"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das einen lokalen Benutzer zur Instance hinzufügt und das Stammverzeichnis und die Shell für den Benutzer festlegt. Dies ähnelt der Ausführung der Linux-Befehle **adduser** bzw. **useradd** oder des Windows-Befehls **net user**. Sie fügen beispielsweise einen lokalen Benutzer zu einer Instance hinzu, wenn Sie den Zugriff auf die Dateien und Verzeichnisse der Instance steuern möchten.

Sie können Benutzer auch ohne Rezeptbücher verwalten. Weitere Informationen finden Sie unter [Verwalten von Benutzern](opsworks-security-users-manage.md).

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `add_user.rb` mit dem folgenden Code (weitere Informationen finden Sie unter [user](https://docs.chef.io/resource_user.html)): 

   ```
   user "Add a user" do
     home "/home/jdoe"
     shell "/bin/bash"
     username "jdoe"  
   end
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::add\$1user** ein.

**So testen Sie das Rezept:**

1. Melden Sie sich bei der Instance an, sofern Sie noch nicht angemeldet sind.

1. Führen Sie an der Eingabeaufforderung den folgenden Befehl aus, um das Hinzufügen des neuen Benutzers zu bestätigen:

   ```
   grep jdoe /etc/passwd
   ```

   Es werden Informationen ähnlich der folgenden zum Benutzer angezeigt, einschließlich Details wie Benutzername, ID-Nummer, Gruppen-ID-Nummer, Stammverzeichnis und Shell:

   ```
   jdoe:x:501:502::/home/jdoe:/bin/bash
   ```

Im [nächsten Schritt](gettingstarted-cookbooks-create-directory.md) aktualisieren Sie das Rezeptbuch, um ein Verzeichnis auf der Instance anzulegen.

# Schritt 7: Aktualisieren des Rezeptbuchs, um ein Verzeichnis zu erstellen
<a name="gettingstarted-cookbooks-create-directory"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das ein Verzeichnis zur Instance hinzufügt. Dies ähnelt der Ausführung des Linux-Befehls **mkdir** oder der Windows-Befehle **md** bzw. **mkdir** .

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `create_directory.rb` mit dem folgenden Code. Weitere Informationen finden Sie unter [directory](https://docs.chef.io/resource_directory.html): 

   ```
   directory "Create a directory" do
     group "root"
     mode "0755"
     owner "ec2-user"
     path "/tmp/create-directory-demo"  
   end
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::create\$1directory** ein.

**So testen Sie das Rezept:**

1. Melden Sie sich bei der Instance an, sofern Sie noch nicht angemeldet sind.

1. Führen Sie an der Eingabeaufforderung den folgenden Befehl aus, um das Hinzufügen des neuen Verzeichnisses zu bestätigen:

   ```
   ls -la /tmp/create-directory-demo
   ```

   Es werden Informationen zum neu hinzugefügten Verzeichnis angezeigt, einschließlich Daten zu Berechtigungen, Besitzername und Gruppenname: 

   ```
   drwxr-xr-x 2 ec2-user root 4096 Nov 18 00:35 .
   drwxrwxrwt 6 root     root 4096 Nov 24 18:17 ..
   ```

Im [nächsten Schritt](gettingstarted-cookbooks-create-file.md) aktualisieren Sie das Rezeptbuch, um eine Datei auf der Instance zu erstellen.

# Schritt 8: Aktualisieren des Rezeptbuchs, um Dateien zu erstellen und zu kopieren
<a name="gettingstarted-cookbooks-create-file"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das zwei Dateien zur Instance hinzufügt. Die erste Ressource des Rezepts erstellt eine Datei vollständig mit Rezeptcode. Dies ähnelt der Ausführung der Linux-Befehle **cat**, **echo** bzw. **touch** oder der Windows-Befehle **echo** bzw. **fsutil**. Die Methode eignet sich, wenn Sie wenige, kleine oder einfache Dateien haben. Die zweite Ressource des Rezepts kopiert eine Datei aus dem Rezeptbuch in ein anderes Verzeichnis der Instance. Dies ähnelt der Ausführung des Linux-Befehls **cp** oder des Windows-Befehls **copy**. Diese Methode eignet sich, wenn Sie viele, große oder komplexe Dateien haben.

Schließen Sie [Schritt 7: Aktualisieren des Rezeptbuchs, um ein Verzeichnis zu erstellen](gettingstarted-cookbooks-create-directory.md) ab, um sicherzustellen, dass das übergeordnete Verzeichnis der Dateien bereits vorhanden ist, ehe Sie diesen Schritt durchführen.

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Verzeichnis `opsworks_cookbook_demo` ein Unterverzeichnis namens `files`. 

1. Erstellen Sie im Unterverzeichnis `files` eine Datei mit dem Name `hello.txt` und dem folgenden Text: **Hello, World\$1** 

1. Erstellen Sie im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `create_files.rb` mit dem folgenden Code. Weitere Informationen finden Sie unter [file](https://docs.chef.io/resource_file.html) und [cookbook\$1file](https://docs.chef.io/resource_cookbook_file.html).

   ```
   file "Create a file" do
     content "<html>This is a placeholder for the home page.</html>"
     group "root"
     mode "0755"
     owner "ec2-user"
     path "/tmp/create-directory-demo/index.html"
   end
   
   cookbook_file "Copy a file" do  
     group "root"
     mode "0755"
     owner "ec2-user"
     path "/tmp/create-directory-demo/hello.txt"
     source "hello.txt"  
   end
   ```

   Die `file`-Ressource erstellt eine Datei im angegebenen Pfad. Die `cookbook_file`-Ressource kopiert die Datei aus dem Verzeichnis `files`, das Sie gerade im Rezeptbuch erstellt haben, in ein anderes Verzeichnis auf der Instance (Chef erwartet ein Unterverzeichnis mit dem Standardnamen `files`, aus dem Dateien kopiert werden).

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::create\$1files** ein.

**So testen Sie das Rezept:**

1. Melden Sie sich bei der Instance an, sofern Sie noch nicht angemeldet sind.

1. Führen Sie an der Eingabeaufforderung nacheinander die folgenden Befehle aus, um das Hinzufügen der neuen Dateien zu bestätigen:

   ```
   sudo cat /tmp/create-directory-demo/index.html
   
   sudo cat /tmp/create-directory-demo/hello.txt
   ```

   Der Inhalt der Datei wird angezeigt:

   ```
   <html>This is a placeholder for the home page.</html>
   
   Hello, World!
   ```

Im [nächsten Schritt](gettingstarted-cookbooks-run-command.md) aktualisieren Sie das Rezeptbuch, um einen Befehl auf der Instance auszuführen.

# Schritt 9: Aktualisieren des Rezeptbuchs, um einen Befehl auszuführen
<a name="gettingstarted-cookbooks-run-command"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das einen Befehl ausführt, der einen SSH-Schlüssel auf der Instance erstellt. 

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `run_command.rb` mit dem folgenden Code. Weitere Informationen finden Sie unter [execute](https://docs.chef.io/resource_execute.html).

   ```
   execute "Create an SSH key" do
     command "ssh-keygen -f /tmp/my-key -N fLyC3jbY"
   end
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::run\$1command** ein.

**So testen Sie das Rezept:**

1. Melden Sie sich bei der Instance an, sofern Sie noch nicht angemeldet sind.

1. Führen Sie an der Eingabeaufforderung nacheinander die folgenden Befehle aus, um das Erstellen des SSH-Schlüssels zu bestätigen:

   ```
   sudo cat /tmp/my-key
   
   sudo cat /tmp/my-key.pub
   ```

   Der Inhalt der privaten und öffentlichen SSH-Schlüssel wird angezeigt:

   ```
   -----BEGIN RSA PRIVATE KEY-----
   Proc-Type: 4,ENCRYPTED
   DEK-Info: AES-128-CBC,DEF7A09C...541583FA
   A5p9dCuo...wp0YYH1c
   -----END RSA PRIVATE KEY-----
   
   ssh-rsa AAAAB3N...KaNogZkT root@cookbooks-demo1
   ```

Im [nächsten Schritt](gettingstarted-cookbooks-run-script.md) aktualisieren Sie das Rezeptbuch, um ein Skript auf der Instance auszuführen.

# Schritt 10: Aktualisieren des Rezeptbuchs, um ein Skript auszuführen
<a name="gettingstarted-cookbooks-run-script"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das ein Skript auf der Instance ausführt. Dieses Rezept erstellt ein Verzeichnis und eine Datei in diesem Verzeichnis. Das Schreiben eines Rezepts zum Ausführen eines Skripts, das mehrere Befehle enthält, ist einfacher als das Ausführen der Befehle nacheinander.

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `run_script.rb` mit dem folgenden Code. Weitere Informationen finden Sie unter [script](https://docs.chef.io/resource_script.html). 

   ```
   script "Run a script" do
     interpreter "bash"
     code <<-EOH
       mkdir -m 777 /tmp/run-script-demo
       touch /tmp/run-script-demo/helloworld.txt
       echo "Hello, World!" > /tmp/run-script-demo/helloworld.txt
     EOH
   end
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::run\$1script** ein.

**So testen Sie das Rezept:**

1. Melden Sie sich bei der Instance an, sofern Sie noch nicht angemeldet sind.

1. Führen Sie an der Eingabeaufforderung den folgenden Befehl aus, um das Hinzufügen der neuen Datei zu bestätigen:

   ```
   sudo cat /tmp/run-script-demo/helloworld.txt
   ```

   Der Inhalt der Datei wird angezeigt:

   ```
   Hello, World!
   ```

Im [nächsten Schritt](gettingstarted-cookbooks-manage-service.md) aktualisieren Sie das Rezeptbuch, um einen Service auf der Instance zu verwalten.

# Schritt 11: Aktualisieren des Rezeptbuchs, um einen Service zu verwalten
<a name="gettingstarted-cookbooks-manage-service"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das einen Service auf der Instance verwaltet. Dies ähnelt der Ausführung des Linux-Befehls **service** oder der Windows-Befehle **net stop**, **net start** und ähnlicher Befehle. Dieses Rezept stoppt den **crond**-Service auf der Instance.

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `manage_service.rb` mit dem folgenden Code. Weitere Informationen finden Sie unter [service](https://docs.chef.io/resource_service.html). 

   ```
   service "Manage a service" do
     action :stop
     service_name "crond"  
   end
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::manage\$1service** ein.

**So testen Sie das Rezept:**

1. Melden Sie sich bei der Instance an, sofern Sie noch nicht angemeldet sind.

1. Führen Sie an der Eingabeaufforderung den folgenden Befehl aus, um zu überprüfen, dass der **crond**-Service gestoppt wurde:

   ```
   service crond status
   ```

   Folgendes wird angezeigt:

   ```
   crond is stopped
   ```

1. Für einen Neustart des **crond**-Services führen Sie den folgenden Befehl aus:

   ```
   sudo service crond start
   ```

   Folgendes wird angezeigt:

   ```
   Starting crond:  [  OK  ]
   ```

1.  Zur Überprüfung, dass der **crond**-Service gestartet wurde, führen Sie den folgenden Befehl erneut aus:

   ```
   service crond status
   ```

   Es werden Informationen angezeigt, die den folgenden ähneln:

   ```
   crond (pid  3917) is running...
   ```

Im [nächsten Schritt](gettingstarted-cookbooks-custom-json.md) aktualisieren Sie das Rezeptbuch, um auf Informationen zu verweisen, die als ein benutzerdefiniertes JSON-Objekt auf der Instance gespeichert sind.

# Schritt 12: Aktualisieren des Rezeptbuchs, um ein benutzerdefiniertes JSON-Objekt zu verwenden
<a name="gettingstarted-cookbooks-custom-json"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst hat am 26. Mai 2024 das Ende seiner Nutzungsdauer 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das auf ein benutzerdefiniertes JSON-Objekt verweist, die auf der Instance gespeichert ist.

Sie können Informationen in einer benutzerdefinierten JSON angeben, wenn Sie einen Stack erstellen, aktualisieren oder klonen oder wenn Sie eine Bereitstellung oder einen Stack-Befehl ausführen. Dies ist hilfreich, wenn Sie beispielsweise eine kleinen, unveränderlichen Teil an Daten für Ihre Rezepte auf der Instance zur Verfügung stellen, anstatt diese Daten aus einer Datenbank abzurufen. Weitere Informationen finden Sie unter [Nutzen eines benutzerdefinierten JSON-Objekts](workingstacks-json.md). 

In dieser Anleitung nutzen Sie eine benutzerdefinierte JSON, um fiktive Informationen zu einer Kundenrechnung bereitzustellen. Das benutzerdefinierte JSON-Objekt wird später in diesem Schritt beschrieben.

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `custom_json.rb`, die den folgenden Rezeptcode enthält: 

   ```
   Chef::Log.info("********** For customer '#{node['customer-id']}' invoice '#{node['invoice-number']}' **********")
   Chef::Log.info("********** Invoice line number 1 is a '#{node['line-items']['line-1']}' **********")
   Chef::Log.info("********** Invoice line number 2 is a '#{node['line-items']['line-2']}' **********")
   Chef::Log.info("********** Invoice line number 3 is a '#{node['line-items']['line-3']}' **********")
   ```

   Dieses Rezept zeigt Meldungen zu den Werten in der benutzerdefinierten JSON in einem Protokoll an.

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::custom\$1json** ein. Geben Sie für **Advanced (Erweitert)**, **Custom Chef JSON (Benutzerdefiniertes Chef-JSON-Objekt)**, das folgende benutzerdefinierte JSON-Objekt ein:

   ```
   {
     "customer-id": "0123",
     "invoice-number": "9876",
     "line-items": {
       "line-1": "tractor",
       "line-2": "passenger car",
       "line-3": "trailer"
     }
   }
   ```

**So testen Sie das Rezept:**

1. Wählen Sie , während die Seite **Running command execute\$1recipes (Befehl execute\$1recipes wird ausgeführt)** noch geöffnet ist, für **cookbooks-demo1** und **Log** die Option **show (anzeigen)** aus. Die Protokollseite **execute\$1recipes** wird angezeigt.

1. Führen Sie im Protokoll einen Bildlauf nach unten durch, um die Einträge zu finden, die den folgenden ähneln:

   ```
   [2015-11-14T14:18:30+00:00] INFO: ********** For customer '0123' invoice '9876' **********
   [2015-11-14T14:18:30+00:00] INFO: ********** Invoice line number 1 is a 'tractor' **********
   [2015-11-14T14:18:30+00:00] INFO: ********** Invoice line number 2 is a 'passenger car' **********
   [2015-11-14T14:18:30+00:00] INFO: ********** Invoice line number 3 is a 'trailer' **********
   ```

   Diese Einträge zeigen Informationen des benutzerdefinierten JSON-Objekts an, die im Feld **Advanced**, **Custom Chef JSON** eingegeben wurden.

Im [nächsten Schritt](gettingstarted-cookbooks-data-bags.md) aktualisierst du das Kochbuch, um Informationen aus Datenbeuteln zu erhalten. Dabei handelt es sich um Sammlungen von Stack-Einstellungen, die OpsWorks Stacks für jede Instanz speichert.

# Schritt 13: Aktualisieren des Rezeptbuchs, um Data Bags zu verwenden
<a name="gettingstarted-cookbooks-data-bags"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst hat am 26. Mai 2024 das Ende seiner Nutzungsdauer 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisiere dein Kochbuch, indem du ein Rezept hinzufügst, das auf die Stack-Einstellungen verweist, die OpsWorks Stacks auf der Instanz in einer Reihe von Datenbeuteln speichert. Dieses Rezept zeigt im Protokoll Meldungen zu bestimmten auf der Instance gespeicherten Stack-Einstellungen an. Weitere Informationen hierzu finden Sie unter [OpsWorks Referenz für Stacks Data Bag](data-bags.md).

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `data_bags.rb`, die den folgenden Code enthält: 

   ```
   instance = search("aws_opsworks_instance").first
   layer = search("aws_opsworks_layer").first
   stack = search("aws_opsworks_stack").first
   
   Chef::Log.info("********** This instance's instance ID is '#{instance['instance_id']}' **********")
   Chef::Log.info("********** This instance's public IP address is '#{instance['public_ip']}' **********")
   Chef::Log.info("********** This instance belongs to the layer '#{layer['name']}' **********")
   Chef::Log.info("********** This instance belongs to the stack '#{stack['name']}' **********")
   Chef::Log.info("********** This stack gets its cookbooks from '#{stack['custom_cookbooks_source']['url']}' **********")
   ```

   Dieses Rezept zeigt im Protokoll Meldungen zu bestimmten auf der Instance gespeicherten Stack-Einstellungen an.

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::data\$1bags** ein. 

**So testen Sie das Rezept:**

1. Wählen Sie, während die Seite **Running command execute\$1recipes (Befehl execute\$1recipes wird ausgeführt)** noch geöffnet ist, für **cookbooks-demo1** und **Log** die Option **show (anzeigen)** aus. Die Protokollseite **execute\$1recipes** wird angezeigt.

1. Führen Sie im Protokoll einen Bildlauf nach unten durch, um die Einträge zu finden, die den folgenden ähneln:

   ```
   [2015-11-14T14:39:06+00:00] INFO: ********** This instance's instance ID is 'f80fa119-81ab-4c3c-883d-6028e52c89EX' **********
   [2015-11-14T14:39:06+00:00] INFO: ********** This instance's public IP address is '192.0.2.0' **********
   [2015-11-14T14:39:06+00:00] INFO: ********** This instance belongs to the layer 'MyCookbooksDemoLayer' **********
   [2015-11-14T14:39:06+00:00] INFO: ********** This instance belongs to the stack 'MyCookbooksDemoStack' **********
   [2015-11-14T14:39:06+00:00] INFO: ********** This stack gets its cookbooks from 'https://s3.amazonaws.com/amzn-s3-demo-bucket/opsworks_cookbook_demo.tar.gz' **********
   ```

   Dieses Rezept zeigt Meldungen zu bestimmten auf der Instance gespeicherten Stack-Einstellungen an.

Im [nächsten Schritt](gettingstarted-cookbooks-iteration.md) aktualisieren Sie das Rezeptbuch, um einen Rezeptcode mehrmals auszuführen.

# Schritt 14: Aktualisieren des Rezeptbuchs, um Iterationsmethoden zu verwenden
<a name="gettingstarted-cookbooks-iteration"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das eine *Iteration* einsetzt. Bei dieser Methode wird der Rezeptcode mehrmals wiederholt. Das Rezept zeigt im Protokoll Meldungen zu einem Data Bag-Element an, das verschiedene Inhalte aufweist. 

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `iteration_demo.rb`, die den folgenden Code enthält:

   ```
   stack = search("aws_opsworks_stack").first
   Chef::Log.info("********** Content of 'custom_cookbooks_source' **********")
   
   stack["custom_cookbooks_source"].each do |content|
     Chef::Log.info("********** '#{content}' **********")
   end
   ```
**Anmerkung**  
Das Schreiben des vorherigen Rezepts geht schneller, ist flexibler und weniger fehleranfällig als das Schreiben des folgenden Rezeptcodes, bei dem keine Iterationsmethoden verwendet werden:  

   ```
   stack = search("aws_opsworks_stack").first
   Chef::Log.info("********** Content of 'custom_cookbooks_source' **********")
   
   Chef::Log::info("********** '[\"type\", \"#{stack['custom_cookbooks_source']['type']}\"]' **********")
   Chef::Log::info("********** '[\"url\", \"#{stack['custom_cookbooks_source']['url']}\"]' **********")
   Chef::Log::info("********** '[\"username\", \"#{stack['custom_cookbooks_source']['username']}\"]' **********")
   Chef::Log::info("********** '[\"password\", \"#{stack['custom_cookbooks_source']['password']}\"]' **********")
   Chef::Log::info("********** '[\"ssh_key\", \"#{stack['custom_cookbooks_source']['ssh_key']}\"]' **********")
   Chef::Log::info("********** '[\"revision\", \"#{stack['custom_cookbooks_source']['revision']}\"]' **********")
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::iteration\$1demo** ein. 

**So testen Sie das Rezept:**

1. Wählen Sie , während die Seite **Running command execute\$1recipes (Befehl execute\$1recipes wird ausgeführt)** noch geöffnet ist, für **cookbooks-demo1** und **Log** die Option **show (anzeigen)** aus. Die Protokollseite **execute\$1recipes** wird angezeigt.

1. Führen Sie im Protokoll einen Bildlauf nach unten durch, um die Einträge zu finden, die den folgenden ähneln:

   ```
   [2015-11-16T19:56:56+00:00] INFO: ********** Content of 'custom_cookbooks_source' **********
   [2015-11-16T19:56:56+00:00] INFO: ********** '["type", "s3"]' **********
   [2015-11-16T19:56:56+00:00] INFO: ********** '["url", "https://s3.amazonaws.com/amzn-s3-demo-bucket/opsworks_cookbook_demo.tar.gz"]' **********
   [2015-11-16T19:56:56+00:00] INFO: ********** '["username", "secret-key-value"]' **********
   [2015-11-16T19:56:56+00:00] INFO: ********** '["password", "secret-access-key-value"]' **********
   [2015-11-16T19:56:56+00:00] INFO: ********** '["ssh_key", nil]' **********
   [2015-11-16T19:56:56+00:00] INFO: ********** '["revision", nil]' **********
   ```

   Das Rezept zeigt im Protokoll Meldungen zu einem Data Bag-Element an, das verschiedene Inhalte aufweist. Das Data Bag-Element befindet sich im `aws_opsworks_stack`-Data Bag. Das Data Bag-Element hat einen Inhalt namens `custom_cookbooks_source`. Der Inhalt ist in sechs Inhalte mit den Bezeichnungen `type`, `url``username`, `password`, `ssh_key` und `revision` unterteilt, dessen Werte ebenfalls angezeigt werden.

Im [nächsten Schritt](gettingstarted-cookbooks-conditional-logic.md) aktualisieren Sie das Rezeptbuch, so dass ein Rezeptcode nur ausgeführt wird, wenn bestimmte Bedingungen erfüllt sind.

# Schritt 15: Aktualisieren des Rezeptbuchs, um eine Bedingungslogik zu verwenden
<a name="gettingstarted-cookbooks-conditional-logic"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie jetzt Ihr Rezeptbuch, indem Sie ein Rezept hinzufügen, das eine *Bedingungslogik* verwendet. Bei dieser Methode wird der Code nur ausgeführt, wenn bestimmte Bedingungen erfüllt sind. Weitere Informationen finden Sie unter [if Statements](https://docs.chef.io/dsl_recipe.html#if-statements) und [case Statements](https://docs.chef.io/dsl_recipe.html#case-statements).

Je nach Data Bag-Inhalt ermöglicht dieses Rezept Folgendes: Es zeigt eine Meldung im Protokoll zur Identifizierung des Betriebssystems an, auf dem die Instance ausgeführt wird. Zudem installiert es ein Paket mit dem richtigen Paket-Manager für die vorhandene Linux-Verteilung. Dieses Paket erhält den Namen tree. Es ist eine einfache Anwendung zum Visualisieren von Verzeichnislisten.

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie auf Ihrer lokalen Workstation im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo directory` eine Datei namens `conditional_logic.rb`, die den folgenden Code enthält:

   ```
   instance = search("aws_opsworks_instance").first
   os = instance["os"]
   
   if os == "Red Hat Enterprise Linux 7"
     Chef::Log.info("********** Operating system is Red Hat Enterprise Linux. **********")
   elsif os == "Ubuntu 14.04 LTS" || os == "Ubuntu 16.04 LTS" || os == "Ubuntu 18.04 LTS"
     Chef::Log.info("********** Operating system is Ubuntu. **********") 
   elsif os == "Microsoft Windows Server 2012 R2 Base"
     Chef::Log.info("********** Operating system is Windows. **********")
   elsif os == "Amazon Linux 2015.03" || os == "Amazon Linux 2015.09" || os == "Amazon Linux 2016.03" || os == "Amazon Linux 2016.09" || os == "Amazon Linux 2017.03" || os == "Amazon Linux 2017.09" || os == "Amazon Linux 2018.03" || os == "Amazon Linux 2"
     Chef::Log.info("********** Operating system is Amazon Linux. **********")
   elsif os == "CentOS Linux 7"
     Chef::Log.info("********** Operating system is CentOS 7. **********")
   else
     Chef::Log.info("********** Cannot determine operating system. **********")
   end
   
   case os
   when "Ubuntu 14.04 LTS", "Ubuntu 16.04 LTS", "Ubuntu 18.04 LTS"
     apt_package "Install a package with apt-get" do
       package_name "tree"
     end
   when "Amazon Linux 2015.03", "Amazon Linux 2015.09", "Amazon Linux 2016.03", "Amazon Linux 2016.09", "Amazon Linux 2017.03", "Amazon Linux 2017.09", "Amazon Linux 2018.03", "Amazon Linux 2", "Red Hat Enterprise Linux 7", "CentOS Linux 7"
     yum_package "Install a package with yum" do
       package_name "tree"
     end
   else
     Chef::Log.info("********** Cannot determine operating system type, or operating system is not Linux. Package not installed. **********")
   end
   ```

1. Führen Sie am Terminal oder an der Eingabeaufforderung den Befehl **tar** aus, um eine neue Version der Datei `opsworks_cookbook_demo.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und seinen aktualisierten Inhalt enthält.

1. Laden Sie die aktualisierte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::conditional\$1logic** ein. 

**So testen Sie das Rezept:**

1. Wählen Sie , während die Seite **Running command execute\$1recipes (Befehl execute\$1recipes wird ausgeführt)** noch geöffnet ist, für **cookbooks-demo1** und **Log** die Option **show (anzeigen)** aus. Die Protokollseite **execute\$1recipes** wird angezeigt.

1. Führen Sie im Protokoll einen Bildlauf nach unten durch und suchen Sie einen Eintrag, der dem folgenden ähnelt:

   ```
   [2015-11-16T19:59:05+00:00] INFO: ********** Operating system is Amazon Linux. **********
   ```

   Da das Betriebssystem der Instance Amazon Linux 2016.09 ist, wird nur der vorherige Eintrag (von den fünf möglichen Einträgen im Code des Rezepts) im Protokoll angezeigt. 

1. Wenn das Betriebssystem Linux ist, erstellt das Rezept das Paket tree. Zum Anzeigen der Verzeichnisinhalte geben Sie an der Eingabeaufforderung des gewünschten Verzeichnisses **tree** ein oder nutzen den gewünschten Verzeichnispfad (beispielsweise `tree /var/chef/runs`).

Im [nächsten Schritt](gettingstarted-cookbooks-community-cookbooks.md) aktualisieren Sie das Rezeptbuch, um Funktionen eines externen Rezeptbuchs zu nutzen, das von der Chef-Community bereitgestellt wird.

# Schritt 16: Aktualisieren des Rezeptbuchs, um Community-Rezeptbücher zu verwenden
<a name="gettingstarted-cookbooks-community-cookbooks"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Aktualisieren Sie abschließend das Rezeptbuch, um Funktionen aus einem externen Rezeptbuch zu verwenden, das von der Chef-Community bereitgestellt wird. Das für diese Anleitung notwendige externe Rezeptbuch erhalten Sie im [Chef Supermarket](https://supermarket.chef.io/), einer beliebten Quelle für externe Chef-Rezeptbücher. Dieses externe Rezeptbuch stellt eine benutzerdefinierte Ressource zur Verfügung, über die Sie Anwendungen herunterladen und installieren können, ähnlich dem, was Sie in [Schritt 4: Aktualisieren des Rezeptbuchs zum Installieren eines Pakets](gettingstarted-cookbooks-install-package.md) durchgeführt haben. Über diese Ressource können neben Paketen auch Webanwendungen und andere Anwendungstypen installiert werden.

Wenn ein Rezeptbuch von einem anderen Rezeptbuch abhängt, müssen Sie für das andere Rezeptbuch eine Abhängigkeit angeben. Wir empfehlen für das Deklarieren und Verwalten von Rezeptbuch-Abhängigkeiten ein Tool namens Berkshelf. Weitere Informationen zum Installieren von Berkshelf auf Ihrer lokalen Workstation finden Sie unter [About Berkshelf](https://docs.chef.io/berkshelf.html) auf der Chef-Website.

Folgen Sie nach der Installation von Berkshelf diesen Anweisungen, um die Rezeptbuch-Abhängigkeit zu deklarieren. Erstellen Sie dann ein Rezept, das die Ressource in einem externen Rezeptbuch aufruft:

**So deklarieren Sie die Rezeptbuch-Abhängigkeit:**

1. Fügen Sie auf Ihrer lokalen Workstation im Verzeichnis `opsworks_cookbook_demo` folgende Zeile am Ende der Datei `metadata.rb` hinzu:

   ```
   depends "application", "5.0.0"
   ```

   Dies deklariert eine Abhängigkeit von einem Rezeptbuch namens `application`, Version 5.0.0. 

1. Führen Sie vom Stamm des Verzeichnisses `opsworks_cookbook_demo` folgenden Befehl aus: Der Punkt am Ende des Befehls ist beabsichtigt.

   ```
   berks init .
   ```

   Berkshelf erstellt eine Reihe von Ordnern und Dateien, die Sie später für erweiterte Szenarien verwenden können. Die einzige Datei, die wir für diese Anleitung benötigen, ist die Datei `Berksfile`.

1. Fügen Sie die folgende Zeile am Ende der `Berksfile`-Datei hinzu: 

   ```
   cookbook "application", "5.0.0"
   ```

   Dies informiert Berkshelf darüber, dass Sie das [Anwendungs-Rezeptbuch, Version 5.0.0,](https://supermarket.chef.io/cookbooks/application/versions/5.0.0) verwenden möchten, auf Berkshelf von Chef Supermarket herunterlädt.

1. Führen Sie am Terminal oder der Eingabeaufforderung den folgenden Befehl vom Stamm der Verzeichnisses `opsworks_cookbook_demo` aus:

   ```
   berks install
   ```

   Berkshelf erstellt eine Liste von Abhängigkeiten für Ihr Rezeptbuch und das der Anwendung. Berkshelf benötigt diese Liste der Abhängigkeiten für den folgenden Vorgang.

**So aktualisieren Sie das Rezeptbuch auf der Instance und führen das neue Rezept aus:**

1. Erstellen Sie im Unterverzeichnis `recipes` im Verzeichnis `opsworks_cookbook_demo` eine Datei namens `dependencies_demo.rb`, das folgenden Code enthält:

   ```
   application "Install NetHack" do
     package "nethack.x86_64"
   end
   ```

   Dieses Rezept hängt von der Anwendungsressource aus dem Anwendungskochbuch ab, um das beliebte textbasierte Abenteuerspiel NetHack auf der Instanz zu installieren. (Sie können auch einen anderen Paketnamen verwenden, sofern das Paket für den Paket-Manager auf der Instance zur Verfügung steht.)

1. Führen Sie vom Stamm des Verzeichnisses `opsworks_cookbook_demo` folgenden Befehl aus:

   ```
   berks package
   ```

   Berkshelf verwendet die Liste der Abhängigkeiten aus dem vorherigen Verfahren, um eine Datei namens `cookbooks-timestamp.tar.gz` zu erstellen, die das Verzeichnis `opsworks_cookbook_demo` und dessen aktualisierte Inhalte, einschließlich der vom Rezeptbuch abhängigen Rezeptbücher, enthält. Benennen Sie diese Datei in `opsworks_cookbook_demo.tar.gz` um. 

1. Laden Sie die aktualisierte, umbenannte Datei `opsworks_cookbook_demo.tar.gz` in Ihren S3-Bucket hoch.

1. Folgen Sie den Anweisungen in [Schritt 5: Aktualisieren des Rezeptbuchs auf der Instance und Ausführen des Rezepts](gettingstarted-cookbooks-copy-cookbook.md), um das Rezeptbuch auf der Instance zu aktualisieren und das Rezept auszuführen. Geben Sie im Schritt „Rezept ausführen” für **Recipes to execute (Auszuführende Rezepte)** **opsworks\$1cookbook\$1demo::dependencies\$1demo** ein.

1. Nach Ausführung des Rezepts sollten Sie sich bei der Instance anmelden und an der Eingabeaufforderung **nethack** eingeben können, um das Spiel zu starten. (Weitere Informationen zum Spiel finden Sie unter [NetHack](https://en.wikipedia.org/wiki/NetHack)und im [NetHackLeitfaden](http://www.nethack.org/v343/Guidebook.html).) 

Im [nächsten Schritt](gettingstarted-cookbooks-clean-up.md) können Sie die AWS Ressourcen bereinigen, die Sie für diese Komplettlösung verwendet haben. Dieser nächste Schritt ist optional. Möglicherweise möchten Sie diese AWS Ressourcen weiterhin verwenden, wenn Sie mehr über OpsWorks Stacks erfahren. Wenn Sie diese AWS Ressourcen behalten, kann dies jedoch zu laufenden Gebühren für Ihr AWS Konto führen. Wenn Sie diese AWS Ressourcen für eine spätere Verwendung behalten möchten, haben Sie diese exemplarische Vorgehensweise nun abgeschlossen, und Sie können direkt [Nächste Schritte](gettingstarted-cookbooks-next-steps.md) weitermachen.

# Schritt 17: (Optional) Bereinigen
<a name="gettingstarted-cookbooks-clean-up"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Um zu verhindern, dass zusätzliche Gebühren für Ihr AWS Konto anfallen, können Sie die AWS Ressourcen löschen, die für diese Komplettlösung verwendet wurden. Zu diesen AWS Ressourcen gehören der S3-Bucket, der OpsWorks Stacks-Stack und die Komponenten des Stacks. (Weitere Informationen finden Sie unter [ OpsWorks AWS-Preise](https://aws.amazon.com/opsworks/pricing/).) Möglicherweise möchten Sie diese AWS Ressourcen jedoch weiterhin nutzen, um mehr über OpsWorks Stacks zu erfahren. Wenn Sie diese AWS Ressourcen weiterhin verfügbar halten möchten, haben Sie diese exemplarische Vorgehensweise nun abgeschlossen, und Sie können weitermachen. [Nächste Schritte](gettingstarted-cookbooks-next-steps.md)

Inhalte, die in den Ressourcen gespeichert sind, die Sie für diese schrittweise Anleitung erstellt haben, können persönlich identifizierende Informationen enthalten. Wenn Sie nicht mehr möchten, dass diese Informationen von AWS gespeichert werden, führen Sie die in diesem Thema beschriebenen Schritte aus.

**So löschen Sie den S3-Bucket:**
+ Siehe [Löschen des Amazon S3-Buckets](https://docs.aws.amazon.com/gettingstarted/latest/swh/getting-started-cleanup-s3.html).

**So löschen Sie die Instance für den Stack**

1. **Wählen Sie in der OpsWorks Stacks-Konsole im Service-Navigationsbereich Instances aus.** Die Seite **Instances** wird angezeigt.

1. ****Wählen Sie für **MyCookbooksDemoLayer****cookbooks-demo1** für Actions die Option stop aus.**** Wählen Sie im Bestätigungsdialogfeld **Stop** aus.

1. Die folgenden Änderungen können einige Minuten dauern. Fahren Sie erst fort, wenn alle im Folgenden genannten Änderungen abgeschlossen sind.
   + Der **Status** ändert sich von **online** zu **stopping (wird angehalten)** und schließlich zu **stopped (angehalten)**.
   + **online** ändert sich von **1** zu **0**.
   + **shutting down** ändert sich von **0** zu **1** und schließlich wieder zu **0**.
   + **stopped** ändert sich schließlich von **0** zu **1**.

1. Wählen Sie bei **Actions (Aktionen)** die Option **delete (löschen)** aus. **Wenn Sie die Bestätigungsnachricht sehen, wählen Sie Löschen.** OpsWorks Stacks löscht die Instanz und zeigt **Keine** Instanzen an.

**So löschen Sie den Stack**

1. Wählen Sie im Service-Navigationsbereich **Stack** aus. Die Seite **MyCookbooksDemoStack** wird angezeigt.

1. Wählen Sie **Delete Stack**. **Wenn Sie die Bestätigungsmeldung sehen, wählen Sie Löschen.** OpsWorks Stacks löscht den Stapel und zeigt die **Dashboard-Seite** an.

Optional können Sie das IAM-Benutzer- und EC2 Amazon-Schlüsselpaar, das Sie für diese exemplarische Vorgehensweise verwendet haben, löschen, wenn Sie sie nicht für den Zugriff auf andere AWS Services und EC2 Instances wiederverwenden möchten. Anweisungen finden Sie unter [Löschen eines IAM-Benutzers](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_deleting) und [ EC2 Amazon-Schlüsselpaare und Linux-Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#delete-key-pair).

Sie haben diese Anleitung nun abgeschlossen. Weitere Informationen finden Sie unter [Nächste Schritte](gettingstarted-cookbooks-next-steps.md).

# Nächste Schritte
<a name="gettingstarted-cookbooks-next-steps"></a>

**Wichtig**  
Der AWS OpsWorks Stacks Dienst 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](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).

Nachdem Sie diese exemplarische Vorgehensweise abgeschlossen haben, können Sie in den folgenden Ressourcen mehr über die OpsWorks Stacks-Unterstützung für Chef-Kochbücher erfahren:
+ [Cookbooks und Rezepte](workingcookbook.md)— Beschreibt die Versionen von Chef und Ruby, die OpsWorks Stacks derzeit unterstützt. Veranschaulicht zudem das Installieren und Aktualisieren von benutzerdefinierten Rezeptbüchern auf Instances sowie das Ausführen von Rezepten auf diesen.
+ [Learn Chef](https://learn.chef.io/) – Bietet Links zu Chef-Tutorials, einer Bibliothek mit Chef-Funktionen, einer vollständigen Chef-Dokumentation und Chef-Schulungen.
+ [Alles über Chef](https://docs.chef.io/) — Bietet eine vollständige Chef-Dokumentation. Spezifische Themen von Interesse sind:
  + [About Cookbooks](https://docs.chef.io/cookbooks.html) – Beschreibt die wichtigsten Rezeptbuch-Komponenten wie Attribute, Rezepte, Dateien, Metadaten und Vorlagen.
  + [About Recipes](https://docs.chef.io/recipes.html) – Beschreibt die Grundlagen von Rezepten, beispielsweise die Arbeit mit Data Bags, das Einschließen weiterer Rezepte und das Verwenden von Ruby-Code in Rezepten. 
  + [Resources](https://docs.chef.io/resources.html#resources) – Beschreibt, wie alle integrierten Chef-Ressourcen wie `apt_package`, `cookbook_file``directory`, `execute`, `file` und `package` verwendet werden.
  + [About the Recipe DSL](https://docs.chef.io/dsl_recipe.html) – Beschreibt das Schreiben von Code für Chef-Rezepte mit Anweisungen wie `if`, `case`, `data_bag`, `data_bag_item` und `search`. 
+ [About Templates](https://docs.chef.io/templates.html) – Beschreibt, wie eingebettete Ruby (ERB)-Vorlagen verwendet werden, um dynamisch statische Textdateien wie Konfigurationsdateien zu generieren.
+ [Learning Tracks](https://learn.chef.io/tracks) — Beschreibt, wie Sie Chef verwenden, um eine Instanz zu verwalten, eine grundlegende Web-App zu verwalten, Infrastrukturcode zu entwickeln und zu testen, Chef Analytics zu verwenden und vieles mehr.
+ [http://shop.oreilly.com/product/0636920032397.do](http://shop.oreilly.com/product/0636920032397.do) — Eine Einführung in Chef. Veröffentlicht von O'Reilly Media. 
+ [Learning Chef code examples](https://github.com/learningchef/learningchef-code) – Bietet begleitende Code-Beispiele für das von O'Reilly Media herausgegebene Buch *Learning Chef*.