View a markdown version of this page

Aktualisierung einer Domain (CLI) - Amazon OpenSearch Bedienung

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.

Aktualisierung einer Domain (CLI)

Sie können die folgenden Operationen verwenden, um die richtige Version von zu identifizieren OpenSearch oder Elasticsearch für Ihre Domain, starten Sie ein direktes oder klonbasiertes Upgrade, führen Sie die Überprüfung vor dem Upgrade durch und sehen Sie sich den Fortschritt an:

  • get-compatible-versions (GetCompatibleVersions)

  • upgrade-domain (UpgradeDomain)

  • get-upgrade-status (GetUpgradeStatus)

  • get-upgrade-history (GetUpgradeHistory)

  • describe-domain-change-progress (DescribeDomainChangeProgress) — Überwacht ein klonbasiertes Upgrade.

  • update-clone (UpdateClone) — Leitet den Lesetraffic auf den geklonten Cluster um, unterbricht und verwaltet den Aufbewahrungszeitraum für ein Clone-basiertes Upgrade.

In-place aufrüsten

Um zu überprüfen, ob Ihre Domain berechtigt ist, ohne ein Upgrade zu starten, verwenden Sie den --perform-check-only Option:

aws opensearch upgrade-domain \ --domain-name my-domain \ --target-version OpenSearch_2.19 \ --perform-check-only

Um das Upgrade zu starten, führen Sie denselben Befehl ohne --perform-check-only:

aws opensearch upgrade-domain \ --domain-name my-domain \ --target-version OpenSearch_2.19

Um den Fortschritt anzuzeigen, verwenden Sie get-upgrade-status:

aws opensearch get-upgrade-status --domain-name my-domain

Clone-based aufrüsten

Ein klonbasiertes Upgrade umfasst mehr Schritte als ein direktes Upgrade. Informationen zu den einzelnen Schritten finden Sie unter Validierung, Umstellung und Rollback während eines klonbasierten Upgrades.

Starten Sie das Upgrade

Um ein klonbasiertes Upgrade zu starten, führen Sie Folgendes aus upgrade-domain mit DeploymentStrategy gesetzt auf ClonedBlueGreen in --deployment-strategy-options. Die Aufbewahrungsfrist ist optional. Das Maximum beträgt 336 Stunden (14 Tage). Um einen längeren Zeitraum anzufordern, wenden Sie sich an AWS Unterstützung.

aws opensearch upgrade-domain \ --domain-name my-domain \ --target-version OpenSearch_3.1 \ --deployment-strategy-options 'DeploymentStrategy=ClonedBlueGreen,ClonedBlueGreenOptions={RetentionOptions={RetentionInHours=48}}'

Die Antwort beinhaltet eine ChangeId. Verwenden Sie es, um das Upgrade zu überwachen:

aws opensearch describe-domain-change-progress \ --domain-name my-domain \ --change-id 9f1c2b7a-4d3e-4e21-9a5f-0c8b7d6e5f40

Wann der ConfigChangeStatus ist PendingUserInput, der geklonte Cluster ist bereit für Sie zur Validierung.

Leiten Sie den Leseverkehr auf den geklonten Cluster um

CloneReadTrafficPercent ist der Anteil der Leseanforderungen, die an den geklonten Cluster gehen, von 0 bis 100. Schreibvorgänge werden immer an den primären Cluster gesendet.

aws opensearch update-clone \ --domain-name my-domain \ --traffic-split-options Strategy=ShiftReadTrafficPercent,CloneReadTrafficPercent=10

Wechseln Sie zum geklonten Cluster

Setzen Sie Target auf ClonedCluster.

aws opensearch update-clone \ --domain-name my-domain \ --cutover-options Target=ClonedCluster

Brechen Sie das Upgrade vor der Umstellung ab

Einstellen Target zu PrimaryCluster. OpenSearch Der Service löscht den geklonten Cluster und Ihre Domain bleibt unverändert.

aws opensearch update-clone \ --domain-name my-domain \ --cutover-options Target=PrimaryCluster

Legen Sie den Aufbewahrungszeitraum fest oder ändern Sie ihn

Sie können den Aufbewahrungszeitraum vor oder nach der Umstellung festlegen oder ändern.

aws opensearch update-clone \ --domain-name my-domain \ --retention-options RetentionInHours=24

Beenden Sie die Aufbewahrungsfrist vorzeitig

Nach der Umstellung können Sie zum primären Cluster zurückkehren oder den primären Cluster jetzt löschen.

aws opensearch update-clone \ --domain-name my-domain \ --retention-options '{"RetentionAction":"RollbackToPrimaryCluster"}'
aws opensearch update-clone \ --domain-name my-domain \ --retention-options '{"RetentionAction":"DeletePrimaryCluster"}'

Weitere Informationen finden Sie in der AWS CLI-Befehlsreferenz und Amazon OpenSearch Referenz zur Service-API.