Umgebungsmanifest (env.yaml) - AWS Elastic Beanstalk

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.

Umgebungsmanifest (env.yaml)

Sie können ein Umgebungsmanifest im YAML-Format in den Stamm des Quell-Bundles der Anwendung einbinden und so den Umgebungsnamen, das Lösungs-Stack und Umgebungslinks konfigurieren, die beim Erstellen der Umgebung verwendet werden sollen.

Dieses Dateiformat unterstützt Umgebungsgruppen. Für die Verwendung von Gruppen geben Sie den Umgebungsnamen mit einem Pluszeichen (+) am Ende im Manifest an. Beim Erstellen oder Aktualisieren der Umgebung geben Sie den Gruppennamen mit --group-name (AWS CLI) oder mit --env-group-suffix (EB CLI) an. Weitere Informationen zu Gruppen finden Sie unter Gruppen von Elastic Beanstalk Umgebungen erstellen oder aktualisieren.

Im folgenden Beispielmanifest wird eine Webserverumgebung mit einem Link zu einer Basiskomponente in einer Worker-Umgebung definiert. Im Manifest werden Gruppen verwendet, damit mehrere Umgebungen mit dem gleichen Quell-Bundle erstellt werden können:

~/myapp/frontend/env.yaml

AWSConfigurationTemplateVersion: 1.1.0.0
SolutionStack: 64bit Amazon Linux 2015.09 v2.0.6 running Multi-container Docker 1.7.1 (Generic)
OptionSettings:
  aws:elasticbeanstalk:command:
    BatchSize: '30'
    BatchSizeType: Percentage
  aws:elasticbeanstalk:sns:topics:
    Notification Endpoint: me@example.com
  aws:elb:policies:
    ConnectionDrainingEnabled: true
    ConnectionDrainingTimeout: '20'
  aws:elb:loadbalancer:
    CrossZone: true
  aws:elasticbeanstalk:environment:
    ServiceRole: aws-elasticbeanstalk-service-role
  aws:elasticbeanstalk:application:
    Application Healthcheck URL: /
  aws:elasticbeanstalk:healthreporting:system:
    SystemType: enhanced
  aws:autoscaling:launchconfiguration:
    IamInstanceProfile: aws-elasticbeanstalk-ec2-role
    InstanceType: t2.micro
    EC2KeyName: workstation-uswest2
  aws:autoscaling:updatepolicy:rollingupdate:
    RollingUpdateType: Health
    RollingUpdateEnabled: true
Tags:
  Cost Center: WebApp Dev
CName: front-A08G28LG+
EnvironmentName: front+
EnvironmentLinks:
  "WORKERQUEUE" : "worker+"

Folgende Schlüssel werden unterstützt.

  • AWSConfigurationTemplateVersion (erforderlich) – Version der Konfigurationsvorlage (1.1.0.0).

    AWSConfigurationTemplateVersion: 1.1.0.0

  • Plattform – Der Amazon-Ressourcenname (ARN) der Plattformversion für die Umgebung. Sie können die Plattform nach ARN oder Lösungs-Stack-Namen angeben.

    Platform:
  PlatformArn: arn:aws:elasticbeanstalk:us-east-2::platform/Java 8 running on 64bit Amazon Linux/2.5.0

  • SolutionStack – Vollständiger Name des für die Umgebungserstellung verwendeten Lösungs-Stacks.

    SolutionStack: 64bit Amazon Linux 2017.03 v2.5.0 running Java 8

  • OptionSettings – Konfigurationsoptions-Einstellungen für die Umgebung. Beispielsweise wird mit folgendem Eintrag der Instance-Typ auf "t2.micro" festgelegt.

    OptionSettings:
  aws:autoscaling:launchconfiguration:
    InstanceType: t2.micro

  • Tags – Bis zu 47 Tags können für in der Umgebung erstellte Ressourcen verwendet werden.

    Tags:
  Cost Center: WebApp Dev

  • EnvironmentTier – Typ der zu erstellenden Umgebung. Bei einer Webserverumgebung kann dieser Bereich ausgelassen werden (Webserver ist der Standardwert). Bei einer Worker-Umgebung verwenden Sie Folgendes.

    EnvironmentTier:
  Name: Worker
  Type: SQS/HTTP

  • CName – CNAME der Umgebung. Binden Sie das Plus-Zeichen (+) am Ende des Namens ein, um Gruppen zu aktivieren.

    CName: front-A08G28LG+

  • EnvironmentName – Name der zu erstellenden Umgebung. Binden Sie das Plus-Zeichen (+) am Ende des Namens ein, um Gruppen zu aktivieren.

    EnvironmentName: front+

    Wenn Gruppen aktiviert sind, müssen Sie bei der Umgebungserstellung einen Gruppennamen angeben. Elastic Beanstalk hängt den Gruppennamen mit einem Bindestrich an die Umgebung an. Beispielsweise erstellt Elastic Beanstalk aus dem Umgebungsnamen front+ und dem Gruppennamen dev eine Umgebung mit dem Namen front-dev.

  • EnvironmentLinks – Zuordnung von Variablennamen und Umgebungsnamen von Abhängigkeiten. Das folgende Beispiel macht aus der worker+-Umgebung eine Abhängigkeit und weist Elastic Beanstalk an, die Link-Informationen in einer Variable namens WORKERQUEUE zu speichern.

    EnvironmentLinks:
  "WORKERQUEUE" : "worker+"

    Der Wert der Link-Variable variiert abhängig vom Typ der verknüpften Umgebung. In einer Webserverumgebung besteht der Link aus dem CNAME der Umgebung. Bei einer Worker-Umgebung ist der Link der Amazon Simple Queue Service (Amazon SQS)-Warteschlangenname der Umgebung.

Mit den Schlüsseln CName, EnvironmentName und EnvironmentLinks lassen sich Umgebungsgruppen und Links zu anderen Umgebungen erstellen. Diese Funktionen werden derzeit bei der Verwendung der EB CLI, der AWS CLI oder einem SDK unterstützt.