Wie kann ich ein In-Place-Upgrade oder Ersatz-Upgrade für meine AWS-Elasticsearch-Domänenressource in CloudFormation durchführen?

Kurzbeschreibung

Um ein In-Place-Upgrade für Ihre AWS-Elasticsearch-Domänenressource durchzuführen, müssen Sie in Ihrer CloudFormation-Vorlage ein UpdatePolicy-Attribut namens EnableVersionUpgrade verwenden. Sie können die EnableVersionUpgrade-Richtlinie verwenden, um In-Place-Upgrades für eine Amazon-OpenSearch-Service-Domäne zu aktivieren oder zu deaktivieren.

Bevor Sie ein In-Place-Upgrade oder ein Ersatz-Upgrade durchführen, sollten Sie Folgendes beachten:

• Amazon OpenSearch Service unterstützt direkte OpenSearch-Service-Upgrades für Versionen 5.1 oder höher.
• Wenn Sie den Wert der Eigenschaft EngineVersion während eines Stack-Updates ändern, führt CloudFormation ein Ersatz-Update für eine OpenSearch Service-Domäne durch. Dann erstellt CloudFormation eine neue Domäne.
• Mit einem In-Place-Upgrade können Sie den Upgrade-Verlauf Ihrer Domäne verfolgen und dieselbe Domänenendpunkt-URL beibehalten. Sie müssen keine Konfigurationsänderungen an den Diensten vornehmen, die mit Ihrer Domäne verbunden sind. Diese Dienste haben Zugriff auf die neue Version Ihrer Domäne.
• Ein Ersatz-Upgrade ermöglicht es Ihnen nicht, den Upgrade-Verlauf zu verfolgen. Die alte Domäne wird durch eine neue Domäne und eine neue Endpunkt-URL für diese Domäne ersetzt. Damit die Services, die mit Ihrer Domäne verbunden sind, auf die neue Domäne zugreifen können, müssen Sie Konfigurationsänderungen an Ihren Diensten vornehmen. Weitere Informationen finden Sie unter Erstellen und Verwalten von Amazon-OpenSearch-Service-Domänen.

Lösung

1.    Fügen Sie in Ihrer CloudFormation-Stack-Vorlage die Aktualisierungsrichtlinie EnableVersionUpgrade hinzu.

2.    Damit CloudFormation ein In-Place-Upgrade durchführen kann, setzen Sie EnableVersionUpgrade auf true und geben Sie für ElasticsearchVersion den Wert Ihrer Version an.

-oder-

Um die Ressource AWS-Elasticsearch-Domäne durch eine neue AWS-Elasticsearch-Domäne zu ersetzen, setzen Sie EnableVersionUpgrade auf false oder geben Sie keinen Wert an.

Beispielsweise ist in der folgenden Vorlage das Attribut UpdatePolicy für ein In-Place-Upgrade konfiguriert:

>AWSTemplateFormatVersion: 2010-09-09
Description: AWS CloudFormation sample template to launch an Amazon OpenSearch Service Domain. Performing an update using the same template and supplying a different ElasticsearchVersion will perform an in-place upgrade for an Elasticsearch Domain resource.
Parameters:
  ElasticsearchVersion:
    Type: String
    AllowedValues: ['5.6', '5.5', '5.3', '5.1', '6.8', '6.7', '6.5', '6.4', '6.3', '6.2', '6.0', '7.4', '7.1']
    Default: 5.3
    Description: The version of Amazon OpenSearch Service to use.
  InstanceTypeForDataNode:
    Type: String
    Default: m3.medium.elasticsearch
    Description: The instance type for your data nodes.
  NumberOfDataNodes:
    Type: String
    Default: 1
    Description: The number of data nodes (instances) to use in the OpenSearch Service domain.
Resources:
  ElasticSearchDomain:
    Type: AWS::Elasticsearch::Domain
    UpdatePolicy:
       EnableVersionUpgrade: true   ### In-place Upgrade
    Properties:
      ElasticsearchClusterConfig:
        InstanceCount: !Ref NumberOfDataNodes
        InstanceType: !Ref InstanceTypeForDataNode
      ElasticsearchVersion: !Ref ElasticsearchVersion

3.    Aktualisieren Sie Ihren Stack entweder über die CloudFormation-Konsole oder die AWS Command Line Interface (AWS CLI), um das In-Place-Upgrade oder Ersatz-Upgrade abzuschließen.

Zugehörige Informationen

Upgrading von Amazon-OpenSearch-Service-Domänen