View a markdown version of this page

Actualización de un dominio (CLI) - Amazon OpenSearch Servicio

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Actualización de un dominio (CLI)

Puede utilizar las siguientes operaciones para identificar la versión correcta de OpenSearch o Elasticsearch para tu dominio, inicia una actualización local o basada en clones, realiza la comprobación previa a la actualización y consulta el progreso:

  • get-compatible-versions (GetCompatibleVersions)

  • upgrade-domain (UpgradeDomain)

  • get-upgrade-status (GetUpgradeStatus)

  • get-upgrade-history (GetUpgradeHistory)

  • describe-domain-change-progress (DescribeDomainChangeProgress) — Supervisa una actualización basada en clones.

  • update-clone (UpdateClone) — Transfiere el tráfico de lectura al clúster clonado, interrumpe, cancela y administra el período de retención de una actualización basada en la clonación.

In-place mejorar

Para comprobar si tu dominio cumple los requisitos sin iniciar una actualización, usa --perform-check-only opción:

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

Para iniciar la actualización, ejecute el mismo comando sin --perform-check-only:

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

Para ver el progreso, usa get-upgrade-status:

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

Clone-based mejorar

Una actualización basada en clones tiene más pasos que una actualización local. Para obtener información sobre cada paso, consulte Validar, cortar y deshacer durante una actualización basada en clones.

Inicie la actualización

Para iniciar una actualización basada en clones, ejecute upgrade-domain con DeploymentStrategy establecido en ClonedBlueGreen en --deployment-strategy-options. El período de retención es opcional. El máximo es de 336 horas (14 días). Para solicitar un período más largo, póngase en contacto con AWS Soporte.

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

La respuesta incluye un ChangeId. Úselo para supervisar la actualización:

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

Cuando el ConfigChangeStatus es PendingUserInput, el clúster clonado está listo para que lo valides.

Cambie el tráfico de lectura al clúster clonado

CloneReadTrafficPercent es el porcentaje de solicitudes de lectura que van al clúster clonado, de 0 a 100. Las escrituras siempre van al clúster principal.

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

Diríjase al clúster clonado

Establece Target en ClonedCluster.

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

Cancele la actualización antes de la transición

Establecer Target a PrimaryCluster. OpenSearch El servicio elimina el clúster clonado y su dominio permanece como estaba.

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

Establece o cambia el período de retención

Puedes establecer o cambiar el período de retención antes o después de la transición.

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

Finalice el período de retención antes de tiempo

Tras la transición, puede volver al clúster principal o eliminarlo ahora.

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

Para obtener más información, consulte AWS Referencia de comandos de la CLI y Amazon OpenSearch Referencia de API de servicio.