Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Amazon OpenSearch Service rename - Ringkasan perubahan
Pada 8 September 2021, rangkaian pencarian dan analitik kami diubah namanya menjadi Amazon OpenSearch Service. OpenSearch Layanan mendukung OpenSearch serta warisan Elasticsearch OSS. Bagian berikut menjelaskan berbagai bagian layanan yang berubah dengan penggantian nama, dan tindakan apa yang perlu Anda lakukan untuk memastikan bahwa domain Anda terus berfungsi dengan baik.
Beberapa perubahan ini hanya berlaku saat Anda meningkatkan domain dari Elasticsearch ke OpenSearch. Dalam kasus lain, seperti di konsol Billing and Cost Management, pengalaman akan segera berubah.
Perhatikan bahwa daftar ini bukan daftar lengkap. Sementara bagian lain dari produk juga berubah, pembaruan ini adalah yang paling relevan.
Topik
Versi API baru
Versi baru API konfigurasi OpenSearch Layanan (2021-01-01) berfungsi dengan OpenSearch serta Elasticsearch OSS lama. 21 operasi API diganti dengan nama yang lebih ringkas dan engine-agnostik (misalnya,CreateElasticsearchDomain
diubah menjadiCreateDomain
), tetapi OpenSearch Service terus mendukung kedua versi API.
Kami menyarankan agar Anda menggunakan operasi API baru untuk membuat dan mengelola domain ke depan. Perhatikan bahwa ketika Anda menggunakan operasi API baru untuk membuat domain, Anda perlu menentukanEngineVersion
parameter dalam formatElasticsearch_X.Y
atauOpenSearch_X.Y
, bukan hanya nomor versi. Jika Anda tidak menentukan versinya, itu akan mengatur default ke versi terbaru dari OpenSearch.
Upgrade AndaAWS CLI ke versi 1.20.40 atau yang lebih baruaws opensearch
...
untuk digunakan untuk membuat dan mengelola domain Anda. Untuk format CLI baru, lihat referensiOpenSearch CLI
Tipe instans berganti nama
Jenis instans di Amazon OpenSearch Service sekarang dalam format<type>.<size>.search
—misalnya,m6g.large.search
bukanm6g.large.elasticsearch
. Anda tidak perlu mengambil tindakan apa pun. Domain yang ada akan mulai secara otomatis merujuk ke jenis instans baru di dalam API dan di konsol Billing and Cost Management.
Jika Anda memiliki Instans Cadangan (RI), kontrak Anda tidak akan terpengaruh oleh perubahan tersebut. Versi API konfigurasi lama masih kompatibel dengan format penamaan lama, tetapi jika Anda ingin menggunakan versi API baru, Anda perlu menggunakan format baru.
Perubahan kebijakan akses
Bagian berikut menjelaskan tindakan apa yang perlu Anda lakukan untuk memperbarui kebijakan akses Anda.
Kebijakan IAM
Kami menyarankan agar Anda memperbarui kebijakan IAM untuk menggunakan operasi API berganti nama. Namun, OpenSearch Layanan akan terus menghormati kebijakan yang ada dengan mereplikasi izin API lama secara internal. Misalnya, jika saat ini Anda memiliki izin untuk melakukanCreateElasticsearchDomain
operasi, Anda sekarang dapat melakukan panggilan ke keduanyaCreateElasticsearchDomain
(operasi API lama) danCreateDomain
(operasi API baru). Hal yang sama berlaku untuk penyangkalan eksplisit. Untuk melihat daftar operasi API yang diperbarui, lihat referensi elemen kebijakan.
Kebijakan SCP
Kebijakan kontrol layanan (SCP) memperkenalkan lapisan kompleksitas tambahan dibandingkan dengan IAM standar. Untuk mencegah kebijakan SCP Anda melanggar, Anda perlu menambahkan operasi API lama dan baru ke setiap kebijakan SCP Anda. Misalnya, jika pengguna saat ini mengizinkan izinCreateElasticsearchDomain
, Anda juga perlu memberi mereka izin izinCreateDomain
agar mereka dapat mempertahankan kemampuan untuk membuat domain. Hal yang sama berlaku untuk penyangkalan eksplisit.
Misalnya:
"Statement": [ { "Effect": "Allow", "Action": [ "es:CreateElasticsearchDomain", "es:CreateDomain" ... ], }, "Effect": "Deny", "Action:" [ "es:DeleteElasticsearchDomain", "es:DeleteDomain" ...
Tipe sumber daya baru
OpenSearch Layanan memperkenalkan jenis sumber daya baru berikut:
Sumber Daya | Deskripsi |
---|---|
|
Merupakan domain OpenSearch Layanan Amazon. Sumber daya ini ada di tingkat layanan dan tidak spesifik untuk perangkat lunak yang berjalan di domain. Ini berlaku untuk layanan seperti AWS CloudFormation Untuk petunjuk untuk meningkatkan domain yang didefinisikan dalam CloudFormation dari Elasticsearch ke OpenSearch, lihat Keterangan di Panduan CloudFormation Pengguna. |
|
OpenSearchMewakili/Elasticsearch perangkat lunak yang berjalan pada domain. Sumber daya ini berlaku untuk layanan seperti AWS CloudTrailAWS::Elasticsearch::Domain ) versus domain running OpenSearch (AWS::OpenSearch::Domain ). |
catatan
Di AWS ConfigAWS::Elasticsearch::Domain
sumber daya yang ada selama beberapa minggu, bahkan jika Anda meningkatkan satu atau beberapa domain ke OpenSearch.
Kibana berganti nama menjadi OpenSearch Dasbor
OpenSearch Dasbor,AWS alternatif untuk Kibana, adalah alat visualisasi open-source yang dirancang untuk digunakan OpenSearch. Setelah Anda memutakhirkan domain dari Elasticsearch ke OpenSearch,/_plugin/kibana
titik akhir akan berubah menjadi/_dashboards
. OpenSearch Layanan akan mengalihkan semua permintaan ke endpoint baru, tetapi jika Anda menggunakan endpoint Kibana dalam salah satu kebijakan IAM Anda, perbarui kebijakan tersebut untuk menyertakan/_dashboards
endpoint baru juga.
Jika Anda menggunakanSAMLotentikasi untuk Dasbor OpenSearch , sebelum meningkatkan domain OpenSearch, Anda perlu mengubah semua URL Kibana yang dikonfigurasi di penyedia identitas (IdP) dari/_plugin/kibana
ke/_dashboards
. URL yang paling umum adalah URL assertion consumer service (ACS) dan URL penerima.
kibana_read_only
Peran default untuk OpenSearch Dasbor diubah namanya menjadiopensearch_dashboards_read_only
, dankibana_user
peran diubah namanyaopensearch_dashboards_user
. Perubahan ini berlaku untuk semua yang baru dibuat OpenSearch 1. x domain yang menjalankan perangkat lunak layanan R20211203 atau yang lebih baru. Jika Anda meningkatkan domain yang ada ke perangkat lunak layanan R20211203, nama peran tetap sama.
CloudWatch Metrik berganti nama
Beberapa CloudWatch metrik berubah untuk domain yang berjalan OpenSearch. Saat Anda meningkatkan domain ke OpenSearch, metrik berubah secara otomatis dan CloudWatch alarm Anda saat ini akan rusak. Sebelum memutakhirkan klaster Anda dari versi Elasticsearch ke OpenSearch versi, pastikan untuk memperbarui CloudWatch alarm Anda untuk menggunakan metrik baru.
Metrik berikut berubah:
Nama metrik asli | Nama baru |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Untuk daftar lengkap metrik yang dikirim OpenSearch Layanan ke Amazon CloudWatch, lihatMemantau metrik OpenSearch klaster dengan Amazon CloudWatch.
Perubahan konsol Billing and Cost Management
Data historis di konsol Penagihan dan Manajemen Biaya
Selain nama layanan, kolom berikut akan berubah untuk semua laporan, tagihan, dan operasi API daftar harga:
Bidang | Format lama | Format baru |
---|---|---|
Tipe instans |
|
|
Keluarga produk |
Contoh Elasticsearch Volume Elasticsearch |
Instans OpenSearch Layanan Amazon Volume OpenSearch Layanan Amazon |
Deskripsi harga |
$5,098 per c5.18xlarge.elasticsearch instans hour (atau sebagian jam) - UE |
$5,098 per c5.18xlarge.search instans hour (atau sebagian jam) - EU |
Keluarga instance |
|
|
Format peristiwa baru
Format peristiwa yang dikirim OpenSearch Layanan ke Amazon EventBridge dan Amazon CloudWatch telah berubah, khususnyadetail-type
bidangnya. Bidang sumber (aws.es
) tetap sama. Untuk format lengkap untuk setiap jenis acara, lihatMemantau peristiwa OpenSearch Layanan dengan Amazon EventBridge. Jika Anda memiliki aturan acara yang ada yang bergantung pada format lama, pastikan untuk memperbaruinya agar sesuai dengan format baru.
Apa yang tetap sama?
Fitur dan fungsionalitas berikut, antara lain yang tidak terdaftar, akan tetap sama:
-
Prinsipal layanan (
es.amazonaws.com
) -
Kode Vendor
-
ARN Domain
-
Titik akhir domain
Memulai: Tingkatkan domain Anda ke OpenSearch 1.x
OpenSearch 1. x mendukung upgrade dari Elasticsearch versi 6.8 dan 7. x. Untuk petunjuk untuk meningkatkan domain Anda, lihatMemulai upgrade (konsol). Jika Anda menggunakanAWS CLI atau API konfigurasi untuk meningkatkan domain Anda, Anda perlu menentukanTargetVersion
sebagaiOpenSearch_1.x
.
OpenSearch 1. x memperkenalkan setelan domain tambahan yang disebut Aktifkan mode kompatibilitas. Karena klien dan plugin Elasticsearch OSS tertentu memeriksa versi klaster sebelum menghubungkan, mode OpenSearch kompatibilitas akan melaporkan versinya sebagai 7.10 sehingga klien ini terus bekerja.
Anda dapat mengaktifkan mode kompatibilitas saat membuat OpenSearch domain untuk pertama kalinya, atau saat Anda memutakhirkan OpenSearch ke versi Elasticsearch. Jika tidak disetel, parameter akan ditetapkan secara defaultfalse
saat Anda membuat domain, dantrue
saat Anda meningkatkan domain.
Untuk mengaktifkan mode kompatibilitas menggunakan API konfigurasi, aturoverride_main_response_version
ketrue
:
POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain { "DomainName": "
domain-name
", "TargetVersion": "OpenSearch_1.0", "AdvancedOptions": { "override_main_response_version": "true" } }
Untuk mengaktifkan atau menonaktifkan mode kompatibilitas pada OpenSearch domain yang ada, Anda perlu menggunakan operasi API OpenSearch _cluster/settings
PUT /_cluster/settings { "persistent" : { "compatibility.override_main_response_version" : true } }