Aktualisierung der Amazon OpenSearch Ingestion-Pipelines - OpenSearch Amazon-Dienst

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktualisierung der Amazon OpenSearch Ingestion-Pipelines

Sie können Amazon OpenSearch Ingestion-Pipelines mithilfe der AWS Management Console, der oder der AWS CLI OpenSearch Ingestion-API aktualisieren. OpenSearch Ingestion initiiert eine Bereitstellung, wenn Sie eine blue/green Pipeline-Konfiguration aktualisieren. Weitere Informationen finden Sie unter Blaue/grüne Bereitstellungen für Pipeline-Updates.

Überlegungen

Beachten Sie beim Aktualisieren einer Pipeline Folgendes:

  • Sie können den Namen oder die Netzwerkeinstellungen einer Pipeline nicht aktualisieren.

  • Wenn Ihre Pipeline in eine VPC-Domänensenke schreibt, können Sie nicht zurückgehen und die Senke in eine andere VPC-Domäne ändern, nachdem die Pipeline erstellt wurde. Sie müssen die Pipeline löschen und mit der neuen Senke neu erstellen. Sie können die Senke immer noch von einer VPC-Domain zu einer Public Domain, von einer Public Domain zu einer VPC-Domain oder von einer Public Domain zu einer anderen Public Domain wechseln.

  • Sie können die Pipeline-Senke jederzeit zwischen einer öffentlichen OpenSearch Dienstdomäne und einer OpenSearch serverlosen Sammlung wechseln.

  • Wenn Sie die Quell-, Prozessor- oder Senkenkonfiguration für eine Pipeline aktualisieren, initiiert OpenSearch Ingestion eine Bereitstellung. blue/green Weitere Informationen finden Sie unter Blaue/grüne Bereitstellungen für Pipeline-Updates.

  • Wenn Sie die Quell-, Prozessor- oder Senkenkonfiguration für eine Pipeline aktualisieren, aktualisiert OpenSearch Ingestion Ihre Pipeline automatisch auf die neueste unterstützte Nebenversion der Hauptversion von Data Prepper, die in der Pipeline ausgeführt wird. Dieser Prozess hält Ihre Pipeline mit den neuesten Bugfixes und Leistungsverbesserungen auf dem neuesten Stand.

  • Sie können Ihre Pipeline immer noch aktualisieren, wenn sie gestoppt ist.

Erforderliche Berechtigungen

OpenSearch Ingestion verwendet die folgenden IAM-Berechtigungen für die Aktualisierung von Pipelines:

  • osis:UpdatePipeline— Aktualisieren Sie eine Pipeline.

  • osis:ValidatePipeline— Prüfen Sie, ob eine Pipeline-Konfiguration gültig ist.

  • iam:PassRole— Übergeben Sie die Pipeline-Rolle an OpenSearch Ingestion, damit diese Daten in die Domain schreiben kann. Diese Berechtigung ist nur erforderlich, wenn Sie die Pipeline-Konfiguration aktualisieren, nicht, wenn Sie andere Einstellungen wie die Veröffentlichung von Protokollen oder Kapazitätsgrenzen ändern.

Die folgende Richtlinie gewährt beispielsweise die Erlaubnis, eine Pipeline zu aktualisieren:

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

Pipelines werden aktualisiert

Sie können Amazon OpenSearch Ingestion-Pipelines mithilfe der AWS Management Console, der oder der AWS CLI OpenSearch Ingestion-API aktualisieren.

Um eine Pipeline zu aktualisieren
  1. Melden Sie sich zu https://console.aws.amazon.com/aos/Hause bei der Amazon OpenSearch Service-Konsole an.

  2. Wählen Sie im linken Navigationsbereich Pipelines aus.

  3. Wählen Sie eine Pipeline aus, um ihre Einstellungen zu öffnen. Wählen Sie dann eine der Bearbeitungsoptionen.

  4. Wenn Sie die gewünschten Änderungen vorgenommen haben, wählen Sie Save (Speichern) aus.

Um eine Pipeline mit dem zu aktualisieren AWS CLI, senden Sie eine Update-Pipeline-Anfrage. Die folgende Beispielanforderung lädt eine neue Konfigurationsdatei hoch und aktualisiert die Mindest- und Höchstkapazitätswerte:

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

Rufen Sie den Vorgang auf, um eine OpenSearch Ingestion-Pipeline mithilfe der OpenSearch Ingestion-API zu aktualisieren. UpdatePipeline

Blaue/grüne Bereitstellungen für Pipeline-Updates

OpenSearch Die Aufnahme leitet einen blauen/grünen Bereitstellungsprozess ein, wenn Sie eine Pipeline-Konfiguration aktualisieren.

Blue/green refers to the practice of creating a new environment for pipeline updates and routing traffic to the new environment after those updates are complete. The practice minimizes downtime and maintains the original environment in the event that deployment to the new environment is unsuccessful. Blue/greenBereitstellungen selbst haben keine Auswirkungen auf die Leistung, aber die Leistung kann sich ändern, wenn sich Ihre Pipeline-Konfiguration so ändert, dass die Leistung beeinträchtigt wird.

OpenSearch Die Aufnahme blockiert die auto-scaling bei Bereitstellungen. blue/green Ihnen wird weiterhin nur der Datenverkehr zur alten Pipeline in Rechnung gestellt, bis dieser zur neuen Pipeline umgeleitet wird. Sobald der Verkehr umgeleitet wurde, wird Ihnen nur die neue Pipeline in Rechnung gestellt. Ihnen werden niemals zwei Pipelines gleichzeitig in Rechnung gestellt.

Wenn Sie die Quell-, Prozessor- oder Senkenkonfiguration einer Pipeline aktualisieren, kann OpenSearch Ingestion Ihre Pipeline automatisch auf die neueste unterstützte Nebenversion der Hauptversion aktualisieren, auf der die Pipeline ausgeführt wird. Möglicherweise haben Sie version: "2" in Ihrer Pipeline-Konfiguration und OpenSearch Ingestion die Pipeline ursprünglich mit Version 2.1.0 bereitgestellt. Wenn Unterstützung für Version 2.1.1 hinzugefügt wird und Sie eine Änderung an Ihrer Pipeline-Konfiguration vornehmen, aktualisiert OpenSearch Ingestion Ihre Pipeline auf Version 2.1.1.

Dieser Prozess hält Ihre Pipeline mit den neuesten Bugfixes und Leistungsverbesserungen auf dem neuesten Stand. OpenSearch Ingestion kann die Hauptversion Ihrer Pipeline nur aktualisieren, wenn Sie die version Option in der Pipeline-Konfiguration manuell ändern.