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 blaue/grüne Bereitstellung, wenn Sie die YAML-Konfiguration einer Pipeline aktualisieren. Weitere Informationen finden Sie unter Blaue/grüne Bereitstellungen für Pipeline-Updates.

Überlegungen

Beachten Sie Folgendes, wenn Sie eine Pipeline aktualisieren:

• Sie können die Kapazitätsgrenzen einer Pipeline, die Optionen zur Protokollveröffentlichung und die YAML-Konfiguration bearbeiten. Sie können ihren Namen oder ihre Netzwerkeinstellungen nicht bearbeiten.

• 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 YAML-Konfiguration einer Pipeline aktualisieren, initiiert OpenSearch Ingestion eine blaue/grüne Bereitstellung. Weitere Informationen finden Sie unter Blaue/grüne Bereitstellungen für Pipeline-Updates.

• Wenn Sie die YAML-Konfiguration einer Pipeline aktualisieren, aktualisiert OpenSearch Ingestion Ihre Pipeline automatisch auf die neueste unterstützte Nebenversion der Hauptversion von Data Prepper, die in der Pipeline-Konfiguration angegeben ist. Dieser Prozess hält Ihre Pipeline mit den neuesten Bugfixes und Leistungsverbesserungen auf dem neuesten Stand.

• Sie können immer noch Aktualisierungen an Ihrer Pipeline vornehmen, 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 sie Daten in die Domain schreiben kann. Diese Berechtigung ist nur erforderlich, wenn Sie die YAML-Konfiguration der Pipeline 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:

{
   "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.

Konsole

Um eine Pipeline zu aktualisieren

1. Melden Sie sich bei der Amazon OpenSearch Service-Konsole unter https://console.aws.amazon.com/aos/home an.

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

3. Wählen Sie eine Pipeline aus, um ihre Einstellungen zu öffnen. Sie können die Kapazitätsgrenzen einer Pipeline, die Optionen zur Protokollveröffentlichung und die YAML-Konfiguration bearbeiten. Sie können ihren Namen oder ihre Netzwerkeinstellungen nicht bearbeiten.

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

CLI

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

OpenSearch Aufnahme-API

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 die YAML-Konfiguration einer Pipeline aktualisieren.

Blau/Grün bezieht sich auf die Praxis, eine neue Umgebung für Pipeline-Updates zu erstellen und den Datenverkehr nach Abschluss dieser Updates an die neue Umgebung weiterzuleiten. Die Praxis minimiert die Ausfallzeiten und verwaltet die ursprüngliche Umgebung für den Fall, dass die Bereitstellung in der neuen Umgebung fehlgeschlagen ist. Blaue/grüne Bereitstellungen 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 Blau/Grün-Bereitstellungen. 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 YAML-Konfigurationsdatei einer Pipeline aktualisieren, kann OpenSearch Ingestion Ihre Pipeline automatisch auf die neueste unterstützte Nebenversion der Hauptversion von Data Prepper aktualisieren, die in der Pipeline-Konfiguration angegeben ist. Möglicherweise haben Sie version: "2" in Ihrer Pipeline-Konfiguration und OpenSearch Ingestion die Pipeline zunächst 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.