Hinzufügen von Apps

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 oder über den AWS Premium-Support.

Im ersten Schritt bei der Bereitstellung einer Anwendung für Ihre Anwendungsserver fügen Sie eine App zum Stack hinzu. Die App stellt die Anwendung dar und enthält eine Vielzahl von Metadaten, wie z. B. den Namen und den Typ der Anwendung, sowie die Informationen, die zum Bereitstellen der Anwendung für die Server-Instances erforderlich sind, z. B. die Repository-URL. Sie müssen über die Manage-Berechtigungen verfügen, um eine App zu einem Stack hinzufügen zu können. Weitere Informationen finden Sie unter Verwalten von Benutzerberechtigungen.

Anmerkung

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.

So fügen Sie eine App zu einem Stack hinzu

1. Platzieren Sie den Code in Ihrem bevorzugten Repository — einem Amazon S3 S3-Archiv, einem Git-Repository, einem Subversion-Repository oder einem HTTP-Archiv. Weitere Informationen finden Sie unter Anwendungsquelle.

2. Klicken Sie im Navigationsbereich auf Apps. Klicken Sie auf der Seite Apps auf Add an app (App hinzufügen) für Ihre erste App. Klicken Sie für alle nachfolgenden Apps auf +App.

3. Konfigurieren Sie die App auf der Seite App New (App neu) gemäß den Schritten im folgenden Abschnitt.

Konfigurieren einer App

Die Seite Add App (App hinzufügen) besteht aus den folgenden Abschnitten: Settings (Einstellungen), Application source (Anwendungsquelle), Data Sources (Datenquellen), Environment Variables (Umgebungsvariablen), Add Domains (Domänen hinzufügen) und SSL Settings (SSL-Einstellungen).

Einstellungen

Name

Der Name der App, der verwendet wird, um die App in der Benutzeroberfläche darzustellen. AWS OpsWorks Stacks verwendet diesen Namen auch, um einen Kurznamen für die App zu generieren, der intern verwendet wird, und um die App in der Stackkonfiguration und den Bereitstellungsattributen zu identifizieren. Nach dem Hinzufügen der App zum Stack können Sie die Kurzbezeichnung anzeigen, indem Sie im Navigationsbereich auf Apps und dann auf den App-Namen klicken, um die Detailseite zu öffnen.

Document root (Basisverzeichnis)

AWS OpsWorks Stacks weist dem [:document_root]Attribut in den Attributen der App die Einstellung Document Root zu. deploy Der Standardwert ist null. Ihre Bereitstellungsrezepte können diesen Wert mithilfe der standardmäßigen Chef-Knotensyntax aus den deploy-Attributen abrufen und den angegebenen Code am entsprechenden Speicherort auf dem Server bereitstellen. Weitere Informationen zum Bereitstellen von Apps finden Sie unter Bereitstellungsrezepte.

Anwendungsquelle

Sie können Apps aus den folgenden Repository-Typen bereitstellen: Git, Amazon S3 S3-Bundle, HTTP-Bundle und Andere. Für alle Repository-Typen müssen Sie den Typ und die URL des Repositorys angeben. Einzelne Repository-Typen haben ihre eigenen Anforderungen, wie im Folgenden beschrieben.

Anmerkung

AWS OpsWorks Stacks stellt automatisch Anwendungen aus den Standard-Repositorys auf die integrierten Serverschichten bereit. Wenn Sie den Repository-Typ „Anderes Repository“ verwenden, was die einzige Option für Windows-Stacks ist, AWS OpsWorks fügt Stacks die Repository-Informationen in die deployAttribute der App ein. Sie müssen jedoch benutzerdefinierte Rezepte implementieren, um die Bereitstellungsaufgaben zu erledigen.

Themen

• HTTP-Archiv
• Amazon S3 S3-Archiv
• Git-Repository
• Andere Repositorys

HTTP-Archiv

So verwenden Sie einen öffentlich verfügbaren HTTP-Server als Repository:

1. Erstellen Sie ein komprimiertes Archiv — zip, gzip, bzip2, Java WAR oder tarball — des Ordners, der den Code der App und alle zugehörigen Dateien enthält.

   Anmerkung

   AWS OpsWorks Stacks unterstützt keine unkomprimierten Tarballs.

2. Laden Sie die Archivdatei auf den Server hoch.

3. Zum Festlegen des Repositorys in der Konsole wählen Sie das HTTP-Archiv als Repository-Typ aus und geben Sie die URL ein.

   Wenn das Archiv kennwortgeschützt ist, geben Sie unter Anwendungsquelle die Anmeldeinformationen an.

Amazon S3 S3-Archiv

So verwenden Sie einen Amazon Simple Storage Service-Bucket als Repository:

1. Erstellen Sie einen öffentlichen oder privaten Amazon S3 S3-Bucket. Weitere Informationen finden Sie in der Amazon S3 S3-Dokumentation.

2. Damit AWS OpsWorks Stacks auf private Buckets zugreifen kann, müssen Sie ein Benutzer mit mindestens Leserechten für den Amazon S3 S3-Bucket sein und Sie benötigen die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel. Weitere Informationen finden Sie in der AWS Identity and Access Management Dokumentation.

3. Platzieren Sie den Code und alle zugehörigen Dateien in einem Ordner und speichern Sie diesen in einem komprimierten Archiv (ZIP, GZIP, BZIP2, Java WAR oder Tarball).

   Anmerkung

   AWS OpsWorks Stacks unterstützt keine unkomprimierten Tarballs.

4. Laden Sie die Archivdatei in den Amazon S3 S3-Bucket hoch und notieren Sie die URL.

5. Um das Repository in der AWS OpsWorks Stacks-Konsole anzugeben, setzen Sie den Repository-Typ auf S3-Archiv und geben Sie die URL des Archivs ein. Für ein privates Archiv müssen Sie auch eine AWS-Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel angeben, dessen Richtlinie Berechtigungen für den Zugriff auf den Bucket gewährt. Lassen Sie diese Einstellungen für öffentliche Archive leer.

Git-Repository

Ein Git-Repository bietet Quellcodeverwaltung und Versionierung. AWS OpsWorks Stacks unterstützt öffentlich gehostete Repository-Sites wie GitHubBitbucket sowie privat gehostete Git-Server. Bei Anwendungs- und Git-Submodulen hängt das Format, das Sie für die Repository-URL unter Application Source (Anwendungsquelle) festlegen, davon ab, ob das Repository öffentlich oder privat ist:

Öffentliches Repository — Verwenden Sie die schreibgeschützten HTTPS- oder Git-Protokolle. Erste Schritte mit Chef 11 Linux-StacksVerwendet beispielsweise ein öffentliches GitHub Repository, auf das über eines der folgenden URL-Formate zugegriffen werden kann:

• Schreibgeschütztes Git-Protokoll: git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

• HTTPS: https://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

Privates Repository — Verwenden Sie das SSH-Lese-/Schreibformat, das in diesen Beispielen gezeigt wird:

• Github-Repositorys: [e-mail]:project/repository.

• Repositorys auf einem Git-Server: user@server:project/repository

Wenn Sie Git (Git) unter Source Control (Quellsteuerung) auswählen, werden zwei zusätzliche optionale Einstellungen angezeigt:

Repository SSH key (Repository-SSH-Schlüssel)

Sie müssen einen SSH-Bereitstellungsschlüssel für den Zugriff auf private Git-Repositorys angeben. Dieses Feld benötigt den privaten Schlüssel; der öffentliche Schlüssel ist Ihrem Git-Repository zugeordnet. Bei Git-Submodulen muss der angegebene Schlüssel Zugriff auf diese Submodule haben. Weitere Informationen finden Sie unter Verwenden von Git-Repository-SSH-Schlüsseln.

Wichtig

Für den SSH-Bereitstellungsschlüssel ist kein Passwort erforderlich; AWS OpsWorks Stacks hat keine Möglichkeit, es weiterzugeben.

Branch/Revision

Wenn das Repository mehrere Branches hat, lädt AWS OpsWorks Stacks standardmäßig den Master-Branch herunter. Um einen bestimmten Branch festzulegen, geben Sie den Branch-Namen (SHA1-Hash) oder den Tag-Namen ein. Um einen bestimmten Commit festzulegen, geben Sie die vollständige Commit-ID mit 40 Hexadezimalziffern an.

Andere Repositorys

Wenn die Standard-Repositorys nicht Ihren Anforderungen entsprechen, können Sie andere Repositorys verwenden, z. B. Bazaar. AWS OpsWorks Stacks stellt Apps aus solchen Repositorys jedoch nicht automatisch bereit. Sie müssen benutzerdefinierte Rezepte zum Durchführen des Bereitstellungsverfahrens implementieren und diese den Bereitstellungsereignissen des entsprechenden Layers zuweisen. Ein Beispiel für die Implementierung von Bereitstellungsrezepten finden Sie unter Bereitstellungsrezepte.

Datenquellen

In diesem Abschnitt wird erläutert, wie Sie eine Datenbank an die Anwendung anfügen. Ihnen stehen folgende Optionen zur Verfügung:

• RDS — Hängen Sie eine der Amazon RDS-Serviceschichten des Stacks an.

• Keine — Hängen Sie keinen Datenbankserver an.

Wenn Sie RDS auswählen, müssen Sie Folgendes angeben.

Datenbank-Instance

Die Liste umfasst alle Amazon RDS-Serviceschichten. Sie können auch eine der folgenden Optionen auswählen:

(Erforderlich) Geben Sie an, welcher Datenbankserver an die Anwendung angefügt werden soll. Der Inhalt der Liste hängt von der Datenquelle ab.

• RDS — Eine Liste der Amazon RDS-Serviceschichten des Stacks.

Datenbankname

(Optional) Geben Sie einen Datenbanknamen an.

• Amazon RDS-Layer — Geben Sie den Datenbanknamen ein, den Sie für die Amazon RDS-Instance angegeben haben.

  Sie können den Datenbanknamen von der Amazon RDS-Konsole abrufen.

Wenn Sie eine App mit einer angehängten Datenbank bereitstellen, fügt AWS OpsWorks Stacks die Verbindung der Datenbank-Instance zu den deployAttributen der App hinzu.

Sie können ein benutzerdefiniertes Rezept schreiben, um die Informationen aus den deploy-Attributen abzurufen, und dieses in die Datei einfügen, auf die die Anwendung zugreifen kann. Beim Anwendungstyp "Other" ist dies die einzige Option für die Bereitstellung der Datenbankverbindungsinformationen.

Weitere Informationen zum Verarbeiten von Datenbankverbindungen finden Sie unter Verbinden mit einer Datenbank.

Um einen Datenbankserver von einer Anwendung zu trennen, bearbeiten Sie die Anwendungskonfiguration und geben Sie einen anderen Datenbankserver oder keinen Server an.

Umgebungsvariablen

Sie können für jede Anwendung eine Reihe von Umgebungsvariablen definieren, die für die Anwendung spezifisch sind. Wenn Sie zum Beispiel über zwei Anwendungen verfügen, stehen die Umgebungsvariablen, die Sie für die erste Anwendung definieren, nicht für die zweite Anwendung zur Verfügung und umgekehrt. Sie können auch dieselbe Umgebungsvariable für mehrere Anwendungen definieren und jeder Anwendung einen anderen Wert zuweisen.

Anmerkung

Es gibt keinen besonderen Grenzwert in Bezug auf die Anzahl der Umgebungsvariablen. Die Größe der zugehörigen Datenstruktur, die die Namen, Werte und geschützten Flag-Werte der Variablen umfasst, darf jedoch 20 KB nicht überschreiten. Dieser Grenzwert sollte für die meisten, wenn nicht sogar für alle Anwendungsfälle ausreichend sein. Bei Überschreitung tritt ein Servicefehler (Konsole) oder eine Ausnahme (API) auf und es wird folgende Meldung angezeigt: "Environment: is too large (maximum is 20KB)."

AWS OpsWorks Stacks speichert die Variablen als Attribute in den Attributen der App. deploy Sie können diese Werte mithilfe der standardmäßigen Chef-Knotensyntax durch Ihre benutzerdefinierten Rezepte abrufen. Weitere Beispiele für den Zugriff auf die Umgebungsvariablen einer Anwendung finden Sie unter Verwenden von -Umgebungsvariablen.

Schlüssel

Der Name der Variable. Er kann bis zu 64 Groß- und Kleinbuchstaben, Zahlen und Unterstriche (_) enthalten, aber er muss mit einem Buchstaben oder Unterstrich beginnen.

Wert

Der Wert der Variable. Er kann bis zu 256 Zeichen enthalten, die alle druckbar sein müssen.

Geschützter Wert

Gibt an, ob der Wert geschützt ist. Diese Einstellung ermöglicht es Ihnen, sensible Daten wie Passwörter zu verbergen. Wenn Sie nach dem Erstellen der Anwendung den Wert Protected value (Geschützter Wert) für eine Variable festlegen:

• Auf der Detailseite der Anwendung wird nur der Name der Variable und nicht der Wert angezeigt.

• Wenn Sie über die Berechtigung zum Bearbeiten der Anwendung verfügen, können Sie auf Update value (Wert aktualisieren) klicken, um einen neuen Wert anzugeben. Sie können den alten Wert jedoch nicht anzeigen oder bearbeiten.

Anmerkung

Chef-Bereitstellungsprotokolle können manchmal auch Umgebungsvariablen enthalten. Dies bedeutet, dass geschützte Variablen möglicherweise in der Konsole angezeigt werden. Um zu verhindern, dass geschützte Variablen in der Konsole angezeigt werden, empfehlen wir, Amazon S3 S3-Buckets als Speicher für geschützte Variablen zu verwenden, die nicht in der Konsole angezeigt werden sollen. Ein Beispiel dafür, wie Sie einen S3-Bucket für diesen Zweck verwenden finden Sie unter Verwenden eines Amazon S3 S3-Buckets in diesem Handbuch.

Domänen- und SSL-Einstellungen

Für den App-Typ Andere fügt AWS OpsWorks Stacks die Einstellungen zu den Attributen der deploy App hinzu. Ihre Rezepte können die Daten aus diesen Attributen abrufen und den Server gegebenenfalls konfigurieren.

Domäneneinstellungen

Dieser Abschnitt enthält das optionale Feld Add Domains (Domänen hinzufügen) für die Angabe von Domänen. Weitere Informationen finden Sie unter Verwenden von benutzerdefinierten Domänen.

SSL-Einstellungen

Dieser Abschnitt enthält den Schalter SSL Support (SSL-Support), mit dem Sie SSL aktivieren oder deaktivieren können. Wenn Sie auf Yes (Ja) klicken, müssen Sie SSL-Zertifikatinformationen angeben. Weitere Informationen finden Sie unter Verwenden von SSL.