Mise à jour des pipelines OpenSearch Amazon Ingestion

Vous pouvez mettre à jour les pipelines Amazon OpenSearch Ingestion à l' AWS Management Console aide de l'API AWS CLI, de ou de l'API d' OpenSearch ingestion. OpenSearch L'ingestion lance un déploiement bleu/vert lorsque vous mettez à jour la configuration YAML d'un pipeline. Pour plus d’informations, consultez Déploiements bleu/vert pour les mises à jour du pipeline.

Considérations

Lorsque vous mettez à jour un pipeline, tenez compte des points suivants :

• Vous pouvez modifier les limites de capacité d'un pipeline, les options de publication des journaux et la configuration YAML. Vous ne pouvez pas modifier son nom ni ses paramètres réseau.

• Si votre pipeline écrit sur un récepteur de domaine VPC, vous ne pouvez pas revenir en arrière et remplacer le récepteur par un autre domaine VPC une fois le pipeline créé. Vous devez supprimer et recréer le pipeline avec le nouveau récepteur. Vous pouvez toujours faire passer le récepteur d'un domaine VPC à un domaine public, d'un domaine public à un domaine VPC ou d'un domaine public à un autre domaine public.

• Vous pouvez à tout moment faire basculer le récepteur du pipeline entre un domaine OpenSearch de service public et une collection OpenSearch sans serveur.

• Lorsque vous mettez à jour la configuration YAML d'un pipeline, OpenSearch Ingestion lance un déploiement bleu/vert. Pour plus d’informations, consultez Déploiements bleu/vert pour les mises à jour du pipeline.

• Lorsque vous mettez à jour la configuration YAML d'un pipeline, OpenSearch Ingestion met automatiquement à niveau votre pipeline vers la dernière version mineure prise en charge de la version principale de Data Prepper spécifiée dans la configuration du pipeline. Ce processus permet de maintenir votre pipeline à jour avec les dernières corrections de bogues et améliorations de performances.

• Vous pouvez toujours apporter des mises à jour à votre pipeline lorsqu'il est arrêté.

Autorisations nécessaires

OpenSearch L'ingestion utilise les autorisations IAM suivantes pour mettre à jour les pipelines :

• osis:UpdatePipeline— Mettez à jour un pipeline.

• osis:ValidatePipeline— Vérifiez si une configuration de pipeline est valide.

• iam:PassRole— Transmettez le rôle de pipeline à OpenSearch Ingestion afin qu'elle puisse écrire des données dans le domaine. Cette autorisation n'est requise que si vous mettez à jour la configuration YAML du pipeline, et non si vous modifiez d'autres paramètres tels que la publication des journaux ou les limites de capacité.

Par exemple, la politique suivante autorise la mise à jour d'un pipeline :

{
   "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"
         ]
      }
   ]
}

Mise à jour des pipelines

Vous pouvez mettre à jour les pipelines Amazon OpenSearch Ingestion à l' AWS Management Console aide de l'API AWS CLI, de ou de l'API d' OpenSearch ingestion.

Console

Pour mettre à jour un pipeline

1. Connectez-vous à la console Amazon OpenSearch Service à l'adresse https://console.aws.amazon.com/aos/home.

2. Choisissez Pipelines dans le volet de navigation de gauche.

3. Choisissez un pipeline pour ouvrir ses paramètres. Vous pouvez modifier les limites de capacité d'un pipeline, les options de publication des journaux et la configuration YAML. Vous ne pouvez pas modifier son nom ni ses paramètres réseau.

4. Une fois les modifications terminées, choisissez Save (Enregistrer).

INTERFACE DE LIGNE DE COMMANDE (CLI)

Pour mettre à jour un pipeline à l'aide du AWS CLI, envoyez une demande de mise à jour du pipeline. L'exemple de demande suivant télécharge un nouveau fichier de configuration et met à jour les valeurs de capacité minimale et maximale :

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

OpenSearch API d'ingestion

Pour mettre à jour un pipeline d' OpenSearch ingestion à l'aide de OpenSearch l'API d'ingestion, appelez l'UpdatePipelineopération.

Déploiements bleu/vert pour les mises à jour du pipeline

OpenSearch L'ingestion lance un processus de déploiement bleu/vert lorsque vous mettez à jour la configuration YAML d'un pipeline.

Le bleu/vert fait référence à la pratique consistant à créer un nouvel environnement pour les mises à jour du pipeline et à acheminer le trafic vers le nouvel environnement une fois ces mises à jour terminées. Cette méthode permet de réduire les temps d'arrêt et de gérer l'environnement d'origine en cas d'échec du déploiement vers le nouvel environnement. Les déploiements bleu/vert eux-mêmes n'ont aucun impact sur les performances, mais les performances peuvent changer si la configuration de votre pipeline change d'une manière qui altère les performances.

OpenSearch L'ingestion bloque l'auto-scaling lors des déploiements bleu/vert. Vous continuez à être facturé uniquement pour le trafic vers l'ancien pipeline jusqu'à ce qu'il soit redirigé vers le nouveau pipeline. Une fois le trafic redirigé, vous n'êtes facturé que pour le nouveau pipeline. Vous n'êtes jamais facturé pour deux pipelines simultanément.

Lorsque vous mettez à jour le fichier de configuration YAML d'un pipeline OpenSearch , Ingestion peut automatiquement mettre à niveau votre pipeline vers la dernière version mineure prise en charge de la version principale de Data Prepper spécifiée dans la configuration du pipeline. Par exemple, vous avez version: "2" peut-être intégré la configuration de votre pipeline et OpenSearch Ingestion a initialement provisionné le pipeline avec la version 2.1.0. Lorsque la prise en charge de la version 2.1.1 est ajoutée et que vous modifiez la configuration de votre pipeline, OpenSearch Ingestion met à niveau votre pipeline vers la version 2.1.1.

Ce processus permet de maintenir votre pipeline à jour avec les dernières corrections de bogues et améliorations de performances. OpenSearch Ingestion ne peut pas mettre à jour la version principale de votre pipeline à moins que vous ne changiez manuellement l'versionoption dans la configuration du pipeline.