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