View a markdown version of this page

Mise à niveau d'un domaine (CLI) - Amazon OpenSearch Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise à niveau d'un domaine (CLI)

Vous pouvez utiliser les opérations suivantes pour identifier la version correcte de OpenSearch ou Elasticsearch pour votre domaine, lancez une mise à niveau sur place ou basée sur un clone, effectuez la vérification préalable à la mise à niveau et consultez la progression :

  • get-compatible-versions (GetCompatibleVersions)

  • upgrade-domain (UpgradeDomain)

  • get-upgrade-status (GetUpgradeStatus)

  • get-upgrade-history (GetUpgradeHistory)

  • describe-domain-change-progress (DescribeDomainChangeProgress) — Surveille une mise à niveau basée sur un clone.

  • update-clone (UpdateClone) — Déplace le trafic de lecture vers le cluster cloné, interrompt, annule et gère la période de rétention pour une mise à niveau basée sur un clone.

In-place mettre à niveau

Pour vérifier si votre domaine est éligible sans démarrer de mise à niveau, utilisez le --perform-check-only option :

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

Pour démarrer la mise à niveau, exécutez la même commande sans --perform-check-only:

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

Pour voir la progression, utilisez get-upgrade-status:

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

Clone-based mettre à niveau

Une mise à niveau basée sur un clone comporte plus d'étapes qu'une mise à niveau sur place. Pour plus d'informations sur chaque étape, voir Validation, découpage et restauration lors d'une mise à niveau basée sur un clone.

Démarrez la mise à niveau

Pour démarrer une mise à niveau basée sur un clone, exécutez upgrade-domain avec DeploymentStrategy réglé sur ClonedBlueGreen dans --deployment-strategy-options. La durée de conservation est facultative. Le maximum est de 336 heures (14 jours). Pour demander une période plus longue, contactez AWS soutien.

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

La réponse comprend un ChangeId. Utilisez-le pour surveiller la mise à niveau :

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

Quand le ConfigChangeStatus est PendingUserInput, le cluster cloné est prêt à être validé.

Déplacer le trafic de lecture vers le cluster cloné

CloneReadTrafficPercent est la part des requêtes de lecture envoyées au cluster cloné, comprise entre 0 et 100. Les écritures sont toujours dirigées vers le cluster principal.

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

Passer au cluster cloné

Définissez Target sur ClonedCluster.

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

Annuler la mise à niveau avant la mise en service

Set Target pour PrimaryCluster. OpenSearch Le service supprime le cluster cloné et votre domaine reste tel quel.

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

Définir ou modifier la période de conservation

Vous pouvez définir ou modifier la période de conservation avant ou après la coupure.

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

Fin anticipée de la période de conservation

Après le basculement, vous pouvez revenir au cluster principal ou supprimer le cluster principal dès maintenant.

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

Pour plus d'informations, consultez le AWS Référence des commandes CLI et Amazon OpenSearch Référence de l'API de service.