Actualización de las canalizaciones de Amazon OpenSearch Ingestion - Amazon OpenSearch Service
ConsideracionesPermisos necesariosActualización de las canalizacionesImplementaciones azul/verde para actualizaciones de canalización

Actualización de las canalizaciones de Amazon OpenSearch Ingestion

Puede actualizar las canalizaciones de Amazon OpenSearch Ingestion mediante la Consola de administración de AWS, la AWS CLI o la API de OpenSearch Ingestion. OpenSearch Ingestion inicia una implementación azul/verde al actualizar la configuración de la 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:

  • No se puede actualizar el nombre ni la configuración de red de una canalización.

  • 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.

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

  • Al actualizar la configuración del origen, procesador o receptor 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 del origen, procesador o receptor de una canalización, OpenSearch Ingestion actualiza automáticamente la canalización a la última versión secundaria compatible de la versión principal de Data Prepper que la canalización ejecuta. 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 el rol 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 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:

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

Actualización de las canalizaciones

Puede actualizar las canalizaciones de Amazon OpenSearch Ingestion mediante la Consola de administración de AWS, la AWS CLI o la API de OpenSearch Ingestion.

Cómo actualizar una canalización

  1. Inicie sesión en la consola de Amazon OpenSearch 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. A continuación, seleccione una de las opciones de edición.

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

Para actualizar una canalización mediante el AWS CLI, envíe una solicitud update-pipeline. 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

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

Implementaciones azul/verde para actualizaciones de canalización

OpenSearch Ingestion inicia un proceso de implementación azul/verde al actualizar la configuración 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 Ingestion bloquea el escalado automático 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 la configuración del origen, procesador o receptor de una canalización, OpenSearch Ingestion puede actualizar automáticamente la canalización a la última versión secundaria compatible de la versión principal que la canalización ejecuta. Por ejemplo, es posible que tenga version: "2" en la configuración de su canalización y 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 realiza un cambio en la configuración de la canalización, OpenSearch Ingestion la actualiza a la versión 2.1.1.

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