Aggiornamento delle pipeline di Amazon OpenSearch Ingestion

Puoi aggiornare le pipeline OpenSearch di Amazon Ingestion utilizzando l' AWS Management Console, la o l' OpenSearch API AWS CLI Ingestion. OpenSearch Ingestion avvia una distribuzione blu/verde quando aggiorni la configurazione YAML di una pipeline. Per ulteriori informazioni, consulta Implementazioni blu/verdi per gli aggiornamenti della pipeline.

Considerazioni

Quando aggiorni una pipeline, considera quanto segue:

• Puoi modificare i limiti di capacità di una pipeline, le opzioni di pubblicazione dei log e la configurazione YAML. Non puoi modificarne il nome o le impostazioni di rete.

• Se la pipeline scrive su un sink di dominio VPC, non puoi tornare indietro e modificare il sink in un dominio VPC diverso dopo la creazione della pipeline. È necessario eliminare e ricreare la pipeline con il nuovo sink. Puoi comunque passare il sink da un dominio VPC a un dominio pubblico, da un dominio pubblico a un dominio VPC o da un dominio pubblico a un altro dominio pubblico.

• È possibile passare il sink della pipeline in qualsiasi momento da un dominio di OpenSearch servizio pubblico a una raccolta Serverless. OpenSearch

• Quando aggiorni la configurazione YAML di una pipeline, OpenSearch Ingestion avvia una distribuzione blu/verde. Per ulteriori informazioni, consulta Implementazioni blu/verdi per gli aggiornamenti della pipeline.

• Quando si aggiorna la configurazione YAML di una pipeline, OpenSearch Ingestion aggiorna automaticamente la pipeline all'ultima versione secondaria supportata della versione principale di Data Prepper specificata nella configurazione della pipeline. Questo processo mantiene la pipeline aggiornata con le ultime correzioni di bug e i miglioramenti delle prestazioni.

• Puoi comunque aggiornare la tua pipeline quando viene interrotta.

Autorizzazioni richieste

OpenSearch Ingestion utilizza le seguenti autorizzazioni IAM per l'aggiornamento delle pipeline:

• osis:UpdatePipeline— Aggiornare una pipeline.

• osis:ValidatePipeline— Verificare se la configurazione di una tubazione è valida.

• iam:PassRole— Passa il ruolo della pipeline a OpenSearch Ingestion in modo che possa scrivere dati nel dominio. Questa autorizzazione è richiesta solo se stai aggiornando la configurazione YAML della pipeline, non se stai modificando altre impostazioni come la pubblicazione dei log o i limiti di capacità.

Ad esempio, la seguente politica concede l'autorizzazione all'aggiornamento di una 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"
         ]
      }
   ]
}

Aggiornamento delle pipeline

Puoi aggiornare le pipeline OpenSearch di Amazon Ingestion utilizzando l' AWS Management Console, la o l' OpenSearch API AWS CLI Ingestion.

Console

Per aggiornare una pipeline

1. Accedi alla console di Amazon OpenSearch Service all'indirizzo https://console.aws.amazon.com/aos/home.

2. Scegli Pipelines nel riquadro di navigazione a sinistra.

3. Scegli una pipeline per aprirne le impostazioni. Puoi modificare i limiti di capacità di una pipeline, le opzioni di pubblicazione dei log e la configurazione YAML. Non puoi modificarne il nome o le impostazioni di rete.

4. Una volta completate le modifiche, scegli Save (Salva).

CLI

Per aggiornare una pipeline utilizzando AWS CLI, invia una richiesta di update-pipeline. La seguente richiesta di esempio carica un nuovo file di configurazione e aggiorna i valori di capacità minima e massima:

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

OpenSearch API di ingestione

Per aggiornare una pipeline OpenSearch di ingestione utilizzando l'API Ingestion, chiamate l' OpenSearch operazione. UpdatePipeline

Implementazioni blu/verdi per gli aggiornamenti della pipeline

OpenSearch L'ingestione avvia un processo di distribuzione blu/verde quando si aggiorna la configurazione YAML di una pipeline.

Il blu/verde si riferisce alla pratica di creare un nuovo ambiente per gli aggiornamenti della pipeline e di indirizzare il traffico verso il nuovo ambiente dopo il completamento di tali aggiornamenti. In questo modo si riducono al minimo i tempi di inattività e si mantiene l'ambiente originale nel caso in cui ci siano problemi nella distribuzione al nuovo ambiente. Le implementazioni blu/verdi di per sé non hanno alcun impatto sulle prestazioni, ma le prestazioni potrebbero cambiare se la configurazione della pipeline cambia in modo tale da alterare le prestazioni.

OpenSearch L'ingestione blocca l'auto-scaling durante le implementazioni blu/green. Continuerai a essere addebitato solo per il traffico verso la vecchia pipeline fino a quando non viene reindirizzato alla nuova pipeline. Una volta che il traffico è stato reindirizzato, ti verrà addebitato solo il costo della nuova pipeline. Non ti vengono mai addebitati costi per due pipeline contemporaneamente.

Quando aggiorni il file di configurazione YAML di una pipeline, OpenSearch Ingestion può aggiornare automaticamente la pipeline all'ultima versione secondaria supportata della versione principale di Data Prepper specificata nella configurazione della pipeline. Ad esempio, è possibile che version: "2" nella configurazione della pipeline Ingestion abbia inizialmente fornito alla pipeline la versione 2.1.0. OpenSearch Quando viene aggiunto il supporto per la versione 2.1.1 e si apporta una modifica alla configurazione della pipeline, Ingestion aggiorna la pipeline alla versione 2.1.1. OpenSearch

Questo processo mantiene la pipeline aggiornata con le ultime correzioni di bug e i miglioramenti delle prestazioni. OpenSearch Ingestion non può aggiornare la versione principale della pipeline a meno che non si modifichi manualmente l'versionopzione all'interno della configurazione della pipeline.