Beispiel: ElastiCache - AWS Elastic Beanstalk
EC2-Classic-PlattformenEC2-VPC (Standard)EC2-VPC (Benutzerdefiniert)

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.

Beispiel: ElastiCache

Die folgenden Beispiele fügen einen Amazon ElastiCache-Cluster zu EC2-Classic- und EC2-VPC-Plattformen (Standard- und benutzerdefinierte Amazon Virtual Private Cloud (Amazon VPC)) hinzu. Weitere Informationen zu diesen Plattformen und darüber, wie Sie bestimmen, welche EC2 für Ihre Region und Ihr AWS-Konto unterstützt, finden Sie unter https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html. Sehen Sie dann im Abschnitt in diesem Thema nach, der für Ihre Plattform gilt.

EC2-Classic-Plattformen

In diesem Beispiel wird ein Amazon ElastiCache-Cluster zu einer Umgebung mit Instances hinzugefügt, die in der EC2-Classic-Plattform gestartet werden. Alle Eigenschaften, die in diesem Beispiel aufgeführt sind, sind die mindestens erforderlichen Eigenschaften, die für jeden Ressourcentyp eingerichtet werden müssen. Sie können das Beispiel unter ElastiCache-Beispiel herunterladen.

Anmerkung

Mit diesem Beispiel werden AWS-Ressourcen erstellt, für die möglicherweise Kosten anfallen. Weitere Informationen zu den Preisen von AWSerhalten Sie unter https://aws.amazon.com/pricing/. Einige Services sind im Umfang des kostenlosen Nutzungskontingents für AWS enthalten. Als Neukunde können Sie diese Services kostenlos testen. Weitere Informationen finden Sie unter https://aws.amazon.com/free/.

In diesem Beispiel gehen Sie wie folgt vor:

  1. Erstellen Sie ein .ebextensions-Verzeichnis im Verzeichnis der obersten Ebene Ihres Quell-Bundles.

  2. Erstellen Sie zwei Konfigurationsdateien mit der Erweiterung .config und speichern Sie sie in Ihrem Verzeichnis .ebextensions. Eine Konfigurationsdatei definiert die Ressourcen und die andere die Optionen.

  3. Stellen Sie Ihre Anwendung in Elastic Beanstalk bereit.

    Für YAML sind konsistente Einrückungen erforderlich. Wählen Sie die entsprechende Einrückungsebene aus, wenn Sie Inhalte in einer Beispielkonfigurationsdatei ersetzen, und stellen Sie sicher, dass Ihr Texteditor Leerzeichen statt Tabulatorzeichen zum Einrücken verwendet.

Erstellen Sie eine Konfigurationsdatei (z. B. elasticache.config), in der die Ressourcen definiert werden. In diesem Beispiel erstellen wir den ElastiCache-Cluster, indem Sie den Namen der ElastiCache-Cluster-Ressource (MyElastiCache) angeben, den Typ deklarieren und dann die Eigenschaften für den Cluster konfigurieren. Im Beispiel wird auf den Namen der ElastiCache-Sicherheitsgruppenressource verwiesen, die in dieser Konfigurationsdatei erstellt und definiert wird. Als Nächstes erstellen Sie eine ElastiCache-Sicherheitsgruppe. Wir definieren den Namen für diese Ressource, deklarieren ihren Typ und fügen eine Beschreibung für die Sicherheitsgruppe hinzu. Schließlich legen wir Ingress-Regeln für die ElastiCache-Gruppe fest, um den Zugriff nur von Instances innerhalb der ElastiCache-Sicherheitsgruppe (MyCacheSecurityGroup) und der Elastic Beanstalk-Sicherheitsgruppe (AWSEBSecurityGroup) zu erlauben. Der Parametername AWSEBSecurityGroup ist ein fester Ressourcennamen von Elastic Beanstalk. Sie müssen AWSEBSecurityGroup zur Ingress-Regel Ihrer ElastiCache-Sicherheitsgruppe hinzufügen, damit Ihre Elastic Beanstalk-Anwendung eine Verbindung zu den Instances in Ihrem ElastiCache-Cluster herstellen kann. 

#This sample requires you to create a separate configuration file that defines the custom option settings for CacheCluster properties.
          
Resources:
  MyElastiCache:
    Type: AWS::ElastiCache::CacheCluster
    Properties:
      CacheNodeType: 
         Fn::GetOptionSetting:
             OptionName : CacheNodeType
             DefaultValue: cache.m1.small
      NumCacheNodes: 
           Fn::GetOptionSetting:
             OptionName : NumCacheNodes
             DefaultValue: 1
      Engine: 
           Fn::GetOptionSetting:
             OptionName : Engine
             DefaultValue: memcached
      CacheSecurityGroupNames:
        - Ref: MyCacheSecurityGroup
  MyCacheSecurityGroup:
    Type: AWS::ElastiCache::SecurityGroup
    Properties:
      Description: "Lock cache down to webserver access only"
  MyCacheSecurityGroupIngress:
    Type: AWS::ElastiCache::SecurityGroupIngress
    Properties:
      CacheSecurityGroupName: 
        Ref: MyCacheSecurityGroup
      EC2SecurityGroupName:
        Ref: AWSEBSecurityGroup

Weitere Informationen zu den Ressourcen, die in dieser Beispielkonfigurationsdatei verwendet wurden, finden Sie unter folgenden Referenzen:

Erstellen Sie eine separate Konfigurationsdatei mit dem Namen options.config und definieren Sie benutzerdefinierte Optionseinstellungen. 

option_settings:
  "aws:elasticbeanstalk:customoption":
     CacheNodeType : cache.m1.small
     NumCacheNodes : 1
     Engine : memcached

Mit diesen Zeilen wird Elastic Beanstalk angewiesen, die Werte für die Eigenschaften CacheNodeType, NumCacheNodes und Engine aus den Werten CacheNodeType, NumCacheNodes und Engine einer Konfigurationsdatei (in diesem Beispiel „options.config“) abzurufen. Diese enthält im Bereich „option_settings“ den Abschnitt aws:elasticbeanstalk:customoption mit einem Name-Wert-Paar, in dem sich der zu verwendende Wert befindet. Im obigen Beispiel werden folglich die Werte "cache.m1.small", "1" and "memcached" verwendet. Mehr über Fn::GetOptionSetting erfahren Sie unter Funktionen.

EC2-VPC (Standard)

In diesem Beispiel wird ein Amazon ElastiCache-Cluster zu einer Umgebung mit Instances hinzugefügt, die in der EC2-VPC-Plattform gestartet werden. Dabei gelten vor allem die Informationen in diesem Abschnitt gilt für ein Szenario, in dem EC2 Instances in der Standard-VPC startet. Alle Eigenschaften in diesem Beispiel sind die mindestens erforderlichen Eigenschaften, die für jeden Ressourcentyp eingerichtet werden müssen. Weitere Informationen zu Standard-VPCs finden Sie unter Ihre Standard-VPC und -Subnetze.

Anmerkung

Mit diesem Beispiel werden AWS-Ressourcen erstellt, für die möglicherweise Kosten anfallen. Weitere Informationen zu den Preisen von AWSerhalten Sie unter https://aws.amazon.com/pricing/. Einige Services sind im Umfang des kostenlosen Nutzungskontingents für AWS enthalten. Als Neukunde können Sie diese Services kostenlos testen. Weitere Informationen finden Sie unter https://aws.amazon.com/free/.

In diesem Beispiel gehen Sie wie folgt vor:

  1. Erstellen Sie ein .ebextensions-Verzeichnis im Verzeichnis der obersten Ebene Ihres Quell-Bundles.

  2. Erstellen Sie zwei Konfigurationsdateien mit der Erweiterung .config und speichern Sie sie in Ihrem Verzeichnis .ebextensions. Eine Konfigurationsdatei definiert die Ressourcen und die andere die Optionen.

  3. Stellen Sie Ihre Anwendung in Elastic Beanstalk bereit.

    Für YAML sind konsistente Einrückungen erforderlich. Wählen Sie die entsprechende Einrückungsebene aus, wenn Sie Inhalte in einer Beispielkonfigurationsdatei ersetzen, und stellen Sie sicher, dass Ihr Texteditor Leerzeichen statt Tabulatorzeichen zum Einrücken verwendet.

Benennen Sie nun die Ressourcenkonfigurationsdatei elasticache.config. Zum Erstellen eines ElastiCache-Cluster geben wir in diesem Beispiel den Namen der ElastiCache-Cluster-Ressource (MyElastiCache) an, deklarieren den Typ und konfigurieren dann die Eigenschaften für den Cluster. Im Beispiel wird auf die ID der Sicherheitsgruppenressource verwiesen, die wir in dieser Konfigurationsdatei erstellt und definiert haben.

Als Nächstes erstellen Sie eine EC2-Sicherheitsgruppe. Wir definieren den Namen für diese Ressource, deklarieren ihren Typ, fügen eine Beschreibung hinzu und legen Ingress-Regeln für die Sicherheitsgruppe fest, um Zugriff nur von Instances innerhalb der Elastic Beanstalk-Sicherheitsgruppe () zu erlauben. (AWSEBSecurityGroup). (Der Parametername AWSEBSecurityGroup ist ein fester Ressourcenname, der von Elastic Beanstalk bereitgestellt wird. Sie müssen AWSEBSecurityGroup zur Ingress-Regel Ihrer ElastiCache-Sicherheitsgruppe hinzufügen, damit Ihre Elastic Beanstalk-Anwendung eine Verbindung zu den Instances in Ihrem ElastiCache-Cluster herstellen kann.)

Die Ingress-Regeln für die EC2-Sicherheitsgruppe definiert auch das IP-Protokoll und die Port-Nummern, auf denen Cache-Knoten Verbindung akzeptieren können. Für Redis ist die Standard-Portnummer 6379.

#This sample requires you to create a separate configuration file that defines the custom option settings for CacheCluster properties.

Resources:
  MyCacheSecurityGroup:
    Type: "AWS::EC2::SecurityGroup"
    Properties:
      GroupDescription: "Lock cache down to webserver access only"
      SecurityGroupIngress :
        - IpProtocol : "tcp"
          FromPort :
            Fn::GetOptionSetting:
              OptionName : "CachePort"
              DefaultValue: "6379"
          ToPort :
            Fn::GetOptionSetting:
              OptionName : "CachePort"
              DefaultValue: "6379"
          SourceSecurityGroupName:
            Ref: "AWSEBSecurityGroup"
  MyElastiCache:
    Type: "AWS::ElastiCache::CacheCluster"
    Properties:
      CacheNodeType:
        Fn::GetOptionSetting:
          OptionName : "CacheNodeType"
          DefaultValue : "cache.t2.micro"
      NumCacheNodes:
        Fn::GetOptionSetting:
          OptionName : "NumCacheNodes"
          DefaultValue : "1"
      Engine:
        Fn::GetOptionSetting:
          OptionName : "Engine"
          DefaultValue : "redis"
      VpcSecurityGroupIds:
        -
          Fn::GetAtt:
            - MyCacheSecurityGroup
            - GroupId

Outputs:
  ElastiCache:
    Description : "ID of ElastiCache Cache Cluster with Redis Engine"
    Value :
      Ref : "MyElastiCache"

Weitere Informationen zu den Ressourcen, die in dieser Beispielkonfigurationsdatei verwendet wurden, finden Sie unter folgenden Referenzen:

Geben Sie als Nächstes der Optionen-Konfigurationsdatei den Namen options.config und definieren Sie benutzerdefinierte Optionseinstellungen. 

option_settings:
  "aws:elasticbeanstalk:customoption":
    CacheNodeType : cache.t2.micro
    NumCacheNodes : 1
    Engine : redis
    CachePort : 6379

Diese Zeilen informieren Elastic Beanstalk, die Werte für die Eigenschaften CacheNodeType, NumCacheNodes, Engine und CachePort aus den Werten CacheNodeType, NumCacheNodes, Engine und CachePort in einer Konfigurationsdatei (in diesem Beispiel options.config) abzurufen. Diese Datei enthält einen aws:elasticbeanstalk:customoption-Abschnitt (unter option_settings) mit Namen-Wert-Paaren mit den tatsächlichen zu verwendenden Werten. Im vorherigen Beispiel würden cache.t2.micro, 1, redis und 6379 für diese Werte verwendet. Mehr über Fn::GetOptionSetting erfahren Sie unter Funktionen.

EC2-VPC (Benutzerdefiniert)

Wenn Sie eine benutzerdefinierte VPC auf der EC2-VPC-Plattform erstellen und sie als die VPC angeben, in die EC2 Instances startet, unterscheidet sich der Vorgang des Hinzufügens eines Amazon ElastiCache-Clusters zu Ihrer Umgebung von dem einer Standard-VPC. Der wesentliche Unterschied besteht darin, dass Sie eine Subnetzgruppe für den ElastiCache-Cluster erstellen müssen. Alle Eigenschaften in diesem Beispiel sind die mindestens erforderlichen Eigenschaften, die für jeden Ressourcentyp eingerichtet werden müssen.

Anmerkung

Mit diesem Beispiel werden AWS-Ressourcen erstellt, für die möglicherweise Kosten anfallen. Weitere Informationen zu den Preisen von AWSerhalten Sie unter https://aws.amazon.com/pricing/. Einige Services sind im Umfang des kostenlosen Nutzungskontingents für AWS enthalten. Als Neukunde können Sie diese Services kostenlos testen. Weitere Informationen finden Sie unter https://aws.amazon.com/free/.

In diesem Beispiel gehen Sie wie folgt vor:

  1. Erstellen Sie ein .ebextensions-Verzeichnis im Verzeichnis der obersten Ebene Ihres Quell-Bundles.

  2. Erstellen Sie zwei Konfigurationsdateien mit der Erweiterung .config und speichern Sie sie in Ihrem Verzeichnis .ebextensions. Eine Konfigurationsdatei definiert die Ressourcen und die andere die Optionen.

  3. Stellen Sie Ihre Anwendung in Elastic Beanstalk bereit.

    Für YAML sind konsistente Einrückungen erforderlich. Wählen Sie die entsprechende Einrückungsebene aus, wenn Sie Inhalte in einer Beispielkonfigurationsdatei ersetzen, und stellen Sie sicher, dass Ihr Texteditor Leerzeichen statt Tabulatorzeichen zum Einrücken verwendet.

Benennen Sie nun die Ressourcenkonfigurationsdatei elasticache.config. Zum Erstellen eines ElastiCache-Cluster geben wir in diesem Beispiel den Namen der ElastiCache-Cluster-Ressource (MyElastiCache) an, deklarieren den Typ und konfigurieren dann die Eigenschaften für den Cluster. Die Eigenschaften im Beispiel verweisen auf den Namen der Subnetzgruppe für den ElastiCache-Cluster und die ID der Sicherheitsgruppenressource, die wir in dieser Konfigurationsdatei erstellen und definieren.

Als Nächstes erstellen Sie eine EC2-Sicherheitsgruppe. Wir definieren den Namen für diese Ressource, deklarieren ihren Typ, fügen eine Beschreibung und die VPC-ID hinzu und legen Ingress-Regeln für die Sicherheitsgruppe fest, um Zugriff nur von Instances innerhalb der Elastic Beanstalk-Sicherheitsgruppe () zu erlauben. (AWSEBSecurityGroup). (Der Parametername AWSEBSecurityGroup ist ein fester Ressourcenname, der von Elastic Beanstalk bereitgestellt wird. Sie müssen AWSEBSecurityGroup zur Ingress-Regel Ihrer ElastiCache-Sicherheitsgruppe hinzufügen, damit Ihre Elastic Beanstalk-Anwendung eine Verbindung zu den Instances in Ihrem ElastiCache-Cluster herstellen kann.)

Die Ingress-Regeln für die EC2-Sicherheitsgruppe definiert auch das IP-Protokoll und die Port-Nummern, auf denen Cache-Knoten Verbindung akzeptieren können. Für Redis ist die Standard-Portnummer 6379. Schließlich erstellt dieses Beispiel eine Subnetzgruppe für den ElastiCache-Cluster. Wir definieren den Namen für diese Ressource, deklarieren ihren Typ und fügen eine Beschreibung und ID des Subnetzes in der Subnetzgruppe hinzu.

Anmerkung

Wir empfehlen, dass Sie private Subnetze für den ElastiCache-Cluster verwenden. Weitere Informationen zu einer VPC mit einem privaten Subnetz finden Sie unter https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Scenario2.html.

#This sample requires you to create a separate configuration file that defines the custom option settings for CacheCluster properties.

Resources:
  MyElastiCache:
    Type: "AWS::ElastiCache::CacheCluster"
    Properties:
      CacheNodeType:
        Fn::GetOptionSetting:
          OptionName : "CacheNodeType"
          DefaultValue : "cache.t2.micro"
      NumCacheNodes:
        Fn::GetOptionSetting:
          OptionName : "NumCacheNodes"
          DefaultValue : "1"
      Engine:
        Fn::GetOptionSetting:
          OptionName : "Engine"
          DefaultValue : "redis"
      CacheSubnetGroupName:
        Ref: "MyCacheSubnets"
      VpcSecurityGroupIds:
        - Ref: "MyCacheSecurityGroup"
  MyCacheSecurityGroup:
    Type: "AWS::EC2::SecurityGroup"
    Properties:
      GroupDescription: "Lock cache down to webserver access only"
      VpcId:
        Fn::GetOptionSetting:
          OptionName : "VpcId"
      SecurityGroupIngress :
        - IpProtocol : "tcp"
          FromPort :
            Fn::GetOptionSetting:
              OptionName : "CachePort"
              DefaultValue: "6379"
          ToPort :
            Fn::GetOptionSetting:
              OptionName : "CachePort"
              DefaultValue: "6379"
          SourceSecurityGroupId:
            Ref: "AWSEBSecurityGroup"
  MyCacheSubnets:
    Type: "AWS::ElastiCache::SubnetGroup"
    Properties:
      Description: "Subnets for ElastiCache"
      SubnetIds:
        Fn::GetOptionSetting:
          OptionName : "CacheSubnets"
Outputs:
  ElastiCache:
    Description : "ID of ElastiCache Cache Cluster with Redis Engine"
    Value :
      Ref : "MyElastiCache"

Weitere Informationen zu den Ressourcen, die in dieser Beispielkonfigurationsdatei verwendet wurden, finden Sie unter folgenden Referenzen:

Geben Sie als Nächstes der Optionen-Konfigurationsdatei den Namen options.config und definieren Sie benutzerdefinierte Optionseinstellungen.

Anmerkung

Im folgenden Beispiel ersetzen Sie die Beispiel-CacheSubnets- und -VpcId-Werte durch Ihre eigenen Subnetze und die VPC.

option_settings:
  "aws:elasticbeanstalk:customoption":
    CacheNodeType : cache.t2.micro
    NumCacheNodes : 1
    Engine : redis
    CachePort : 6379
    CacheSubnets:
      - subnet-1a1a1a1a
      - subnet-2b2b2b2b
      - subnet-3c3c3c3c
    VpcId: vpc-4d4d4d4d

Diese Zeilen informieren Elastic Beanstalk, die Werte für die Eigenschaften CacheNodeType, NumCacheNodes, Engine, CachePort, CacheSubnets und VpcId aus den Werten CacheNodeType, NumCacheNodes, Engine, CachePort, CacheSubnets und VpcId in einer Konfigurationsdatei (in diesem Beispiel options.config) abzurufen. Diese Datei enthält einen aws:elasticbeanstalk:customoption-Abschnitt (unter option_settings) mit Namen-Wert-Paaren mit den Beispielwerten. Im vorherigen Beispiel würden cache.t2.micro, 1, redis, 6379, subnet-1a1a1a1a, subnet-2b2b2b2b, subnet-3c3c3c3c und vpc-4d4d4d4d für diese Werte verwendet. Mehr über Fn::GetOptionSetting erfahren Sie unter Funktionen.