Benutzerdefinierte Elastic Beanstalk-Plattformen (nicht mehr verfügbar)

Eine benutzerdefinierte Plattform ist mehr eine erweiterte Anpassung als ein benutzerdefiniertes Image. Eine benutzerdefinierte Plattform gestattet Ihnen, eine ganze Plattform von Grund auf neu zu entwickeln, das Betriebssystem anzupassen sowie zusätzliche Software und Skripts hinzuzufügen, die Elastic Beanstalk auf Plattform-Instances ausführt. Diese Flexibilität ermöglicht Ihnen den Aufbau einer Plattform für eine Anwendung, die eine Sprache oder andere Infrastruktur-Software verwendet, für die Elastic Beanstalk keine verwaltete Plattform bietet. Vergleichen Sie das mit benutzerdefinierten Images, bei denen Sie ein Amazon Machine Image (AMI) für die Verwendung mit einer vorhandenen Elastic Beanstalk-Plattform ändern und Elastic Beanstalk weiterhin die Plattformskripts bereitstellt und den Software-Stack der Plattform steuert. Darüber hinaus verwenden Sie bei benutzerdefinierten Plattformen eine automatisierte, skriptgesteuerte Methode, Ihre Anpassung zu erstellen und zu verwalten, während Sie bei benutzerdefinierten Abbildern die Änderungen manuell über eine laufende Instance ausführen.

Um eine benutzerdefinierte Plattform zu erstellen, erstellen Sie eine AMI mit einem der unterstützten Betriebssysteme — Ubuntu oder Amazon Linux (die genauen Versionsnummern finden Sie im flavor Platform.yaml-Dateiformat Eintrag unter) und fügen weitere Anpassungen hinzu. RHEL Sie erstellen Ihre eigene Elastic Beanstalk-Plattform mit Packer, einem Open-Source-Tool zur Erstellung von Maschinenimages für viele Plattformen, auch AMIs für die Verwendung mit Amazon Elastic Compute Cloud (Amazon). EC2 Eine Elastic Beanstalk-Plattform umfasst eine für die Ausführung AMI konfigurierte Software, die eine Anwendung unterstützt, und Metadaten, die benutzerdefinierte Konfigurationsoptionen und Standardkonfigurationsoptionen enthalten können.

Elastic Beanstalk verwaltet Packer als separate integrierte Plattform und Sie brauchen sich nicht um die Konfiguration und Versionen von Packer zu kümmern.

Sie erstellen eine Plattform, indem Sie Elastic Beanstalk eine Packer-Vorlage sowie die Skripts und Dateien zur Verfügung stellen, die die Vorlage zum Erstellen einer solchen Vorlage aufruft. AMI Diese Komponenten werden zusammen mit einer Plattformdefinitionsdatei, die die Vorlage und die Metadaten spezifiziert, in einem ZIP Archiv zusammengefasst, das als Plattformdefinitionsarchiv bezeichnet wird.

Wenn Sie eine benutzerdefinierte Plattform erstellen, starten Sie eine Umgebung mit einer einzelnen Instance ohne eine Elastic IP, die Packer ausführt. Packer startet dann eine weitere Instance, um ein Image zu erstellen. Sie können diese Umgebung für mehrere Plattformen und verschiedene Versionen jeder Plattform einsetzen.

Benutzer in Ihrem Konto können Ihre benutzerdefinierten Plattformen verwenden, indem sie ARN bei der Erstellung der Umgebung eine Plattform angeben. Diese ARNs werden von dem eb platform create Befehl zurückgegeben, mit dem Sie die benutzerdefinierte Plattform erstellt haben.

Jedes Mal, wenn Sie eine benutzerdefinierte Plattform erstellen, generiert Elastic Beanstalk eine neue Plattformversion. Benutzer können den Namen einer Plattform angeben, damit nur die neueste Version der Plattform aufgerufen wird, oder eine Versionsnummer spezifizieren, um eine bestimmte Version zu erhalten.

Um beispielsweise die neueste Version der benutzerdefinierten Plattform mit der ARNMyCustomPlatformARN, was Version 3.0 sein könnte, bereitzustellen, würde Ihre CLI EB-Befehlszeile wie folgt aussehen:

eb create -p MyCustomPlatformARN

Um Version 2.1 bereitzustellen, würde Ihre CLI EB-Befehlszeile wie folgt aussehen:

eb create -p MyCustomPlatformARN --version 2.1

Sie können eine benutzerdefinierte Plattformversion mit Tags markieren, wenn Sie sie erstellen, und Tags von vorhandenen benutzerdefinierten Plattformversionen bearbeiten. Details hierzu finden Sie unter Markieren von benutzerdefinierten Plattformversionen.

Erstellen einer benutzerdefinierten Plattform

Damit Sie eine benutzerdefinierte Plattform erstellen können, muss der Anwendungsstamm eine Plattformdefinitionsdatei enthalten, platform.yaml. Diese definiert den Builder-Typ, mit dem die benutzerdefinierte Plattform erstellt wird. Das Format dieser Datei ist in Platform.yaml-Dateiformat beschrieben. Sie können die benutzerdefinierte Plattform von Grund auf neu erstellen oder eines der benutzerdefinierten Plattformbeispiele als Ausgangspunkt verwenden.

Verwenden eines benutzerdefinierten Plattformbeispiels

Als Alternative zum Erstellen einer eigenen benutzerdefinierten Plattform können Sie eines der Plattformdefinitionsarchiv-Beispiele für den Bootstrap der benutzerdefinierten Plattform nutzen. Die einzigen Elemente, die Sie in den Beispielen konfigurieren müssen, bevor Sie sie verwenden können, sind eine Quelle AMI und eine Region.

Laden Sie das Plattformdefinitionsarchiv-Beispiel herunter: NodePlatform_Ubuntu.zip. Diese Datei enthält eine Plattformdefinitionsdatei, eine Packer-Vorlage, Skripts, die während der Image-Erstellung von Packer ausgeführt werden, sowie Skripts und Konfigurationsdateien, die von Packer im Rahmen der Plattformerstellung auf die Builder-Instance kopiert werden.

|-- builder                 Contains files used by Packer to create the custom platform
|-- custom_platform.json    Packer template
|-- platform.yaml           Platform definition file
|-- ReadMe.txt              Briefly describes the sample

Die Plattformdefinitionsdatei, platform.yaml, teilt Elastic Beanstalk den Namen der Packer-Vorlage mit, custom_platform.json.

version: "1.0"

provisioner:
  type: packer
  template: custom_platform.json
  flavor: ubuntu1604

Die Packer-Vorlage teilt Packer mit, wie das AMIs für die Plattform erstellt wird, wobei Ubuntu AMI als Basis für das Plattform-Image für HVM Instance-Typen verwendet wird. Der Abschnitt provisioners weist Packer an, alle Dateien im Archiv-Ordner builder auf die Instance zu kopieren und das Skript builder.sh auf der Instance auszuführen. Nach Abschluss des Skripts erstellt Packer ein Image von der geänderten Instance.

Elastic Beanstalk erstellt drei Umgebungsvariablen, die zum Taggen AMIs in Packer verwendet werden können:

Die Beispieldatei custom_platform.json nutzt diese Variablen, um die folgenden in den Skripts verwendeten Werte zu definieren:

Die Datei custom_platform.json enthält zwei Eigenschaften, für die Sie Werte angeben müssen: source_ami und region. Einzelheiten zur Auswahl der Werte für „right“ AMI und „Region“ finden Sie unter Packer-Vorlage im Repository aktualisieren. eb-custom-platforms-samples GitHub

{
  "variables": {
    "platform_name": "{{env `AWS_EB_PLATFORM_NAME`}}",
    "platform_version": "{{env `AWS_EB_PLATFORM_VERSION`}}",
    "platform_arn": "{{env `AWS_EB_PLATFORM_ARN`}}"
  },
  "builders": [
    {
      ...
      "region": "",
      "source_ami": "",
      ...
    }
  ],
  "provisioners": [
    {...},
    {
      "type": "shell",
      "execute_command": "chmod +x {{ .Path }}; {{ .Vars }} sudo {{ .Path }}",
      "scripts": [
        "builder/builder.sh"
      ]
    }
  ]
}

Die Skripts und andere Dateien, die Sie in das Plattformdefinitionsarchiv einbinden, sind je nach den Änderungen, die Sie an der Instance vornehmen möchten, sehr unterschiedlich. Das Plattformbeispiel enthält die folgenden Skripts:

Verwenden Sie EBCLI, um Ihre erste benutzerdefinierte Plattform mit dem Beispielarchiv für Plattformdefinitionen zu erstellen.

Nach Abschluss des Vorgangs steht Ihnen eine Plattform zur Verfügung, auf der Sie eine Elastic Beanstalk-Umgebung starten können.

Sie können die benutzerdefinierte Plattform einsetzen, um eine neue Umgebung mit der Konsole zu erstellen. Siehe Der Assistent zum Erstellen einer neuen Umgebung.

Inhalte des Plattformdefinitionsarchivs

Ein Plattformdefinitionsarchiv ist die Plattformentsprechung vom Quell-Bundle der Anwendung. Das Plattformdefinitionsarchiv ist eine ZIP Datei, die eine Plattformdefinitionsdatei, eine Packer-Vorlage sowie die Skripts und Dateien enthält, die von der Packer-Vorlage zur Erstellung Ihrer Plattform verwendet wurden.

Die Plattformdefinitionsdatei ist eine im YAML -Format formatierte Datei, die benannt werden muss platform.yaml und sich im Stammverzeichnis Ihres Plattformdefinitionsarchivs befinden muss. Unter Erstellen einer benutzerdefinierten Plattform finden Sie eine Liste der erforderlichen und optionalen Schlüssel, die in einer Plattformdefinitionsdatei unterstützt werden.

Die Packer-Vorlage muss nicht nach einer bestimmten Konvention benannt werden, jedoch muss dieser Dateiname mit der Provisioner-Vorlage, die in der Plattformdefinitionsdatei angegeben ist, übereinstimmen. Anleitungen zum Erstellen von Packer-Vorlagen finden Sie in der offiziellen Packer-Dokumentation.

Bei den anderen Dateien in Ihrem Plattformdefinitionsarchiv handelt es sich um Skripts und Dateien, die von der Vorlage verwendet werden, um eine Instanz anzupassen, bevor eine erstellt wird. AMI

Benutzerdefinierte Plattform-Hooks

Elastic Beanstalk verwendet eine standardisierte Verzeichnisstruktur für Hooks auf benutzerdefinierten Plattformen. Dies sind Skripts, die bei Lebenszyklusereignissen und als Reaktion auf Verwaltungsvorgänge ausgeführt werden, z. B. wenn Instances in der Umgebung gestartet werden oder wenn ein Benutzer eine Bereitstellung initiiert oder die Funktion für den Neustart des Anwendungsservers nutzt.

Platzieren Sie Skripts, die Hooks auslösen sollen, in einem der Unterordner des Ordners /opt/elasticbeanstalk/hooks/.

Hooks sind in den folgenden Ordnern organisiert:

Die Ordner appdeploy, configdeploy und restartappserver enthalten die Unterordner pre, enact und post. In den einzelnen Vorgangsphasen werden alle Skripts im Ordner pre in alphabetischer Reihenfolge ausgeführt, dann folgen diejenigen im Ordner enact und anschließend diejenigen im Ordner post.

Beim Starten einer Instance führt Elastic Beanstalk preinit, appdeploy und postinit in dieser Reihenfolge aus. Bei nachfolgenden Bereitstellungen auf ausgeführten Instances führt Elastic Beanstalk die appdeploy-Hooks aus. Die configdeploy-Hooks werden ausgeführt, wenn ein Benutzer die Instance-Softwarekonfigurationseinstellungen aktualisiert. Die restartappserver-Hooks werden nur ausgeführt, wenn ein Benutzer den Neustart des Anwendungsservers initiiert.

Falls die Skripts auf Fehler treffen, werden sie mit einem Status ungleich null beendet und schreiben den fehlgeschlagenen Vorgang in die Datei stderr. Die in die Datei stderr geschriebene Nachricht wird im Ereignis angezeigt, das im Falle eines fehlgeschlagenen Vorgangs ausgegeben wird. Zudem werden diese Informationen von Elastic Beanstalk in der Protokolldatei /var/log/eb-activity.log erfasst. Wenn der Vorgang nicht als fehlgeschlagen gelten soll, muss 0 (Null) zurückgegeben werden. Nachrichten, die in die Datei stderr oder stdout geschrieben werden, erscheinen in den Bereitstellungsprotokollen, werden aber nur bei einem fehlgeschlagenen Vorgang im Ereignis-Stream angegeben.

Bereinigen von Instances durch Packer

Unter bestimmten Umständen, z. B. wenn der Packer-Erstellungsprozess vorzeitig abgebrochen wird, werden von Packer gestartete Instances nicht bereinigt. Diese Instances sind nicht Teil der Elastic Beanstalk Beanstalk-Umgebung und können nur mithilfe des EC2 Amazon-Service angezeigt und beendet werden.

Platform.yaml-Dateiformat

Die platform.yaml-Datei hat folgendes Format:

version: "version-number"

provisioner:
   type: provisioner-type
   template: provisioner-template
   flavor: provisioner-flavor
        
metadata:
   maintainer: metadata-maintainer
   description: metadata-description
   operating_system_name: metadata-operating_system_name
   operating_system_version: metadata-operating_system_version
   programming_language_name: metadata-programming_language_name
   programming_language_version: metadata-programming_language_version
   framework_name: metadata-framework_name
   framework_version: metadata-framework_version

option_definitions:
   - namespace: option-def-namespace
     option_name: option-def-option_name
     description: option-def-description
     default_value: option-def-default_value

option_settings:
   - namespace: "option-setting-namespace"
     option_name: "option-setting-option_name"
     value: "option-setting-value"

Ersetzen Sie die Platzhalter mit folgenden Werten:

Markieren von benutzerdefinierten Plattformversionen

Sie können Tags auf Ihre AWS Elastic Beanstalk benutzerdefinierten Plattformversionen anwenden. Tags sind Schlüssel-Wert-Paare, die Ressourcen zugeordnet AWS sind. Weitere Informationen zum Elastic Beanstalk-Ressourcen-Tagging, zu Anwendungsfälle, Einschränkungen für Tag-Schlüssel und -Werte sowie zu unterstützten Ressourcentypen finden Sie unter Markieren von Elastic Beanstalk-Anwendungsressourcen.

Sie können Tags angeben, wenn Sie eine benutzerdefinierte Plattformversion erstellen. In einer vorhandenen benutzerdefinierten Plattformversion können Sie Tags hinzufügen oder entfernen sowie die Werte von vorhandenen Tags aktualisieren. Sie können jeder benutzerdefinierten Plattformversion bis zu 50 Tags hinzufügen.

Hinzufügen von Tags beim Erstellen einer benutzerdefinierten Plattformversion

Wenn Sie die EB verwendenCLI, um Ihre benutzerdefinierte Plattformversion zu erstellen, verwenden Sie die --tags Option mit, eb platform create um Tags hinzuzufügen.

~/workspace/my-app$ eb platform create --tags mytag1=value1,mytag2=value2

Fügen Sie mit dem AWS CLI oder anderen API basierten Clients Tags hinzu, indem Sie den --tags Parameter im create-platform-version Befehl verwenden.

$ aws elasticbeanstalk create-platform-version \
      --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
      --platform-name my-platform --platform-version 1.0.0 --platform-definition-bundle S3Bucket=amzn-s3-demo-bucket,S3Key=sample.zip

Verwalten von Tags einer vorhandenen benutzerdefinierten Plattformversion

In einer vorhandenen benutzerdefinierten Elastic Beanstalk-Plattformversion können Sie Tags hinzufügen, aktualisieren und löschen.

Wenn Sie das EB verwendenCLI, um Ihre benutzerdefinierte Plattformversion zu aktualisieren, verwenden Sie es, eb tags um Tags hinzuzufügen, zu aktualisieren, zu löschen oder aufzulisten.

Beispiel: Der folgende Befehl listet die Tags in einer benutzerdefinierten Plattformversion auf.

~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Mit dem folgenden Befehl wird das Tag mytag1 aktualisiert und das Tag mytag2 gelöscht.

~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Eine umfassende Liste der Optionen sowie weitere Beispiele finden Sie unter eb tags.

Verwenden Sie bei den AWS CLI oder anderen API basierten Clients den list-tags-for-resource Befehl, um die Tags einer benutzerdefinierten Plattformversion aufzulisten.

$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Verwenden Sie den Befehl update-tags-for-resource zum Hinzufügen, Aktualisieren und Löschen von Tags in einer benutzerdefinierten Plattformversion.

$ aws elasticbeanstalk update-tags-for-resource \
      --tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 \
      --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Geben Sie sowohl hinzuzufügende als auch zu aktualisierende Tags im Parameter --tags-to-add des Befehls update-tags-for-resource an. Wenn ein Tag nicht vorhanden ist, wird es hinzugefügt, andernfalls wird es aktualisiert.

$ aws elasticbeanstalk list-platform-versions