Memperbarui saluran pipa Amazon OpenSearch Ingestion

Anda dapat memperbarui pipeline Amazon OpenSearch Ingestion menggunakan, API AWS Management Console AWS CLI, atau Ingestion. OpenSearch OpenSearch Ingestion memulai penerapan biru/hijau saat Anda memperbarui konfigurasi YAMAL pipeline. Untuk informasi selengkapnya, lihat Penerapan biru/hijau untuk pembaruan saluran pipa.

Pertimbangan

Pertimbangkan hal berikut saat Anda memperbarui pipeline:

• Anda dapat mengedit batas kapasitas pipeline, opsi penerbitan log, dan konfigurasi YAMAL. Anda tidak dapat mengedit nama atau pengaturan jaringannya.

• Jika pipeline Anda menulis ke sink domain VPC, Anda tidak dapat kembali dan mengubah wastafel ke domain VPC yang berbeda setelah pipeline dibuat. Anda harus menghapus dan membuat ulang pipa dengan wastafel baru. Anda masih dapat mengalihkan sink dari domain VPC ke domain publik, dari domain publik ke domain VPC, atau dari domain publik ke domain publik lain.

• Anda dapat mengganti pipeline sink kapan saja antara domain OpenSearch Layanan publik dan koleksi OpenSearch Tanpa Server.

• Saat Anda memperbarui konfigurasi YAMAL pipeline, OpenSearch Ingestion memulai penerapan biru/hijau. Untuk informasi selengkapnya, lihat Penerapan biru/hijau untuk pembaruan saluran pipa.

• Saat Anda memperbarui konfigurasi YAMAL pipeline, OpenSearch Ingestion akan secara otomatis memutakhirkan pipeline Anda ke versi minor terbaru yang didukung dari versi utama Penyediaan Data yang ditentukan dalam konfigurasi pipeline. Proses ini membuat pipeline Anda tetap up to date dengan perbaikan bug terbaru dan peningkatan kinerja.

• Anda masih dapat melakukan pembaruan pada pipeline Anda saat dihentikan.

Izin diperlukan

OpenSearch Ingestion menggunakan izin IAM berikut untuk memperbarui pipeline:

• osis:UpdatePipeline— Perbarui pipa.

• osis:ValidatePipeline— Periksa apakah konfigurasi pipeline valid.

• iam:PassRole— Lewati peran pipeline ke OpenSearch Ingestion sehingga dapat menulis data ke domain. Izin ini hanya diperlukan jika Anda memperbarui konfigurasi YAMAL pipeline, bukan jika Anda memodifikasi setelan lain seperti penerbitan log atau batas kapasitas.

Misalnya, kebijakan berikut memberikan izin untuk memperbarui 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"
         ]
      }
   ]
}

Memperbarui jaringan pipa

Anda dapat memperbarui pipeline Amazon OpenSearch Ingestion menggunakan, API AWS Management Console AWS CLI, atau Ingestion. OpenSearch

Konsol

Untuk memperbarui pipeline

1. Masuk ke konsol OpenSearch Layanan Amazon di https://console.aws.amazon.com/aos/home.

2. Pilih Pipelines di panel navigasi kiri.

3. Pilih pipeline untuk membuka pengaturannya. Anda dapat mengedit batas kapasitas pipeline, opsi penerbitan log, dan konfigurasi YAMAL. Anda tidak dapat mengedit nama atau pengaturan jaringannya.

4. Setelah selesai membuat perubahan, pilih Simpan.

CLI

Untuk memperbarui pipeline menggunakan AWS CLI, kirim permintaan update-pipeline. Contoh permintaan berikut mengunggah file konfigurasi baru dan memperbarui nilai kapasitas minimum dan maksimum:

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

OpenSearch API Tertelan

Untuk memperbarui pipeline OpenSearch Ingestion menggunakan API OpenSearch Ingestion, panggil operasi. UpdatePipeline

Penerapan biru/hijau untuk pembaruan saluran pipa

OpenSearch Ingestion memulai proses penerapan biru/hijau saat Anda memperbarui konfigurasi YAMAL pipeline.

Biru/hijau mengacu pada praktik menciptakan lingkungan baru untuk pembaruan pipa dan perutean lalu lintas ke lingkungan baru setelah pembaruan tersebut selesai. Praktik ini meminimalkan waktu henti dan mempertahankan lingkungan asli jika deployment ke lingkungan baru tidak berhasil. Penerapan biru/hijau sendiri tidak memiliki dampak kinerja apa pun, tetapi kinerja mungkin berubah jika konfigurasi pipeline Anda berubah dengan cara yang mengubah kinerja.

OpenSearch Penyerapan memblokir auto-scaling selama penerapan biru/hijau. Anda terus dikenakan biaya hanya untuk lalu lintas ke pipa lama sampai diarahkan ke pipa baru. Setelah lalu lintas dialihkan, Anda hanya dikenakan biaya untuk pipeline baru. Anda tidak pernah dikenakan biaya untuk dua saluran pipa secara bersamaan.

Saat Anda memperbarui file konfigurasi YAMAL pipeline, OpenSearch Ingestion dapat secara otomatis memutakhirkan pipeline Anda ke versi minor terbaru yang didukung dari versi utama Penyediaan Data yang ditentukan dalam konfigurasi pipeline. Misalnya, Anda mungkin memiliki version: "2" konfigurasi pipeline, dan OpenSearch Ingestion awalnya menyediakan pipeline dengan versi 2.1.0. Saat dukungan untuk versi 2.1.1 ditambahkan, dan Anda membuat perubahan pada konfigurasi pipeline, OpenSearch Ingestion akan meningkatkan pipeline Anda ke versi 2.1.1.

Proses ini membuat pipeline Anda tetap up to date dengan perbaikan bug terbaru dan peningkatan kinerja. OpenSearch Ingestion tidak dapat memperbarui versi utama pipeline Anda kecuali Anda mengubah version opsi secara manual dalam konfigurasi pipeline.