Elastic Beanstalk Beanstalk-Beispiele mit AWS CLI

So brechen Sie eine Bereitstellung ab

Mit dem folgenden Befehl wird die Bereitstellung einer laufenden Anwendungsversion für eine Umgebung namens my-env abgebrochen:

aws elasticbeanstalk abort-environment-update --environment-name my-env

So prüfen Sie die Verfügbarkeit eines CNAME

Im folgenden Befehl wird die Verfügbarkeit der Subdomain my-cname.elasticbeanstalk.com geprüft:

aws elasticbeanstalk check-dns-availability --cname-prefix my-cname

Ausgabe:

{
    "Available": true,
    "FullyQualifiedCNAME": "my-cname.elasticbeanstalk.com"
}

Um eine neue Anwendungsversion zu erstellen

Der folgende Befehl erstellt eine neue Version, „v1", einer Anwendung mit dem Namen" MyApp „:

aws elasticbeanstalk create-application-version --application-name MyApp --version-label v1 --description MyAppv1 --source-bundle S3Bucket="amzn-s3-demo-bucket",S3Key="sample.war" --auto-create-application

Die Anwendung wird aufgrund der auto-create-application Option automatisch erstellt, falls sie noch nicht existiert. Das Quellpaket ist eine .war-Datei, die in einem S3-Bucket namens „amzn-s3-demo-bucket“ gespeichert ist, der die Apache-Tomcat-Beispielanwendung enthält.

Ausgabe:

{
  "ApplicationVersion": {
      "ApplicationName": "MyApp",
      "VersionLabel": "v1",
      "Description": "MyAppv1",
      "DateCreated": "2015-02-03T23:01:25.412Z",
      "DateUpdated": "2015-02-03T23:01:25.412Z",
      "SourceBundle": {
          "S3Bucket": "amzn-s3-demo-bucket",
          "S3Key": "sample.war"
      }
  }
}

Um eine neue Anwendung zu erstellen

Der folgende Befehl erstellt eine neue Anwendung mit dem Namen "MyApp„:

aws elasticbeanstalk create-application --application-name MyApp --description "my application"

Im Befehl create-application werden nur der Name und die Beschreibung der Anwendung konfiguriert. Um den Quellcode für die Anwendung hochzuladen, müssen Sie mit create-application-version eine erste Version der Anwendung erstellen. create-application-version hat auch eine auto-create-application-Option, mit der Sie die Anwendung und die Anwendungsversion in einem Schritt erstellen können.

Ausgabe:

{
  "Application": {
      "ApplicationName": "MyApp",
      "ConfigurationTemplates": [],
      "DateUpdated": "2015-02-12T18:32:21.181Z",
      "Description": "my application",
      "DateCreated": "2015-02-12T18:32:21.181Z"
  }
}

So erstellen Sie eine Konfigurationsvorlage

Im folgenden Befehl wird eine Konfigurationsvorlage namens my-app-v1 mit den Einstellungen erstellt, die auf eine Umgebung mit der ID e-rpqsewtp2j angewendet wurden:

aws elasticbeanstalk create-configuration-template --application-name my-app --template-name my-app-v1 --environment-id e-rpqsewtp2j

Ausgabe:

{
    "ApplicationName": "my-app",
    "TemplateName": "my-app-v1",
    "DateCreated": "2015-08-12T18:40:39Z",
    "DateUpdated": "2015-08-12T18:40:39Z",
    "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
}

So erstellen Sie eine neue Umgebung für eine Anwendung

Im folgenden Befehl wird eine neue Umgebung für Version „v1“ einer Java-Anwendung namens „MyApp“ erstellt:

aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --cname-prefix my-app --version-label v1 --solution-stack-name "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"

Ausgabe:

{
  "ApplicationName": "my-app",
  "EnvironmentName": "my-env",
  "VersionLabel": "v1",
  "Status": "Launching",
  "EnvironmentId": "e-izqpassy4h",
  "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
  "CNAME": "my-app.elasticbeanstalk.com",
  "Health": "Grey",
  "Tier": {
      "Type": "Standard",
      "Name": "WebServer",
      "Version": " "
  },
  "DateUpdated": "2015-02-03T23:04:54.479Z",
  "DateCreated": "2015-02-03T23:04:54.479Z"
}

v1ist die Bezeichnung einer Anwendungsversion, mit der zuvor hochgeladen wurde create-application-version.

So geben Sie eine JSON-Datei zur Definition von Umgebungskonfigurationsoptionen an

Der folgende create-environment-Befehl gibt an, dass eine JSON-Datei namens myoptions.json verwendet werden soll, um Werte zu überschreiben, die aus dem Lösungs-Stack oder der Konfigurationsvorlage abgerufen wurden:

aws elasticbeanstalk create-environment --environment-name sample-env --application-name sampleapp --option-settings file://myoptions.json

myoptions.json ist ein JSON-Objekt, das mehrere Einstellungen definiert:

[
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "Interval",
    "Value": "15"
  },
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "Timeout",
    "Value": "8"
  },
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "HealthyThreshold",
    "Value": "2"
  },
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "UnhealthyThreshold",
    "Value": "3"
  }
]

Weitere Informationen finden Sie unter „Optionswerte“ im Entwicklerhandbuch für AWS Elastic Beanstalk.

So erstellen Sie einen Speicherort

Mit dem folgenden Befehl wird ein Speicherort in Amazon S3 erstellt:

aws elasticbeanstalk create-storage-location

Ausgabe:

{
    "S3Bucket": "elasticbeanstalk-us-west-2-0123456789012"
}

Um eine Anwendungsversion zu löschen

Mit dem folgenden Befehl wird eine Anwendungsversion namens 22a0-stage-150819_182129 der Anwendung my-app gelöscht:

aws elasticbeanstalk delete-application-version --version-label 22a0-stage-150819_182129 --application-name my-app

So löschen Sie eine Anwendung

Der folgenden Befehl löscht eine Anwendung namens my-app:

aws elasticbeanstalk delete-application --application-name my-app

So löschen Sie eine Konfigurationsvorlage

Mit dem folgenden Befehl wird eine Konfigurationsvorlage namens my-template für die Anwendung my-app gelöscht:

aws elasticbeanstalk delete-configuration-template --template-name my-template --application-name my-app

So löschen Sie einen Konfigurationsentwurf

Mit dem folgenden Befehl wird ein Konfigurationsentwurf für eine Umgebung namens my-env gelöscht:

aws elasticbeanstalk delete-environment-configuration --environment-name my-env --application-name my-app

So zeigen Sie Informationen über eine Anwendungsversion an

Mit dem folgenden Befehl werden Informationen über eine Anwendungsversion mit der Bezeichnung v2 abgerufen:

aws elasticbeanstalk describe-application-versions --application-name my-app --version-label "v2"

Ausgabe:

{
    "ApplicationVersions": [
        {
            "ApplicationName": "my-app",
            "VersionLabel": "v2",
            "Description": "update cover page",
            "DateCreated": "2015-07-23T01:32:26.079Z",
            "DateUpdated": "2015-07-23T01:32:26.079Z",
            "SourceBundle": {
                "S3Bucket": "elasticbeanstalk-us-west-2-015321684451",
                "S3Key": "my-app/5026-stage-150723_224258.war"
            }
        },
      {
          "ApplicationName": "my-app",
          "VersionLabel": "v1",
          "Description": "initial version",
          "DateCreated": "2015-07-23T22:26:10.816Z",
          "DateUpdated": "2015-07-23T22:26:10.816Z",
          "SourceBundle": {
              "S3Bucket": "elasticbeanstalk-us-west-2-015321684451",
              "S3Key": "my-app/5026-stage-150723_222618.war"
          }
      }
    ]
}

So zeigen Sie eine Liste von Anwendungen an

Mit dem folgenden Befehl werden Informationen über Anwendungen in der aktuellen Region abgerufen:

aws elasticbeanstalk describe-applications

Ausgabe:

{
    "Applications": [
        {
            "ApplicationName": "ruby",
            "ConfigurationTemplates": [],
            "DateUpdated": "2015-08-13T21:05:44.376Z",
            "Versions": [
                "Sample Application"
            ],
            "DateCreated": "2015-08-13T21:05:44.376Z"
        },
        {
            "ApplicationName": "pythonsample",
            "Description": "Application created from the EB CLI using \"eb init\"",
            "Versions": [
                "Sample Application"
            ],
            "DateCreated": "2015-08-13T19:05:43.637Z",
            "ConfigurationTemplates": [],
            "DateUpdated": "2015-08-13T19:05:43.637Z"
        },
        {
            "ApplicationName": "nodejs-example",
            "ConfigurationTemplates": [],
            "DateUpdated": "2015-08-06T17:50:02.486Z",
            "Versions": [
                "add elasticache",
                "First Release"
            ],
            "DateCreated": "2015-08-06T17:50:02.486Z"
        }
    ]
}

So zeigen Sie Konfigurationsoptionen für eine Umgebung an

Mit dem folgenden Befehl werden Beschreibungen aller verfügbaren Konfigurationsoptionen für eine Umgebung namens my-env abgerufen:

aws elasticbeanstalk describe-configuration-options --environment-name my-env --application-name my-app

Ausgabe (gekürzt):

{
    "Options": [
        {
            "Name": "JVMOptions",
            "UserDefined": false,
            "DefaultValue": "Xms=256m,Xmx=256m,XX:MaxPermSize=64m,JVM Options=",
            "ChangeSeverity": "RestartApplicationServer",
            "Namespace": "aws:cloudformation:template:parameter",
            "ValueType": "KeyValueList"
        },
        {
            "Name": "Interval",
            "UserDefined": false,
            "DefaultValue": "30",
            "ChangeSeverity": "NoInterruption",
            "Namespace": "aws:elb:healthcheck",
            "MaxValue": 300,
            "MinValue": 5,
            "ValueType": "Scalar"
        },
        ...
        {
            "Name": "LowerThreshold",
            "UserDefined": false,
            "DefaultValue": "2000000",
            "ChangeSeverity": "NoInterruption",
            "Namespace": "aws:autoscaling:trigger",
            "MinValue": 0,
            "ValueType": "Scalar"
        },
        {
            "Name": "ListenerEnabled",
            "UserDefined": false,
            "DefaultValue": "true",
            "ChangeSeverity": "Unknown",
            "Namespace": "aws:elb:listener",
            "ValueType": "Boolean"
        }
    ]
}

Die verfügbaren Konfigurationsoptionen variieren je nach Plattform und Konfigurationsversion. Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im Entwicklerhandbuch für AWS Elastic Beanstalk.

So zeigen Sie Konfigurationseinstellungen für eine Umgebung an

Mit dem folgenden Befehl werden Konfigurationseinstellungen für eine Umgebung namens my-env abgerufen:

aws elasticbeanstalk describe-configuration-settings --environment-name my-env --application-name my-app

Ausgabe (gekürzt):

{
    "ConfigurationSettings": [
        {
            "ApplicationName": "my-app",
            "EnvironmentName": "my-env",
            "Description": "Environment created from the EB CLI using \"eb create\"",
            "DeploymentStatus": "deployed",
            "DateCreated": "2015-08-13T19:16:25Z",
            "OptionSettings": [
                {
                    "OptionName": "Availability Zones",
                    "ResourceName": "AWSEBAutoScalingGroup",
                    "Namespace": "aws:autoscaling:asg",
                    "Value": "Any"
                },
                {
                    "OptionName": "Cooldown",
                    "ResourceName": "AWSEBAutoScalingGroup",
                    "Namespace": "aws:autoscaling:asg",
                    "Value": "360"
                },
                ...
                {
                    "OptionName": "ConnectionDrainingTimeout",
                    "ResourceName": "AWSEBLoadBalancer",
                    "Namespace": "aws:elb:policies",
                    "Value": "20"
                },
                {
                    "OptionName": "ConnectionSettingIdleTimeout",
                    "ResourceName": "AWSEBLoadBalancer",
                    "Namespace": "aws:elb:policies",
                    "Value": "60"
                }
            ],
            "DateUpdated": "2015-08-13T23:30:07Z",
            "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
        }
    ]
}

Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im Entwicklerhandbuch für AWS Elastic Beanstalk.

So zeigen Sie den Zustand einer Umgebung an

Mit dem folgenden Befehl werden allgemeine Zustandsinformationen für eine Umgebung namens my-env abgerufen:

aws elasticbeanstalk describe-environment-health --environment-name my-env --attribute-names All

Ausgabe:

{
    "Status": "Ready",
    "EnvironmentName": "my-env",
    "Color": "Green",
    "ApplicationMetrics": {
        "Duration": 10,
        "Latency": {
            "P99": 0.004,
            "P75": 0.002,
            "P90": 0.003,
            "P95": 0.004,
            "P85": 0.003,
            "P10": 0.001,
            "P999": 0.004,
            "P50": 0.001
        },
        "RequestCount": 45,
        "StatusCodes": {
            "Status3xx": 0,
            "Status2xx": 45,
            "Status5xx": 0,
            "Status4xx": 0
        }
    },
    "RefreshedAt": "2015-08-20T21:09:18Z",
    "HealthStatus": "Ok",
    "InstancesHealth": {
        "Info": 0,
        "Ok": 1,
        "Unknown": 0,
        "Severe": 0,
        "Warning": 0,
        "Degraded": 0,
        "NoData": 0,
        "Pending": 0
    },
    "Causes": []
}

Zustandsinformationen sind nur für Umgebungen verfügbar, bei denen erweiterte Zustandsberichte aktiviert sind. Weitere Informationen finden Sie unter „Erweiterte Zustandsberichte und Überwachung“ im Entwicklerhandbuch für AWS Elastic Beanstalk.

Um Informationen zu den AWS Ressourcen in Ihrer Umgebung anzuzeigen

Mit dem folgenden Befehl werden Informationen über Ressourcen in einer Umgebung namens my-env abgerufen:

aws elasticbeanstalk describe-environment-resources --environment-name my-env

Ausgabe:

{
    "EnvironmentResources": {
        "EnvironmentName": "my-env",
        "AutoScalingGroups": [
            {
                "Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingGroup-QSB2ZO88SXZT"
            }
        ],
        "Triggers": [],
        "LoadBalancers": [
            {
                "Name": "awseb-e-q-AWSEBLoa-1EEPZ0K98BIF0"
            }
        ],
        "Queues": [],
        "Instances": [
            {
                "Id": "i-0c91c786"
            }
        ],
        "LaunchConfigurations": [
            {
                "Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingLaunchConfiguration-1UUVQIBC96TQ2"
            }
        ]
    }
}

So zeigen Sie Informationen über eine Umgebung an

Mit dem folgenden Befehl werden Informationen über eine Umgebung namens my-env abgerufen:

aws elasticbeanstalk describe-environments --environment-names my-env

Ausgabe:

{
    "Environments": [
        {
            "ApplicationName": "my-app",
            "EnvironmentName": "my-env",
            "VersionLabel": "7f58-stage-150812_025409",
            "Status": "Ready",
            "EnvironmentId": "e-rpqsewtp2j",
            "EndpointURL": "awseb-e-w-AWSEBLoa-1483140XB0Q4L-109QXY8121.us-west-2.elb.amazonaws.com",
            "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
            "CNAME": "my-env.elasticbeanstalk.com",
            "Health": "Green",
            "AbortableOperationInProgress": false,
            "Tier": {
                "Version": " ",
                "Type": "Standard",
                "Name": "WebServer"
            },
            "DateUpdated": "2015-08-12T18:16:55.019Z",
            "DateCreated": "2015-08-07T20:48:49.599Z"
        }
    ]
}

So zeigen Sie Ereignisse für eine Umgebung an

Mit dem folgenden Befehl werden Ereignisse für eine Umgebung namens my-env abgerufen:

aws elasticbeanstalk describe-events --environment-name my-env

Ausgabe (gekürzt):

{
    "Events": [
        {
            "ApplicationName": "my-app",
            "EnvironmentName": "my-env",
            "Message": "Environment health has transitioned from Info to Ok.",
            "EventDate": "2015-08-20T07:06:53.535Z",
            "Severity": "INFO"
        },
        {
            "ApplicationName": "my-app",
            "EnvironmentName": "my-env",
            "Severity": "INFO",
            "RequestId": "b7f3960b-4709-11e5-ba1e-07e16200da41",
            "Message": "Environment update completed successfully.",
            "EventDate": "2015-08-20T07:06:02.049Z"
        },
        ...
        {
            "ApplicationName": "my-app",
            "EnvironmentName": "my-env",
            "Severity": "INFO",
            "RequestId": "ca8dfbf6-41ef-11e5-988b-651aa638f46b",
            "Message": "Using elasticbeanstalk-us-west-2-012445113685 as Amazon S3 storage bucket for environment data.",
            "EventDate": "2015-08-13T19:16:27.561Z"
        },
        {
            "ApplicationName": "my-app",
            "EnvironmentName": "my-env",
            "Severity": "INFO",
            "RequestId": "cdfba8f6-41ef-11e5-988b-65638f41aa6b",
            "Message": "createEnvironment is starting.",
            "EventDate": "2015-08-13T19:16:26.581Z"
        }
    ]
}

So zeigen Sie den Zustand einer Umgebung an

Der folgende Befehl ruft Zustandsinformationen für Instances in einer Umgebung namens my-env ab:

aws elasticbeanstalk describe-instances-health --environment-name my-env --attribute-names All

Ausgabe:

{
    "InstanceHealthList": [
        {
            "InstanceId": "i-08691cc7",
            "ApplicationMetrics": {
                "Duration": 10,
                "Latency": {
                    "P99": 0.006,
                    "P75": 0.002,
                    "P90": 0.004,
                    "P95": 0.005,
                    "P85": 0.003,
                    "P10": 0.0,
                    "P999": 0.006,
                    "P50": 0.001
                },
                "RequestCount": 48,
                "StatusCodes": {
                    "Status3xx": 0,
                    "Status2xx": 47,
                    "Status5xx": 0,
                    "Status4xx": 1
                }
            },
            "System": {
                "LoadAverage": [
                    0.0,
                    0.02,
                    0.05
                ],
                "CPUUtilization": {
                    "SoftIRQ": 0.1,
                    "IOWait": 0.2,
                    "System": 0.3,
                    "Idle": 97.8,
                    "User": 1.5,
                    "IRQ": 0.0,
                    "Nice": 0.1
                }
            },
            "Color": "Green",
            "HealthStatus": "Ok",
            "LaunchedAt": "2015-08-13T19:17:09Z",
            "Causes": []
        }
    ],
    "RefreshedAt": "2015-08-20T21:09:08Z"
}

Zustandsinformationen sind nur für Umgebungen verfügbar, bei denen erweiterte Zustandsberichte aktiviert sind. Weitere Informationen finden Sie unter „Erweiterte Zustandsberichte und Überwachung“ im Entwicklerhandbuch für AWS Elastic Beanstalk.

So zeigen Sie Lösungs-Stacks an

Mit dem folgenden Befehl werden Lösungs-Stacks für alle derzeit verfügbaren und alle in der Vergangenheit verwendeten Plattformkonfigurationen aufgerufen:

aws elasticbeanstalk list-available-solution-stacks

Ausgabe (gekürzt):

{
    "SolutionStacks": [
        "64bit Amazon Linux 2015.03 v2.0.0 running Node.js",
        "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.6",
        "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.5",
        "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.4",
        "64bit Amazon Linux 2015.03 v2.0.0 running Python 3.4",
        "64bit Amazon Linux 2015.03 v2.0.0 running Python 2.7",
        "64bit Amazon Linux 2015.03 v2.0.0 running Python",
        "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Puma)",
        "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Passenger Standalone)",
        "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Puma)",
        "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Passenger Standalone)",
        "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Puma)",
        "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Passenger Standalone)",
        "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 1.9.3",
        "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
        "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 7",
        "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 6",
        "64bit Windows Server Core 2012 R2 running IIS 8.5",
        "64bit Windows Server 2012 R2 running IIS 8.5",
        "64bit Windows Server 2012 running IIS 8",
        "64bit Windows Server 2008 R2 running IIS 7.5",
        "64bit Amazon Linux 2015.03 v2.0.0 running Docker 1.6.2",
        "64bit Amazon Linux 2015.03 v2.0.0 running Multi-container Docker 1.6.2 (Generic)",
        "64bit Debian jessie v2.0.0 running GlassFish 4.1 Java 8 (Preconfigured - Docker)",
        "64bit Debian jessie v2.0.0 running GlassFish 4.0 Java 7 (Preconfigured - Docker)",
        "64bit Debian jessie v2.0.0 running Go 1.4 (Preconfigured - Docker)",
        "64bit Debian jessie v2.0.0 running Go 1.3 (Preconfigured - Docker)",
        "64bit Debian jessie v2.0.0 running Python 3.4 (Preconfigured - Docker)",
    ],
    "SolutionStackDetails": [
        {
            "PermittedFileTypes": [
                "zip"
            ],
            "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Node.js"
        },
        ...
    ]
}

So bauen Sie eine Umgebung wieder auf

Mit dem folgenden Befehl werden die Ressourcen in einer Umgebung namens my-env beendet und neu erstellt:

aws elasticbeanstalk rebuild-environment --environment-name my-env

So fordern Sie detaillierte Protokolle an

Mit dem folgenden Befehl werden Protokolle aus einer Umgebung namens my-env angefordert:

aws elasticbeanstalk request-environment-info --environment-name my-env --info-type tail

Rufen Sie nach dem Anfordern von Protokollen deren Standort mit ab retrieve-environment-info.

So starten Sie Anwendungsserver neu

Mit dem folgenden Befehl werden Anwendungsserver auf allen Instances in einer Umgebung namens my-env neu gestartet:

aws elasticbeanstalk restart-app-server --environment-name my-env

So rufen Sie Tail-Protokolle ab

Mit dem folgenden Befehl wird ein Link zu Protokollen aus einer Umgebung namens my-env abgerufen:

aws elasticbeanstalk retrieve-environment-info --environment-name my-env --info-type tail

Ausgabe:

{
    "EnvironmentInfo": [
        {
            "SampleTimestamp": "2015-08-20T22:23:17.703Z",
            "Message": "https://elasticbeanstalk-us-west-2-0123456789012.s3.amazonaws.com/resources/environments/logs/tail/e-fyqyju3yjs/i-09c1c867/TailLogs-1440109397703.out?AWSAccessKeyId=AKGPT4J56IAJ2EUBL5CQ&Expires=1440195891&Signature=n%2BEalOV6A2HIOx4Rcfb7LT16bBM%3D",
            "InfoType": "tail",
            "Ec2InstanceId": "i-09c1c867"
        }
    ]
}

Sehen Sie sich den Link in einem Browser an. Vor dem Abrufen müssen Protokolle mit request-environment-info angefordert werden.

So tauschen Sie die CNAMES von Umgebungen aus

Mit dem folgenden Befehl werden die zugewiesenen Subdomains zweier Umgebungen ausgetauscht:

aws elasticbeanstalk swap-environment-cnames --source-environment-name my-env-blue --destination-environment-name my-env-green

Um eine Umgebung zu beenden

Mit dem folgenden Befehl wird eine Elastic-Beanstalk-Umgebung namens my-env beendet:

aws elasticbeanstalk terminate-environment --environment-name my-env

Ausgabe:

{
    "ApplicationName": "my-app",
    "EnvironmentName": "my-env",
    "Status": "Terminating",
    "EnvironmentId": "e-fh2eravpns",
    "EndpointURL": "awseb-e-f-AWSEBLoa-1I9XUMP4-8492WNUP202574.us-west-2.elb.amazonaws.com",
    "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
    "CNAME": "my-env.elasticbeanstalk.com",
    "Health": "Grey",
    "AbortableOperationInProgress": false,
    "Tier": {
        "Version": " ",
        "Type": "Standard",
        "Name": "WebServer"
    },
    "DateUpdated": "2015-08-12T19:05:54.744Z",
    "DateCreated": "2015-08-12T18:52:53.622Z"
}

So ändern Sie die Beschreibung einer Anwendungsversion

Mit dem folgenden Befehl wird die Beschreibung einer Anwendungsversion namens 22a0-stage-150819_185942 aktualisiert:

aws elasticbeanstalk update-application-version --version-label 22a0-stage-150819_185942 --application-name my-app --description "new description"

Ausgabe:

{
    "ApplicationVersion": {
        "ApplicationName": "my-app",
        "VersionLabel": "22a0-stage-150819_185942",
        "Description": "new description",
        "DateCreated": "2015-08-19T18:59:17.646Z",
        "DateUpdated": "2015-08-20T22:53:28.871Z",
        "SourceBundle": {
            "S3Bucket": "elasticbeanstalk-us-west-2-0123456789012",
            "S3Key": "my-app/22a0-stage-150819_185942.war"
        }
    }
}

So ändern Sie die Beschreibung einer Anwendung

Mit dem folgenden Befehl wird die Beschreibung einer Anwendung namens my-app aktualisiert:

aws elasticbeanstalk update-application --application-name my-app --description "my Elastic Beanstalk application"

Ausgabe:

{
    "Application": {
        "ApplicationName": "my-app",
        "Description": "my Elastic Beanstalk application",
        "Versions": [
            "2fba-stage-150819_234450",
            "bf07-stage-150820_214945",
            "93f8",
            "fd7c-stage-150820_000431",
            "22a0-stage-150819_185942"
        ],
        "DateCreated": "2015-08-13T19:15:50.449Z",
        "ConfigurationTemplates": [],
        "DateUpdated": "2015-08-20T22:34:56.195Z"
    }
}

So aktualisieren Sie eine Konfigurationsvorlage

Der folgende Befehl entfernt die konfigurierte Konfiguration für CloudWatch benutzerdefinierte Integritätsmetriken ConfigDocument aus einer gespeicherten Konfigurationsvorlage mit dem Namenmy-template:

aws elasticbeanstalk update-configuration-template --template-name my-template --application-name my-app --options-to-remove Namespace=aws:elasticbeanstalk:healthreporting:system,OptionName=ConfigDocument

Ausgabe:

{
    "ApplicationName": "my-app",
    "TemplateName": "my-template",
    "DateCreated": "2015-08-20T22:39:31Z",
    "DateUpdated": "2015-08-20T22:43:11Z",
    "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
}

Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im Entwicklerhandbuch für AWS Elastic Beanstalk.

So aktualisieren Sie eine Umgebung auf eine neue Version

Mit dem folgenden Befehl wird eine Umgebung namens „my-env“ auf Version „v2“ der Anwendung aktualisiert, zu der sie gehört:

aws elasticbeanstalk update-environment --environment-name my-env --version-label v2

Dieser Befehl setzt voraus, dass die Umgebung „my-env“ bereits existiert und zu einer Anwendung gehört, die über eine gültige Anwendungsversion mit der Bezeichnung „v2“ verfügt.

Ausgabe:

{
  "ApplicationName": "my-app",
  "EnvironmentName": "my-env",
  "VersionLabel": "v2",
  "Status": "Updating",
  "EnvironmentId": "e-szqipays4h",
  "EndpointURL": "awseb-e-i-AWSEBLoa-1RDLX6TC9VUAO-0123456789.us-west-2.elb.amazonaws.com",
  "SolutionStackName": "64bit Amazon Linux running Tomcat 7",
  "CNAME": "my-env.elasticbeanstalk.com",
  "Health": "Grey",
  "Tier": {
      "Version": " ",
      "Type": "Standard",
      "Name": "WebServer"
  },
  "DateUpdated": "2015-02-03T23:12:29.119Z",
  "DateCreated": "2015-02-03T23:04:54.453Z"
}

So stellen Sie eine Umgebungsvariable ein

Der folgende Befehl setzt den Wert der Variablen "PARAM1" in der Umgebung „my-env“ auf ": ParamValue

aws elasticbeanstalk update-environment --environment-name my-env --option-settings Namespace=aws:elasticbeanstalk:application:environment,OptionName=PARAM1,Value=ParamValue

Der Parameter option-settings benötigt zusätzlich zum Namen und Wert der Variablen einen Namespace. Elastic Beanstalk unterstützt neben Umgebungsvariablen auch mehrere Namespaces für Optionen.

So konfigurieren Sie Optionseinstellungen mit einer Datei

Mit dem folgenden Befehl werden mehrere Optionen im Namespace aws:elb:loadbalancer mit einer Datei konfiguriert:

aws elasticbeanstalk update-environment --environment-name my-env --option-settings file://options.json

options.json ist ein JSON-Objekt, das mehrere Einstellungen definiert:

[
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "Interval",
    "Value": "15"
  },
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "Timeout",
    "Value": "8"
  },
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "HealthyThreshold",
    "Value": "2"
  },
  {
    "Namespace": "aws:elb:healthcheck",
    "OptionName": "UnhealthyThreshold",
    "Value": "3"
  }
]

Ausgabe:

{
    "ApplicationName": "my-app",
    "EnvironmentName": "my-env",
    "VersionLabel": "7f58-stage-150812_025409",
    "Status": "Updating",
    "EnvironmentId": "e-wtp2rpqsej",
    "EndpointURL": "awseb-e-w-AWSEBLoa-14XB83101Q4L-104QXY80921.sa-east-1.elb.amazonaws.com",
    "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
    "CNAME": "my-env.elasticbeanstalk.com",
    "Health": "Grey",
    "AbortableOperationInProgress": true,
    "Tier": {
        "Version": " ",
        "Type": "Standard",
        "Name": "WebServer"
    },
    "DateUpdated": "2015-08-12T18:15:23.804Z",
    "DateCreated": "2015-08-07T20:48:49.599Z"
}

Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im Entwicklerhandbuch für AWS Elastic Beanstalk.

So validieren Sie Konfigurationseinstellungen

Der folgende Befehl validiert ein Konfigurationsdokument für CloudWatch benutzerdefinierte Metriken:

aws elasticbeanstalk validate-configuration-settings --application-name my-app --environment-name my-env --option-settings file://options.json

options.json ist ein JSON-Dokument, das eine oder mehrere zu validierende Konfigurationseinstellungen enthält:

[
    {
        "Namespace": "aws:elasticbeanstalk:healthreporting:system",
        "OptionName": "ConfigDocument",
        "Value": "{\"CloudWatchMetrics\": {\"Environment\": {\"ApplicationLatencyP99.9\": null,\"InstancesSevere\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": 60,\"InstancesUnknown\": 60,\"ApplicationLatencyP85\": 60,\"InstancesInfo\": null,\"ApplicationRequests2xx\": null,\"InstancesDegraded\": null,\"InstancesWarning\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": null,\"InstancesNoData\": null,\"InstancesPending\": 60,\"ApplicationLatencyP10\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": null,\"InstancesOk\": 60,\"ApplicationRequests3xx\": null,\"ApplicationRequests4xx\": null},\"Instance\": {\"ApplicationLatencyP99.9\": null,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": null,\"ApplicationLatencyP85\": null,\"CPUUser\": 60,\"ApplicationRequests2xx\": null,\"CPUIdle\": null,\"ApplicationLatencyP50\": null,\"ApplicationRequestsTotal\": 60,\"RootFilesystemUtil\": null,\"LoadAverage1min\": null,\"CPUIrq\": null,\"CPUNice\": 60,\"CPUIowait\": 60,\"ApplicationLatencyP10\": null,\"LoadAverage5min\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": 60,\"CPUSystem\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": null,\"InstanceHealth\": null,\"CPUSoftirq\": 60}},\"Version\": 1}"
    }
]

Wenn die von Ihnen angegebenen Optionen für die genannte Umgebung gültig sind, gibt Elastic Beanstalk ein leeres Messages-Array zurück:

{
    "Messages": []
}

Wenn die Validierung fehlschlägt, enthält die Antwort Informationen über den Fehler:

{
    "Messages": [
        {
            "OptionName": "ConfigDocumet",
            "Message": "Invalid option specification (Namespace: 'aws:elasticbeanstalk:healthreporting:system', OptionName: 'ConfigDocumet'): Unknown configuration setting.",
            "Namespace": "aws:elasticbeanstalk:healthreporting:system",
            "Severity": "error"
        }
    ]
}

Weitere Informationen über Namespaces und unterstützte Optionen finden Sie unter „Optionswerte“ im Entwicklerhandbuch für AWS Elastic Beanstalk.