Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Migrasi dari Couchbase Server ke Couchbase Capella di AWS *Battulga Purevragchaa dan Saurabh Shanbhag, Amazon Web Services* *Mark Gamble, Tidak Ada* ## Ringkasan Couchbase Capella adalah database NoSQL yang dikelola sepenuhnya sebagai layanan (DBaaS) untuk aplikasi mission-critical (misalnya, profil pengguna atau katalog online dan manajemen inventaris). Couchbase Capella mengelola beban kerja DBaa S Anda di akun Amazon Web Services (AWS) yang dikelola Couchbase. Capella memudahkan untuk menjalankan dan mengelola replikasi multi-cluster, Multiple—AWS Region, multicloud, dan hybrid-cloud dalam satu antarmuka. Couchbase Capella membantu Anda secara instan menskalakan aplikasi Server Couchbase Anda, membantu Anda membuat klaster multi-node dalam hitungan menit. [https://docs.couchbase.com/server/current/eventing/eventing-overview.html](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) Ini juga menghilangkan kebutuhan untuk mengelola instalasi, upgrade, backup, dan pemeliharaan database umum.  Pola ini menjelaskan langkah-langkah dan praktik terbaik untuk memigrasikan lingkungan [Server Couchbase yang dikelola sendiri ke AWS](https://www.couchbase.com/products/server) Cloud. Pola ini menyediakan proses berulang untuk memigrasikan data dan indeks dari kluster Couchbase Server, berjalan baik di tempat atau di cloud, ke Couchbase Capella. Menggunakan langkah-langkah ini membantu Anda menghindari masalah selama migrasi dan mempercepat proses migrasi secara keseluruhan. Pola ini menyediakan dua opsi migrasi berikut: + **Opsi 1** sesuai jika Anda memiliki kurang dari 50 indeks untuk dimigrasi.  + **Opsi 2** sesuai jika Anda memiliki lebih dari 50 indeks untuk dimigrasi.  Anda juga dapat [mengatur data sampel](https://docs.couchbase.com/server/current/manage/manage-settings/install-sample-buckets.html) di Server Couchbase yang dikelola sendiri untuk mengikuti panduan migrasi. Jika Anda memilih **opsi migrasi 2**, atau jika Anda menggunakan cakupan atau koleksi selain nilai default, Anda harus menggunakan contoh file konfigurasi, yang ada di bagian *Informasi tambahan*. ## Prasyarat dan batasan **Prasyarat** + Akun berbayar Couchbase Capella yang ada. Anda juga dapat membuat akun [Couchbase Capella di AWS](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) dan menggunakan uji coba gratis Couchbase Capella, lalu memutakhirkan ke akun berbayar untuk mengonfigurasi kluster Anda untuk migrasi.. Untuk memulai dengan versi uji coba, ikuti petunjuk di [Memulai dengan Couchbase](https://docs.couchbase.com/cloud/get-started/create-account.html) Capella. + Lingkungan Server Couchbase yang dikelola sendiri yang ada baik di tempat atau digunakan di penyedia layanan cloud.  + Untuk opsi migrasi 2, Couchbase Shell dan file konfigurasi. Untuk membuat file konfigurasi, Anda dapat menggunakan file contoh yang ada di bagian *Informasi tambahan*. + Keakraban dengan mengelola Couchbase Server dan Couchbase Capella. + Keakraban dengan membuka port TCP dan menjalankan perintah dalam antarmuka baris perintah (CLI). Proses migrasi juga membutuhkan peran dan keahlian yang dijelaskan dalam tabel berikut. | | | Peran | Keahlian | Tanggung jawab | | --- |--- |--- | | Administrator Couchbase | Keakraban dengan Couchbase Server dan Couchbase CapellaPengetahuan baris perintah dasar sangat membantu tetapi tidak diperlukan | Server Couchbase dan tugas khusus Capella | | Administrator sistem, administrator TI | Keakraban dengan lingkungan dan administrasi sistem Couchbase Server yang dikelola sendiri | Membuka port dan menentukan alamat IP pada node cluster Couchbase Server yang dikelola sendiri | **Batasan** + Pola ini digunakan untuk memigrasikan data, indeks, dan indeks [Pencarian Teks Lengkap Couchbase](https://docs.couchbase.com/server/current/fts/full-text-intro.html) dari Couchbase Server ke Couchbase Capella di AWS. [Pola ini tidak berlaku untuk memigrasi [Couchbase Eventing Service, atau ke Couchbase](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) Analytics.](https://docs.couchbase.com/server/current/analytics/introduction.html) + Couchbase Capella tersedia di beberapa Wilayah AWS. Untuk up-to-date informasi tentang Wilayah yang didukung Capella, lihat [Amazon Web Services di dokumentasi](https://docs.couchbase.com/cloud/reference/aws.html) Couchbase. **Versi produk** + [Couchbase Server (Komunitas atau Perusahaan) Edition versi 5.x atau yang lebih baru](https://docs.couchbase.com/server/current/release-notes/relnotes.html) ## Arsitektur **Tumpukan teknologi sumber** + Server Couchbase **Tumpukan teknologi target** + Couchbase Capella **Arsitektur target** ![\[Migrasi Couchbase Capella ke cluster Couchbase di bidang data Capella di AWS dalam empat langkah.\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/images/pattern-img/14ac5a81-eade-4708-9335-f5602fa07824/images/95cd7f33-742e-4d10-8e2c-37c7b4d9df45.png) 1. **Anda mengakses Couchbase Capella dengan menggunakan Capella Control Plane.** Anda dapat menggunakan Capella Control Plane untuk melakukan hal berikut: + Kontrol dan pantau akun Anda. + Kelola cluster dan data, indeks, pengguna dan grup, izin akses, pemantauan, dan acara. 1. Cluster dibuat. 1. **Capella Data Plane** ada di akun AWS yang dikelola Couchbase. Setelah Anda membuat klaster baru, Couchbase Capella menerapkannya di beberapa Availability Zone di Wilayah AWS yang dipilih. 1. Anda dapat mengembangkan dan menerapkan aplikasi Couchbase di VPC di akun AWS Anda. [Biasanya, VPC ini mengakses Capella Data Plane melalui VPC peering.](https://docs.couchbase.com/cloud/clouds/private-network.html) ## Alat + [Couchbase Cross Data Center Replication (XDCR)](https://docs.couchbase.com/cloud/current/clusters/xdcr/xdcr.html) membantu mereplikasi data di seluruh cluster yang terletak di penyedia cloud yang berbeda dan pusat data yang berbeda. Ini digunakan untuk memigrasikan data ke Couchbase Capella dari cluster Server Couchbase yang dikelola sendiri. **catatan** XDCR tidak dapat digunakan dengan Couchbase Server Community Edition untuk bermigrasi ke Couchbase Capella. Sebagai gantinya, Anda dapat menggunakan [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html). Untuk informasi selengkapnya, lihat epik *Migrasi data dari Edisi Komunitas*. + [Couchbase Shell adalah shell](https://couchbase.sh/docs/) baris perintah untuk Couchbase Server dan Couchbase Capella untuk mengakses cluster Couchbase lokal dan jarak jauh. Dalam pola ini, Couchbase Shell digunakan untuk memigrasikan indeks. + [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html) adalah utilitas Couchbase untuk mengekspor data dari cluster Couchbase. Termasuk dalam alat [CLI Server Couchbase](https://docs.couchbase.com/server/current/cli/cli-intro.html). ## Epik ### Siapkan migrasi | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Evaluasi ukuran cluster Couchbase Server yang dikelola sendiri. | Masuk ke [Konsol Web Couchbase](https://docs.couchbase.com/server/current/manage/manage-ui/manage-ui.html) untuk Server Couchbase, dan nilai node dan bucket cluster yang dikelola sendiri. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Anda akan menggunakan konfigurasi cluster Couchbase Server yang dikelola sendiri sebagai panduan umum untuk mengukur dan mengonfigurasi cluster target di Couchbase Capella.[Untuk bantuan dengan latihan ukuran Couchbase Capella yang lebih detail, hubungi Couchbase.](https://www.couchbase.com/contact) | Administrator Couchbase | | Rekam distribusi Layanan Couchbase di cluster Couchbase Server yang dikelola sendiri. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | | Rekam alamat IP node cluster Couchbase Server yang dikelola sendiri. | (Abaikan langkah ini jika Anda menggunakan Edisi Komunitas.) Catat alamat IP untuk setiap node di cluster Anda. Mereka akan ditambahkan ke daftar izinkan di cluster Couchbase Capella Anda nanti. | Administrator Couchbase, Administrator sistem | ### Terapkan dan konfigurasikan sumber daya di Couchbase Capella | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Pilih templat. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | | Pilih dan konfigurasikan node. | Pilih dan konfigurasikan node agar sesuai dengan lingkungan cluster Couchbase Server yang dikelola sendiri, termasuk jumlah node, distribusi layanan, komputasi atau RAM, dan penyimpanan.Couchbase Capella menggunakan praktik terbaik penskalaan [multidimensi](https://docs.couchbase.com/cloud/clusters/scale-cluster.html#scale-a-cluster). Layanan dan node hanya dapat dipilih sesuai dengan praktik terbaik penerapan. Ini mungkin berarti bahwa Anda tidak dapat sama persis dengan konfigurasi cluster Couchbase Server yang dikelola sendiri. | Administrator Couchbase | | Menyebarkan cluster. | Pilih zona dukungan dan paket dukungan, lalu gunakan cluster. Untuk langkah dan instruksi terperinci, lihat [Membuat klaster](https://docs.couchbase.com/cloud/clusters/create-cluster.html) di dokumentasi Couchbase.Jika Anda menggunakan uji coba gratis Couchbase Capella, Anda harus mengonversinya menjadi akun berbayar sebelum memulai migrasi. **Untuk mengonversi akun Anda, buka bagian **Penagihan** pada Couchbase Capella Control Plane, lalu pilih Tambahkan ID Aktivasi.** [ID Aktivasi dikirim ke alamat email kontak penagihan Anda setelah Anda menyelesaikan perjanjian pembelian dengan Couchbase Sales, atau setelah Anda melakukan pembelian melalui AWS Marketplace.](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) | Administrator Couchbase | | Buat pengguna kredenal basis data. | Pengguna kredenal basis data khusus untuk klaster dan terdiri dari nama pengguna, kata sandi, dan sekumpulan hak istimewa bucket. Pengguna ini diperlukan untuk membuat bucket dan mengakses data bucket. Di Couchbase Capella Control Plane, buat kredensi database untuk cluster baru dengan mengikuti petunjuk di [Configure database credentials](https://docs.couchbase.com/cloud/clusters/manage-database-users.html) dalam dokumentasi Couchbase Capella.Pengguna organisasi memerlukan kredensi peran organisasi yang ditetapkan kepada mereka jika mereka ingin mengakses data bucket pada klaster tertentu, baik dari jarak jauh atau melalui UI Couchbase Capella. Ini terpisah dari kredensi database, yang biasanya digunakan oleh aplikasi dan integrasi. Membuat pengguna organisasi memungkinkan Anda membuat dan mengelola bucket target di cluster Couchbase Capella Anda. | Administrator Couchbase | | Jika menggunakan opsi migrasi 2, instal Couchbase Shell. | Anda dapat menginstal Couchbase Shell pada sistem apa pun yang memiliki akses jaringan ke Server Couchbase yang dikelola sendiri dan cluster Couchbase Capella. Untuk informasi selengkapnya, lihat [Menginstal Couchbase Shell versi 1.0.0-beta.5](https://couchbase.sh/docs/#_installation) di dokumentasi Couchbase Shell.Konfirmasikan bahwa Couchbase Shell diinstal [dengan menguji koneksi ke cluster yang dikelola sendiri di terminal](https://couchbase.sh/docs/#_connecting_to_a_cluster) baris perintah. | Administrator Couchbase, Administrator sistem | | Izinkan alamat IP. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Untuk informasi selengkapnya tentang alamat IP yang diizinkan, lihat [Mengonfigurasi alamat IP yang diizinkan](https://docs.couchbase.com/cloud/get-started/configure-cluster-access.html#allow-ip-address) dalam dokumentasi Couchbase. | Administrator Couchbase, Administrator sistem | | Konfigurasikan sertifikat. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase, Administrator sistem | | Buat file konfigurasi untuk Couchbase Shell. | Buat dotfile konfigurasi di direktori home instalasi Couchbase Shell (misalnya,). `//.cbsh/config` Untuk informasi selengkapnya, lihat [Config dotfiles](https://couchbase.sh/docs/#_the_config_dotfiles) dalam dokumentasi Couchbase.Tambahkan properti koneksi untuk cluster sumber dan target ke file konfigurasi. Anda dapat menggunakan contoh file konfigurasi yang ada di bagian *Informasi tambahan* dan mengedit pengaturan untuk cluster Anda. Simpan file konfigurasi dengan pengaturan yang diperbarui ke `.cbsh` folder (misalnya,`//.cbsh/config`). | Administrator Couchbase, Administrator sistem | | Buat ember target. | Untuk setiap bucket sumber, buat satu bucket target di cluster Couchbase Capella Anda dengan mengikuti petunjuk di [Buat bucket dalam dokumentasi](https://docs.couchbase.com/cloud/clusters/data-service/manage-buckets.html#add-bucket) Couchbase.Konfigurasi bucket target Anda harus sesuai dengan nama bucket, pengaturan memori, dan pengaturan resolusi konflik bucket di cluster Couchbase Server yang dikelola sendiri. | Administrator Couchbase | | Buat cakupan dan koleksi. | Setiap bucket berisi cakupan dan koleksi default dengan keyspace`_default._default`. Jika Anda menggunakan ruang kunci lain untuk cakupan dan koleksi Anda, Anda harus membuat ruang kunci yang identik di cluster Capella target.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)
scopes --clusters "On-Prem-Cluster" --bucket  | select scope | where scope != "_default" | each { |it| scopes create $it.scope --clusters "Capella-Cluster" }
collections --clusters "On-Prem-Cluster" --bucket  | select scope collection | where $it.scope != "_default" | where $it.collection != "_default" | each { |it| collections create $it.collection --clusters "Capella-Cluster" --bucket  --scope $it.scope }
| Administrator Couchbase | ### Migrasi data dari Enterprise Edition | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Buka port TCP pada node cluster Couchbase Server yang dikelola sendiri. | Pastikan port yang sesuai terbuka untuk komunikasi XDCR pada node cluster Couchbase Server yang dikelola sendiri. Untuk informasi selengkapnya, lihat dokumentasi [port Server Couchbase](https://docs.couchbase.com/server/current/install/install-ports.html#ports-listed-by-communication-path). | Administrator Couchbase, Administrator sistem | | Jika Anda menggunakan Couchbase Server Enterprise Edition, siapkan Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | | Mulai Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | ### Migrasikan indeks dengan menggunakan opsi 1 | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Migrasikan indeks cluster yang dikelola sendiri ke Couchbase Capella. | Kami merekomendasikan proses ini jika Anda memiliki kurang dari 50 indeks untuk dimigrasi. Jika Anda memiliki lebih dari 50 indeks untuk dimigrasi, sebaiknya gunakan opsi migrasi 2.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase, Administrator sistem | ### Migrasikan indeks dengan menggunakan opsi 2 | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Migrasikan definisi indeks. | Kami merekomendasikan proses ini jika Anda memiliki lebih dari 50 indeks untuk dimigrasi. Jika Anda memiliki kurang dari 50 indeks untuk dimigrasi, sebaiknya gunakan opsi migrasi 1.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase, Administrator sistem | | Membangun definisi indeks. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase, Administrator sistem | ### Migrasikan indeks pencarian teks lengkap | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Migrasikan indeks pencarian teks lengkap klaster yang dikelola sendiri ke Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | ### Migrasi data dari Couchbase Community Edition | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Ekspor data dari Edisi Komunitas Server Couchbase yang dikelola sendiri. | XDCR terenkripsi tidak tersedia di Couchbase Community Edition. Anda dapat mengekspor data dari Couchbase Community Edition dan kemudian mengimpor data secara manual ke Couchbase Capella.Untuk mengekspor data dari bucket sumber, gunakan `cbexport` pada baris perintah.Perintah berikut diberikan sebagai contoh.
cbexport json \
--cluster localhost \
--bucket  \
--format lines \
--username  \
--password  \
--include-key cbkey \
--scope-field cbscope \
--collection-field cbcoll \
--output cbexported_data.json
Perhatikan bahwa`cbkey`,, `cbscope``cbcoll`, dan `cbexported_data.json` merupakan label sewenang-wenang. Mereka akan direferensikan nanti dalam proses, jadi jika Anda memilih untuk menamainya secara berbeda, catat itu. | Administrator Couchbase | | Impor data ke Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Untuk file besar, Couchbase Capella mendukung impor baris perintah menggunakan cURL. Anda dapat menjelajahi opsi Impor secara lebih rinci di [Impor data](https://docs.couchbase.com/cloud/clusters/data-service/import-data-documents.html) dalam dokumentasi Couchbase Capella. | Administrator Couchbase | ### Uji dan verifikasi migrasi | Tugas | Deskripsi | Keterampilan yang dibutuhkan | | --- | --- | --- | | Verifikasi migrasi data. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | | Verifikasi migrasi indeks. | **Di Couchbase Capella Control Plane, di daftar dropdown **Tools** untuk cluster target Anda, pilih Indexes.** Verifikasi bahwa indeks dimigrasikan dan dibuat. | Administrator Couchbase | | Verifikasi hasil kueri. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | | Verifikasi hasil pencarian teks lengkap (berlaku jika Anda memigrasikan indeks FTS). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrator Couchbase | ## Sumber daya terkait **Siapkan migrasi** + [Memulai dengan uji coba gratis Couchbase Capella](https://cloud.couchbase.com/sign-up) + [Persyaratan penyedia cloud untuk Couchbase Capella](https://docs.couchbase.com/cloud/reference/aws.html) + [Pedoman ukuran Couchbase Capella](https://docs.couchbase.com/cloud/clusters/sizing.html) **Migrasi data dan indeks** + [Couchbase XDCR](https://docs.couchbase.com/cloud/clusters/xdcr/xdcr.html) + [Dokumentasi Couchbase Shell](https://couchbase.sh/docs/) **Couchbase SLAs Capella dan dukungan** + Perjanjian tingkat [layanan Couchbase Capella](https://www.couchbase.com/capellasla) () SLAs + [Kebijakan dukungan Couchbase Capella Service](https://www.couchbase.com/support-policy/cloud) ## Informasi tambahan Kode berikut adalah contoh [file konfigurasi untuk Couchbase Shell](https://couchbase.sh/docs/#_the_config_dotfiles).  ``` Version = 1 [[clusters]] identifier = "On-Prem-Cluster" hostnames = [""] default-bucket = "travel-sample" username = "" password = "" tls-cert-path = "/" data-timeout = "2500ms" connect-timeout = "7500ms" query-timeout = "75s" [[clusters]] identifier = "Capella-Cluster" hostnames = [""] default-bucket = "travel-sample" username = "" password = "" tls-cert-path = "/" data-timeout = "2500ms" connect-timeout = "7500ms" query-timeout = "75s" ``` Sebelum Anda menyimpan file konfigurasi, gunakan tabel berikut untuk memastikan bahwa Anda menambahkan sumber dan informasi cluster target Anda sendiri.   | | | | --- |--- | | | Gunakan alamat IP untuk cluster Couchbase Server yang dikelola sendiri. | | | Gunakan pengguna administrator untuk cluster Couchbase Server yang dikelola sendiri. | | | Gunakan jalur absolut ke file sertifikat root yang disimpan untuk cluster Couchbase Server yang dikelola sendiri. | | | Gunakan titik akhir koneksi untuk cluster Couchbase Capella Anda. | | | Gunakan pengguna database untuk cluster Couchbase Capella Anda. | | | Gunakan kata sandi pengguna database untuk cluster Couchbase Capella Anda. | | | Gunakan jalur absolut ke file sertifikat root yang disimpan untuk cluster Couchbase Capella Anda. |