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 una configurazione di pipeline. Per ulteriori informazioni, consulta Implementazioni blu/verdi per gli aggiornamenti della pipeline.

Considerazioni

Durante l'aggiornamento di una pipeline tieni presente quanto segue:

• Non puoi aggiornare il nome o le impostazioni di rete di una pipeline.

• 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. Devi 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 si aggiorna la configurazione di origine, processore o sink per 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 di origine, processore o sink per una pipeline, OpenSearch Ingestion aggiorna automaticamente la pipeline all'ultima versione secondaria supportata della versione principale di Data Prepper utilizzata nella 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 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 ad aggiornare 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 da https://console.aws.amazon.com/aos/casa.

2. Nel riquadro di navigazione a sinistra, scegli Pipelines (pipeline).

3. Scegli una pipeline per aprirne le impostazioni. Quindi, scegliete una delle opzioni di modifica.

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 una configurazione della pipeline.

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/greenle distribuzioni 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'inserimento blocca l'auto-scaling durante implementazioni blu/verde. 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, l'addebito è relativo solo alla nuova pipeline. Non ti vengono mai addebitati costi per due pipeline contemporaneamente.

Quando aggiorni la configurazione di origine, processore o sink di una pipeline, OpenSearch Ingestion può aggiornare automaticamente la pipeline all'ultima versione secondaria supportata della versione principale in esecuzione sulla pipeline. Ad esempio, potreste avere version: "2" nella configurazione della pipeline e OpenSearch Ingestion inizialmente aveva fornito alla pipeline la versione 2.1.0. 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.