Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Hubungkan Amazon EC2 secara otomatis
Topik
Sebelum menyiapkan sambungan antara instans EC2 dan database Amazon DocumentDB baru, pastikan Anda memenuhi persyaratan yang dijelaskan dalam. Ikhtisar konektivitas otomatis dengan instans EC2 Jika Anda membuat perubahan pada grup keamanan setelah mengonfigurasi konektivitas, perubahan tersebut dapat memengaruhi koneksi antara instans EC2 dan database Amazon DocumentDB.
catatan
Anda hanya dapat mengatur koneksi antara instans EC2 dan database Amazon DocumentDB secara otomatis dengan menggunakan file. Konsol Manajemen AWS Anda tidak dapat mengatur koneksi secara otomatis dengan Amazon DocumentDB API AWS CLI atau Amazon.
Secara otomatis menghubungkan instans EC2 ke database Amazon DocumentDB baru
Proses berikut mengasumsikan Anda telah menyelesaikan langkah-langkah dalam Prasyarat topik.
Langkah-langkah
Langkah 1: Buat instans Amazon EC2
Pada langkah ini, Anda akan membuat instans Amazon EC2 di Wilayah yang sama dan Amazon VPC yang nantinya akan Anda gunakan untuk menyediakan klaster Amazon DocumentDB Anda.
-
Pada konsol Amazon EC2, pilih Luncurkan instans.
-
Masukkan nama atau pengenal di bidang Nama yang terletak di bagian Nama dan tag.
-
Di daftar drop-down Amazon Machine Image (AMI), cari Amazon Linux 2 AMI dan pilih.
-
Cari dan pilih t3.micro dalam daftar drop-down tipe Instance.
-
Di bagian Key pair (login), masukkan identifier dari key-pair yang ada, atau pilih Create new key pair.
Anda harus menyediakan pasangan kunci Amazon EC2.
-
Jika Anda memiliki pasangan kunci Amazon EC2:
-
Pilih pasangan kunci, pilih pasangan kunci Anda dari daftar.
-
Anda harus sudah memiliki file kunci pribadi (file.pem atau .ppk) yang tersedia untuk masuk ke instans Amazon EC2 Anda.
-
-
Jika Anda tidak memiliki pasangan kunci Amazon EC2:
-
Pilih Create new key pair, kotak dialog Create key pair muncul.
-
Masukkan nama di bidang Nama pasangan kunci.
-
Pilih jenis pasangan kunci dan format file kunci pribadi.
-
Pilih Buat pasangan kunci.
-
catatan
Untuk tujuan keamanan, kami sangat menyarankan menggunakan pasangan kunci untuk konektivitas SSH dan internet ke instans EC2 Anda.
-
-
Opsional: Di bagian Pengaturan jaringan, di bawah Firewall (grup keamanan), pilih Buat grup keamanan.
Pilih Buat grup keamanan (periksa semua aturan izin lalu lintas yang berlaku untuk konektivitas EC2 Anda).
catatan
Jika Anda ingin menggunakan grup keamanan yang ada, ikuti instruksi diHubungkan Amazon EC2 secara manual.
-
Di bagian Ringkasan, tinjau konfigurasi EC2 Anda dan pilih Launch instance jika benar.
Langkah 2: Buat cluster Amazon DocumentDB
Saat instans Amazon EC2 sedang disediakan, buat klaster Amazon DocumentDB Anda.
-
Navigasikan ke konsol Amazon DocumentDB dan pilih Klaster dari panel navigasi.
-
Pilih Buat.
-
Biarkan pengaturan tipe Cluster pada defaultnya dari Instance Based Cluster.
-
Dalam konfigurasi Cluster, untuk pengidentifikasi Cluster, masukkan nama unik. Perhatikan bahwa konsol akan mengubah semua nama cluster menjadi huruf kecil terlepas dari bagaimana mereka dimasukkan.
Biarkan versi Engine pada nilai defaultnya 5.0.0.
Untuk konfigurasi penyimpanan Cluster, tinggalkan pengaturan default Amazon DocumentDB Standard.
-
Dalam konfigurasi Instance:
Untuk kelas instans DB, pilih kelas yang dioptimalkan memori (termasuk kelas r) (ini adalah default).
Opsi instance lainnya adalah kelas NVMe yang didukung. Untuk mempelajari selengkapnya, lihat NVMecontoh -didukung.
Untuk kelas Instance, pilih jenis instance yang sesuai dengan kebutuhan Anda. Untuk penjelasan lebih rinci tentang kelas instance, lihatSpesifikasi kelas instans.
Untuk jumlah contoh, pilih nomor yang paling mencerminkan kebutuhan Anda. Ingat, semakin rendah angkanya, semakin rendah biayanya, dan semakin rendah read/write volume yang dapat dikelola oleh cluster.
-
Untuk Konektivitas, pilih Connect ke sumber daya komputasi EC2. Ini adalah contoh EC2 yang Anda buat di Langkah 1.
catatan
Menyambung ke sumber daya komputasi EC2 secara otomatis membuat grup keamanan untuk koneksi sumber daya komputasi EC2 ke cluster Amazon DocumentDB Anda. Setelah selesai membuat klaster dan ingin melihat grup keamanan yang baru dibuat, navigasikan ke daftar klaster dan pilih pengenal klaster Anda. Di tab Konektivitas & keamanan, buka Grup Keamanan dan temukan grup Anda di bawah Nama grup keamanan (ID). Ini akan berisi nama cluster Anda dan terlihat mirip dengan ini:
docdb-ec2-docdb-2023-12-11-21-33-41:i-0e4bb09985d2bbc4c (sg-0238e0b0bf0f73877). -
Di bagian Autentikasi, masukkan nama pengguna untuk pengguna utama, lalu pilih Self managed. Masukkan kata sandi, lalu konfirmasikan.
Jika Anda memilih Managed in AWS Secrets Manager, lihat Manajemen kata sandi dengan Amazon DocumentDB dan AWS Secrets Manager untuk informasi selengkapnya.
-
Pilih Buat klaster.
Langkah 3: Connect ke instans Amazon EC2
Untuk menginstal shell mongo, Anda harus terlebih dahulu terhubung ke instans Amazon EC2 Anda. Instalasi shell mongo memungkinkan Anda untuk terhubung ke dan kueri klaster Amazon DocumentDB Anda. Selesaikan langkah-langkah berikut:
-
Pada konsol Amazon EC2, navigasikan ke instans Anda dan lihat apakah instans yang baru saja Anda buat berjalan. Jika ya, pilih instance dengan mengklik ID instance.
-
Pilih Hubungkan.
-
Ada empat opsi tab untuk metode koneksi Anda: Amazon EC2 Instance Connect, Session Manager, SSH client, atau konsol serial EC2. Anda harus memilih satu dan mengikuti instruksinya. Setelah selesai, pilih Connect.
catatan
Jika alamat IP Anda berubah setelah Anda memulai penelusuran ini, atau Anda kembali ke lingkungan Anda di lain waktu, Anda harus memperbarui aturan masuk grup demoEC2 keamanan Anda untuk mengaktifkan lalu lintas masuk dari alamat API baru Anda.
Langkah 4: Instal MongoDB Shell
Anda sekarang dapat menginstal shell MongoDB, yang merupakan utilitas baris perintah yang Anda gunakan untuk menghubungkan dan menanyakan cluster Amazon DocumentDB Anda. Saat ini ada dua versi shell MongoDB: versi terbaru, mongosh, dan versi sebelumnya, mongo shell.
penting
Ada batasan yang diketahui dengan driver Node.js yang lebih lama dari versi 6.13.1, yang saat ini tidak didukung oleh otentikasi identitas IAM untuk Amazon DocumentDB. Driver dan alat Node.js yang menggunakan driver Node.js (misalnya, mongosh) harus ditingkatkan untuk menggunakan driver Node.js versi 6.13.1 atau lebih tinggi.
Ikuti instruksi di bawah ini untuk menginstal MongoDB shell untuk sistem operasi Anda.
Langkah 5: Kelola Amazon DocumentDB TLS
Unduh sertifikat CA untuk Amazon DocumentDB dengan kode berikut: wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem
catatan
Keamanan Lapisan Pengangkutan (TLS) diaktifkan secara default untuk setiap klaster Amazon DocumentDB baru. Untuk informasi selengkapnya, lihat Mengelola setelan TLS cluster Amazon DocumentDB.
Langkah 6: Connect ke cluster Amazon DocumentDB Anda
-
Di konsol Amazon DocumentDB, di bawah Clusters, temukan klaster Anda. Pilih cluster yang Anda buat dengan mengklik pengenal Cluster untuk cluster tersebut.
-
Di tab Konektivitas dan keamanan, cari Connect to this cluster dengan shell mongo di kotak Connect:
Salin string koneksi yang disediakan dan tempel ke terminal Anda.
Buat perubahan berikut untuk itu:
Pastikan Anda memiliki nama pengguna yang benar dalam string.
Hilangkan
<insertYourPassword>sehingga Anda diminta kata sandi oleh shell mongo saat Anda terhubung.Opsional: Jika Anda menggunakan otentikasi IAM, atau menggunakan shell MongoDB versi sebelumnya, ubah string koneksi Anda sebagai berikut:
mongo --ssl --host mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1.docdb.amazonaws.com:27017 --sslCAFile global-bundle.pem --username SampleUser1 --passwordGanti
mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1dengan informasi yang sama dari cluster Anda.
-
Tekan enter di terminal Anda. Anda sekarang diminta untuk kata sandi Anda. Masukkan kata sandi Anda.
-
Saat Anda memasukkan kata sandi dan dapat melihat perintah
rs0 [direct: primary] <env-name>>, Anda berhasil terhubung ke klaster Amazon DocumentDB Anda.
Mengalami masalah saat menghubungkan? Lihat Pemecahan Masalah Amazon DocumentDB.
Langkah 7: Masukkan dan kueri data
Sekarang setelah Anda terhubung ke klaster, Anda dapat menjalankan beberapa kueri untuk mengenali penggunaan basis data dokumen.
-
Untuk memasukkan satu dokumen, masukkan hal berikut ini:
db.collection.insertOne({"hello":"DocumentDB"})Anda mendapatkan output berikut ini:
{ acknowledged: true, insertedId: ObjectId('673657216bdf6258466b128c') } -
Anda dapat membaca dokumen yang Anda tulis dengan perintah
findOne()(karena hanya mengembalikan satu dokumen). Masukkan yang berikut ini:db.collection.findOne()Anda mendapatkan output berikut ini:
{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" } -
Untuk mengajukan beberapa kueri lagi, pertimbangkan kasus penggunaan profil game. Pertama, masukkan beberapa entri ke dalam koleksi berjudul
profiles. Masukkan yang berikut ini:db.profiles.insertMany([{ _id: 1, name: 'Matt', status: 'active', level: 12, score: 202 }, { _id: 2, name: 'Frank', status: 'inactive', level: 2, score: 9 }, { _id: 3, name: 'Karen', status: 'active', level: 7, score: 87 }, { _id: 4, name: 'Katie', status: 'active', level: 3, score: 27 } ])Anda mendapatkan output berikut ini:
{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } } -
Gunakan perintah
find()untuk mengembalikan semua dokumen dalam koleksi profil. Masukkan berikut ini:db.profiles.find()Anda akan mendapatkan output yang akan cocok dengan data yang Anda ketik di Langkah 3.
-
Gunakan kueri untuk satu dokumen dengan menggunakan filter. Masukkan yang berikut ini:
db.profiles.find({name: "Katie"})Anda mendapatkan output berikut ini:
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27} -
Sekarang mari kita coba untuk menemukan profil dan memodifikasinya dengan menggunakan perintah
findAndModify. Kami akan memberi pengguna Matt tambahan 10 poin dengan kode berikut:db.profiles.findAndModify({ query: { name: "Matt", status: "active"}, update: { $inc: { score: 10 } } })Anda mendapatkan output berikut (perhatikan bahwa skornya belum meningkat):
{ [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}] -
Anda dapat memverifikasi bahwa skornya telah berubah dengan kueri berikut:
db.profiles.find({name: "Matt"})Anda mendapatkan output berikut ini:
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }
Langkah 8: Jelajahi
Selamat! Anda telah berhasil menyelesaikan Panduan Quick Start untuk Amazon DocumentDB.
Apa selanjutnya? Pelajari cara memanfaatkan sepenuhnya basis data yang kuat ini dengan beberapa fitur populernya:
catatan
Untuk menghemat biaya, Anda dapat menghentikan klaster Amazon DocumentDB untuk mengurangi biaya atau menghapus klaster. Secara default, setelah 30 menit tidak aktif, AWS Cloud9 lingkungan Anda akan menghentikan instans Amazon EC2 yang mendasarinya.
Secara otomatis menghubungkan instans EC2 ke database Amazon DocumentDB yang ada
Prosedur berikut mengasumsikan Anda memiliki klaster Amazon DocumentDB yang sudah ada dan instans Amazon EC2 yang sudah ada.
Akses kluster Amazon DocumentDB Anda dan atur koneksi Amazon EC2
-
Akses kluster Amazon DocumentDB Anda.
-
Di panel navigasi, pilih Klaster.
Tip
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (
) di pojok kiri atas halaman. -
Tentukan cluster yang Anda inginkan dengan memilih tombol di sebelah kiri nama cluster.
-
Siapkan koneksi Amazon EC2.
-
Pilih Tindakan, lalu pilih Siapkan koneksi EC2.
Dialog Mengatur koneksi EC2 muncul.
-
Di bidang instans EC2, pilih instans EC2 yang ingin Anda sambungkan ke cluster Anda.
-
Pilih Lanjutkan.
Dialog Tinjau dan konfirmasi muncul.
-
Pastikan perubahannya benar. Kemudian pilih Siapkan koneksi.
-
Jika berhasil, verifikasi berikut akan muncul:
Ikhtisar konektivitas otomatis dengan instans EC2
Saat Anda mengatur koneksi antara instans EC2 dan database Amazon DocumentDB, Amazon DocumentDB secara otomatis mengonfigurasi grup keamanan VPC untuk instans EC2 Anda dan untuk database Amazon DocumentDB Anda.
Berikut ini adalah persyaratan untuk menghubungkan instans EC2 dengan database Amazon DocumentDB:
Instans EC2 harus ada di VPC yang sama dengan database Amazon DocumentDB.
Jika tidak ada instans EC2 di VPC yang sama, maka konsol menyediakan tautan untuk membuatnya.
Pengguna yang menyiapkan konektivitas harus memiliki izin untuk melakukan operasi-operasi Amazon EC2 berikut:
ec2:AuthorizeSecurityGroupEgressec2:AuthorizeSecurityGroupIngressec2:CreateSecurityGroupec2:DescribeInstancesec2:DescribeNetworkInterfacesec2:DescribeSecurityGroupsec2:ModifyNetworkInterfaceAttributeec2:RevokeSecurityGroupEgress
Jika instans basis data dan instans EC2 berada di Zona Ketersediaan yang berbeda, akun Anda mungkin dikenakan biaya lintas Zona Ketersediaan.
Saat Anda menyiapkan sambungan ke instans EC2, Amazon DocumentDB bertindak sesuai dengan konfigurasi grup keamanan saat ini yang terkait dengan database Amazon DocumentDB dan instans EC2, seperti yang dijelaskan dalam tabel berikut:
| Konfigurasi grup keamanan Amazon DocumentDB saat ini | Konfigurasi grup keamanan EC2 saat ini | Tindakan Amazon DocumentDB |
|---|---|---|
Ada satu atau lebih grup keamanan yang terkait dengan database Amazon DocumentDB dengan nama yang cocok dengan polanya. DocumentDB-ec2-n Grup keamanan yang cocok dengan pola belum diubah. Grup keamanan ini memiliki hanya satu aturan masuk dengan grup keamanan VPC instans EC2 sebagai sumbernya. |
Ada satu atau lebih grup keamanan yang terkait dengan instans EC2 dengan nama yang cocok dengan pola DocumentDB-ec2-n (di mana n adalah angka). Grup keamanan yang cocok dengan pola belum diubah. Grup keamanan ini hanya memiliki satu aturan keluar dengan grup keamanan VPC dari database Amazon DocumentDB sebagai sumbernya. |
Amazon DocumentDB tidak mengambil tindakan. Koneksi sudah dikonfigurasi secara otomatis antara instans EC2 dan database Amazon DocumentDB. Karena koneksi sudah ada antara instans EC2 dan database Amazon DocumentDB, grup keamanan tidak dimodifikasi. |
Salah satu syarat berikut berlaku:
|
Salah satu syarat berikut dipenuhi:
|
Tindakan Amazon DocumentDB: buat grup keamanan baru |
Ada satu atau lebih grup keamanan yang terkait dengan database Amazon DocumentDB dengan nama yang cocok dengan polanya. DocumentDB-ec2-n Grup keamanan yang cocok dengan pola belum diubah. Grup keamanan ini memiliki hanya satu aturan masuk dengan grup keamanan VPC instans EC2 sebagai sumbernya. |
Ada satu atau beberapa grup keamanan yang terkait dengan instans EC2 dengan nama yang cocok dengan pola ec2-DocumentDB-n. Namun, Amazon DocumentDB tidak dapat menggunakan salah satu grup keamanan ini untuk koneksi dengan database Amazon DocumentDB. Amazon DocumentDB tidak dapat menggunakan grup keamanan yang tidak memiliki satu aturan keluar dengan grup keamanan VPC dari database Amazon DocumentDB sebagai sumbernya. Amazon DocumentDB juga tidak dapat menggunakan grup keamanan yang telah dimodifikasi. |
Tindakan Amazon DocumentDB: buat grup keamanan baru |
Ada satu atau lebih grup keamanan yang terkait dengan database Amazon DocumentDB dengan nama yang cocok dengan polanya. DocumentDB-ec2-n Grup keamanan yang cocok dengan pola belum diubah. Grup keamanan ini memiliki hanya satu aturan masuk dengan grup keamanan VPC instans EC2 sebagai sumbernya. |
Ada grup keamanan EC2 yang valid untuk koneksi, tetapi tidak terkait dengan instans EC2. Grup keamanan ini memiliki nama yang cocok dengan pola DocumentDB-ec2-n. Grup tersebut belum diubah. Ini hanya memiliki satu aturan keluar dengan grup keamanan VPC dari database Amazon DocumentDB sebagai sumbernya. |
Tindakan Amazon DocumentDB: asosiasikan grup keamanan EC2 |
Salah satu syarat berikut berlaku:
|
Ada satu atau beberapa grup keamanan yang terkait dengan instans EC2 dengan nama yang cocok dengan pola DocumentDB-ec2-n. Grup keamanan yang cocok dengan pola belum diubah. Grup keamanan ini hanya memiliki satu aturan keluar dengan grup keamanan VPC dari database Amazon DocumentDB sebagai sumbernya. |
Tindakan Amazon DocumentDB: buat grup keamanan baru |
Tindakan Amazon DocumentDB: buat grup keamanan baru
Amazon DocumentDB mengambil tindakan berikut:
Membuat grup keamanan baru yang cocok dengan pola
DocumentDB-ec2-n. Grup keamanan ini memiliki aturan masuk dengan grup keamanan VPC instans EC2 sebagai sumbernya. Grup keamanan ini dikaitkan dengan database Amazon DocumentDB dan memungkinkan instans EC2 untuk mengakses database Amazon DocumentDB.Membuat grup keamanan baru yang cocok dengan pola
ec2-DocumentDB-n. Grup keamanan ini memiliki aturan keluar dengan grup keamanan VPC dari database Amazon DocumentDB sebagai sumbernya. Grup keamanan ini dikaitkan dengan instans EC2 dan memungkinkan instans EC2 mengirim lalu lintas ke database Amazon DocumentDB.
Tindakan Amazon DocumentDB: asosiasikan grup keamanan EC2
Amazon DocumentDB mengaitkan grup keamanan EC2 yang valid dan sudah ada dengan instans EC2. Grup keamanan ini memungkinkan instans EC2 untuk mengirim lalu lintas ke database Amazon DocumentDB.
Melihat sumber daya komputasi terhubung
Anda dapat menggunakan Konsol Manajemen AWS untuk melihat sumber daya komputasi yang terhubung ke database Amazon DocumentDB. Sumber daya yang ditampilkan meliputi koneksi sumber daya komputasi yang disiapkan secara otomatis. Anda dapat menyiapkan secara otomatis konektivitas dengan sumber daya komputasi dengan cara berikut:
Anda dapat memilih sumber daya komputasi saat membuat basis data. Untuk informasi selengkapnya, lihat Membuat cluster Amazon DocumentDB dan Membuat cluster DB multi-AZ.
Anda dapat menyiapkan konektivitas antara basis data yang ada dan sumber daya komputasi. Untuk informasi selengkapnya, lihat Hubungkan Amazon EC2 secara otomatis.
Sumber daya komputasi yang tercantum tidak menyertakan sumber daya yang dihubungkan secara manual dengan basis data. Misalnya, Anda dapat mengizinkan sumber daya komputasi untuk mengakses basis data secara manual dengan menambahkan aturan ke grup keamanan VPC yang terkait dengan basis data.
Agar sumber daya komputasi tercantum, syarat-syarat berikut harus dipenuhi:
Nama grup keamanan yang terkait dengan sumber daya komputasi cocok dengan pola
ec2-DocumentDB-n(di mana n adalah angka).Grup keamanan yang terkait dengan sumber daya komputasi memiliki aturan keluar dengan rentang port yang disetel ke port yang digunakan database Amazon DocumentDB.
Grup keamanan yang terkait dengan sumber daya komputasi memiliki aturan keluar dengan sumber yang disetel ke grup keamanan yang terkait dengan database Amazon DocumentDB.
Nama grup keamanan yang terkait dengan database Amazon DocumentDB cocok dengan
DocumentDB-ec2-npola (di mana n adalah angka).Grup keamanan yang terkait dengan database Amazon DocumentDB memiliki aturan masuk dengan rentang port yang disetel ke port yang digunakan database Amazon DocumentDB.
Grup keamanan yang terkait dengan database Amazon DocumentDB memiliki aturan masuk dengan sumber yang disetel ke grup keamanan yang terkait dengan sumber daya komputasi.
Untuk melihat sumber daya komputasi yang terhubung ke database Amazon DocumentDB
Di panel navigasi, pilih Databases, lalu pilih nama database Amazon DocumentDB.
Pada tab Konektivitas & keamanan, lihat sumber daya komputasi di bagian Sumber daya komputasi yang terhubung.