Actualización de las canalizaciones OpenSearch de Amazon Ingestion

Puede actualizar las canalizaciones OpenSearch de Amazon Ingestion mediante la AWS Management Console, la o la AWS CLI API de OpenSearch ingestión. OpenSearch Ingestion inicia una implementación azul/verde al actualizar la configuración YAML de una canalización. Para obtener más información, consulte Implementaciones azul/verde para actualizaciones de canalización.

Consideraciones

Tenga en cuenta lo siguiente cuando actualice una canalización:

• Puede editar los límites de capacidad, las opciones de publicación de registros y la configuración de YAML de una canalización. No puede editar su nombre ni su configuración de red.

• Si su canalización escribe en un receptor de dominio de VPC, no puede volver atrás y cambiar el receptor a un dominio de VPC diferente una vez creada la canalización. Debe eliminar y volver a crear manualmente la canalización con el nuevo receptor. Aún puede cambiar el receptor de un dominio de VPC a un dominio público, de un dominio público a un dominio de VPC o de un dominio público a otro dominio público.

• Puedes cambiar el receptor de canalización en cualquier momento entre un dominio de OpenSearch servicio público y una colección sin servidor. OpenSearch

• Al actualizar la configuración de YAML de una canalización, OpenSearch Ingestion inicia una implementación azul/verde. Para obtener más información, consulte Implementaciones azul/verde para actualizaciones de canalización.

• Al actualizar la configuración YAML de una canalización, OpenSearch Ingestion la actualiza automáticamente a la última versión secundaria compatible de la versión principal de Data Prepper especificada en la configuración de la canalización. Este proceso mantiene su canalización actualizada con las últimas correcciones de errores y mejoras de rendimiento.

• Puede seguir actualizando su canalización cuando esté detenida.

Permisos necesarios

OpenSearch Ingestion utiliza los siguientes permisos de IAM para actualizar las canalizaciones:

• osis:UpdatePipeline: Actualizar una canalización.

• osis:ValidatePipeline: Comprobar si la configuración de la canalización es válida.

• iam:PassRole— Transfiera la función de canalización a OpenSearch Ingestion para que pueda escribir datos en el dominio. Este permiso solo es necesario si actualiza la configuración de YAML de la canalización, no si modifica otros ajustes, como la publicación de registros o los límites de capacidad.

Por ejemplo, la siguiente política concede permiso para actualizar una canalización:

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Resource":"*",
         "Action":[
            "osis:UpdatePipeline",
            "osis:ValidatePipeline"
         ]
      },
      {
         "Resource":[
            "arn:aws:iam::{your-account-id}:role/{pipeline-role}"
         ],
         "Effect":"Allow",
         "Action":[
            "iam:PassRole"
         ]
      }
   ]
}

Actualización de las canalizaciones

Puede actualizar las canalizaciones OpenSearch de Amazon Ingestion mediante la AWS Management Console, la o la AWS CLI API de OpenSearch ingestión.

Consola

Cómo actualizar una canalización

1. Inicia sesión en la consola OpenSearch de Amazon Service en https://console.aws.amazon.com/aos/home.

2. Seleccione Canalizaciones en el panel de navegación izquierdo.

3. Seleccione una canalización para abrir su configuración. Puede editar los límites de capacidad, las opciones de publicación de registros y la configuración de YAML de una canalización. No puede editar su nombre ni su configuración de red.

4. Cuando termine de realizar los cambios, seleccione Guardar.

CLI

Para actualizar una canalización mediante el AWS CLI, envía una solicitud de actualización de la canalización. En el siguiente ejemplo de solicitud, se carga un nuevo archivo de configuración y se actualizan los valores de capacidad mínima y máxima:

aws osis update-pipeline \
  --pipeline-name "my-pipeline" \
  --pipline-configuration-body "file://new-pipeline-config.yaml" \
  --min-units 11 \
  --max-units 18

OpenSearch API de ingestión

Para actualizar una canalización OpenSearch de ingestión mediante la API de OpenSearch ingestión, llama a la operación. UpdatePipeline

Implementaciones azul/verde para actualizaciones de canalización

OpenSearch La ingestión inicia un proceso de despliegue azul o verde al actualizar la configuración YAML de una canalización.

Azul/Verde se refiere a la práctica de crear un nuevo entorno para actualizaciones de canalización y redirigir el tráfico al nuevo entorno una vez completadas dichas actualizaciones. La práctica minimiza el tiempo de inactividad y mantiene el entorno original en caso de que la implementación en el nuevo entorno no se produzca correctamente. Las implementaciones azul/verde en sí mismas no tienen ningún impacto en el rendimiento, pero este puede cambiar si la configuración de la canalización cambia de una manera que altere el rendimiento.

OpenSearch La ingestión bloquea el autoescalado durante las implementaciones azul/verde. Se le seguirá cobrando solo por el tráfico a la canalización anterior hasta que se redirija a la nueva canalización. Una vez que se haya redirigido el tráfico, solo se cobrará por la nueva canalización. Nunca se le cobrará por dos canalizaciones simultáneamente.

Al actualizar el archivo de configuración YAML de una canalización, OpenSearch Ingestion puede actualizarla automáticamente a la última versión secundaria compatible de la versión principal de Data Prepper especificada en la configuración de la canalización. Por ejemplo, es posible que tengas una version: "2" configuración de canalización e OpenSearch Ingestion aprovisionó inicialmente la canalización con la versión 2.1.0. Cuando se añade la compatibilidad con la versión 2.1.1 y realizas un cambio en la configuración de la canalización, OpenSearch Ingestion la actualiza a la versión 2.1.1.

Este proceso mantiene tu canalización actualizada con las últimas correcciones de errores y mejoras de rendimiento. OpenSearch Ingestion no puede actualizar la versión principal de tu canalización a menos que cambies manualmente la version opción en la configuración de la canalización.