Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Connect menggunakan Amazon EC2
Bagian ini menjelaskan cara mengatur konektivitas antara cluster Amazon DocumentDB dan Amazon EC2 dan mengakses cluster Amazon DocumentDB dari instans Amazon EC2.
Ada dua opsi untuk mengkonfigurasi koneksi EC2:
+ [Sambungkan instans EC2 Anda secara otomatis ke database Amazon DocumentDB](connect-ec2-auto.md) — Gunakan fitur koneksi otomatis di konsol EC2 untuk secara otomatis mengonfigurasi koneksi antara instans EC2 Anda dan database Amazon DocumentDB baru atau yang sudah ada. Koneksi ini memungkinkan lalu lintas untuk melakukan perjalanan antara instans EC2 dan database Amazon DocumentDB. Opsi ini biasanya digunakan untuk menguji dan membuat grup keamanan baru.
+ [Hubungkan instans EC2 Anda secara manual ke database Amazon DocumentDB Anda](connect-ec2-manual.md) — Konfigurasikan koneksi antara instans EC2 Anda ke database Amazon DocumentDB Anda dengan mengonfigurasi dan menetapkan grup keamanan secara manual untuk mereproduksi konfigurasi yang dibuat oleh fitur koneksi otomatis. Opsi ini biasanya digunakan untuk mengubah pengaturan yang lebih maju dan menggunakan grup keamanan yang ada.
## Prasyarat
Terlepas dari opsinya, dan sebelum Anda membuat cluster Amazon DocumentDB pertama Anda, Anda harus melakukan hal berikut:
**Buatlah akun Amazon Web Services (AWS)**
Sebelum Anda dapat mulai menggunakan Amazon DocumentDB, Anda harus memiliki akun Amazon Web Services (AWS). AWS Akun ini gratis. Anda hanya membayar untuk layanan dan sumber daya yang Anda gunakan.
Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.
**Untuk mendaftar untuk Akun AWS**
1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup)
1. Ikuti petunjuk online.
Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon.
Saat Anda mendaftar untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
**Secara opsional, atur izin yang diperlukan AWS Identity and Access Management (IAM).**
Akses untuk mengelola sumber daya Amazon DocumentDB seperti cluster, instance, dan grup parameter cluster memerlukan kredensil yang dapat digunakan untuk AWS mengautentikasi permintaan Anda. Untuk informasi selengkapnya, lihat [Identity and Access Management untuk Amazon DocumentDB](security-iam.md).
1. Di bilah pencarian Konsol Manajemen AWS, ketik IAM dan pilih **IAM** di menu tarik-turun yang muncul.
1. Setelah Anda berada di konsol IAM, pilih **Pengguna** dari panel navigasi.
1. Pilih nama pengguna Anda.
1. Klik tombol **Tambahkan izin**.
1. Pilih **Lampirkan kebijakan yang ada secara langsung**.
1. Ketik `AmazonDocDBFullAccess` di bilah pencarian dan pilih itu setelah muncul di hasil pencarian.
1. Klik tombol biru di bagian bawah yang bertuliskan **Berikutnya: Tinjau**.
1. Klik tombol biru di bagian bawah yang bertuliskan **Tambahkan izin**.
**Buat Amazon Virtual Private Cloud (Amazon VPC)**
Tergantung di mana Wilayah AWS Anda berada, Anda mungkin atau mungkin tidak memiliki VPC default yang sudah dibuat. Jika Anda tidak memiliki VPC default, selesaikan langkah 1 dari [Memulai Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-getting-started.html) di *Panduan Pengguna Amazon VPC*. Ini akan memakan waktu kurang dari lima menit.
# Hubungkan Amazon EC2 secara otomatis
**Topics**
+ [Secara otomatis menghubungkan instans EC2 ke database Amazon DocumentDB baru](#auto-connect-ec2.process)
+ [Secara otomatis menghubungkan instans EC2 ke database Amazon DocumentDB yang ada](#auto-connect-ec2-existing-cluster)
+ [Ikhtisar konektivitas otomatis dengan instans EC2](#auto-connect-ec2.overview)
+ [Melihat sumber daya komputasi terhubung](#auto-connect-ec2.compute)
Sebelum menyiapkan sambungan antara instans EC2 dan database Amazon DocumentDB baru, pastikan Anda memenuhi persyaratan yang dijelaskan dalam. [Ikhtisar konektivitas otomatis dengan instans EC2](#auto-connect-ec2.overview) 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](connect-ec2.md#connect-ec2-prerequisites) topik.
**Topics**
+ [Langkah 1: Buat instans Amazon EC2](#auto-connect-ec2.launch-ec2-instance)
+ [Langkah 2: Buat cluster Amazon DocumentDB](#auto-connect-ec2.launch-cluster)
+ [Langkah 3: Connect ke instans Amazon EC2](#manual-connect-ec2.connect)
+ [Langkah 4: Instal MongoDB Shell](#auto-connect-ec2.install-mongo-shell)
+ [Langkah 5: Kelola Amazon DocumentDB TLS](#auto-connect-ec2.tls)
+ [Langkah 6: Connect ke cluster Amazon DocumentDB Anda](#auto-connect-ec2.connect-use)
+ [Langkah 7: Masukkan dan kueri data](#auto-cloud9-insert-query)
+ [Langkah 8: Jelajahi](#auto-connect-ec2.explore)
### 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.
1. Pada konsol Amazon EC2, pilih **Luncurkan instans**.
![\[Bagian Peluncuran instans di konsol Amazon EC2.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/launch-instance.png)
1. Masukkan nama atau pengenal di bidang **Nama** yang terletak di bagian **Nama dan tag**.
1. Di daftar drop-down **Amazon Machine Image (AMI)**, cari **Amazon Linux 2 AMI** dan pilih.
![\[Antarmuka Aplikasi dan Gambar OS dengan opsi Amazon Linux 2 AMI yang dipilih di bagian Mulai Cepat.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/linux2-ami.png)
1. Cari dan pilih **t3.micro** dalam daftar drop-down **tipe Instance**.
1. Di bagian **Key pair (login)**, masukkan identifier dari key-pair yang ada, atau pilih **Create new key pair**.
![\[Antarmuka Key pair menunjukkan bidang nama key pair dan opsi Create new key pair.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/key-pair.png)
Anda harus menyediakan pasangan kunci Amazon EC2.
+ Jika Anda memiliki pasangan kunci Amazon EC2:
1. Pilih pasangan kunci, pilih pasangan kunci Anda dari daftar.
1. 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:
1. Pilih **Create new key pair**, kotak dialog **Create key pair** muncul.
1. Masukkan nama di bidang **Nama pasangan kunci**.
1. Pilih **jenis pasangan kunci** dan **format file kunci pribadi**.
1. Pilih **Buat pasangan kunci**.
![\[Antarmuka Create key pair dengan bidang untuk nama, tipe, dan format file key pair. Tombol Create key pair ada di pojok kanan bawah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/create-key-pair.png)
**catatan**
Untuk tujuan keamanan, kami sangat menyarankan menggunakan pasangan kunci untuk konektivitas SSH dan internet ke instans EC2 Anda.
1. **Opsional:** Di **bagian Pengaturan jaringan**, di bawah **Firewall (grup keamanan)**, pilih **Buat grup keamanan**.
![\[Antarmuka pengaturan Jaringan menampilkan opsi untuk membuat grup keamanan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/firewall.png)
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 di[Hubungkan Amazon EC2 secara manual](connect-ec2-manual.md).
1. 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.
1. Navigasikan ke konsol Amazon DocumentDB dan pilih **Klaster** dari panel navigasi.
1. Pilih **Buat**.
1. Biarkan pengaturan **tipe Cluster** pada defaultnya dari **Instance Based Cluster**.
1. 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**.
1. Untuk **konfigurasi penyimpanan Cluster**, tinggalkan pengaturan default **Amazon DocumentDB** Standard.
1. 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](db-instance-nvme.md).
+ Untuk **kelas Instance**, pilih jenis instance yang sesuai dengan kebutuhan Anda. Untuk penjelasan lebih rinci tentang kelas instance, lihat[Spesifikasi kelas instans](db-instance-classes.md#db-instance-class-specs).
+ 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.
![\[Antarmuka konfigurasi dengan nilai default untuk pengidentifikasi cluster, versi engine, dan kelas instance, dengan jumlah instance yang disetel ke satu.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/instance-config.png)
1. Untuk **Konektivitas**, pilih **Connect ke sumber daya komputasi EC2**. Ini adalah contoh EC2 yang Anda buat di Langkah 1.
![\[Antarmuka konektivitas dengan opsi Connect to an EC2 compute resource dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2-connect.png)
**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)`.
1. 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](docdb-secrets-manager.md) untuk informasi selengkapnya.
1. 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:
1. 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.
![\[Tabel instans mencantumkan dua instance di konsol Amazon EC2.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/ec2-instance-table.png)
1. Pilih **Hubungkan**.
![\[Ringkasan instans untuk instans Amazon EC2. Tombol Connect mengarah ke sudut kanan atas.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/ec2-instance-summary.png)
1. 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**.
![\[Antarmuka yang menampilkan opsi konfigurasi untuk metode koneksi EC2 Instance Connect.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/connect-options.png)
**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.
------
#### [ On Amazon Linux ]
**Untuk menginstal shell MongoDB di Amazon Linux**
Jika Anda *tidak* menggunakan otentikasi IAM dan ingin menggunakan shell MongoDB terbaru (mongosh) untuk terhubung ke cluster Amazon DocumentDB Anda, ikuti langkah-langkah berikut:
1. Buat file repositori. Pada baris perintah instans EC2 yang Anda buat, jalankan perintah berikut:
```
echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo
```
1. Setelah selesai, instal mongosh dengan salah satu dari dua opsi perintah berikut di prompt perintah:
**Opsi 1** - Jika Anda memilih default Amazon Linux 2023 selama konfigurasi Amazon EC2, masukkan perintah ini:
```
sudo yum install -y mongodb-mongosh-shared-openssl3
```
**Opsi 2** - Jika Anda memilih Amazon Linux 2 selama konfigurasi Amazon EC2, masukkan perintah ini:
```
sudo yum install -y mongodb-mongosh
```
Jika Anda menggunakan otentikasi IAM, Anda harus menggunakan shell MongoDB versi sebelumnya (5.0) untuk terhubung ke cluster Amazon DocumentDB Anda, ikuti langkah-langkah berikut:
1. Buat file repositori. Pada baris perintah instans EC2 yang Anda buat, jalankan perintah berikut:
```
echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo
```
1. Setelah selesai, instal shell mongodb 5.0 dengan opsi perintah berikut di prompt perintah:
```
sudo yum install -y mongodb-org-shell
```
------
#### [ On Ubuntu ]
**Untuk menginstal mongosh di Ubuntu**
1. Impor kunci publik yang akan digunakan oleh sistem manajemen paket.
```
curl -fsSL https://pgp.mongodb.com/server-5.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-5.0.gpg
```
1. Buat file daftar `mongodb-org-5.0.list` untuk MongoDB menggunakan perintah yang sesuai untuk versi Ubuntu Anda.
```
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
```
1. Impor dan perbarui database paket lokal menggunakan perintah berikut:
```
sudo apt-get update
```
1. Instal mongosh.
```
sudo apt-get install -y mongodb-mongosh
```
Untuk informasi tentang menginstal versi sebelumnya dari MongoDB pada sistem Ubuntu Anda, lihat [Instal MongoDB Community Edition di Ubuntu](https://docs.mongodb.com/v3.6/tutorial/install-mongodb-on-ubuntu/).
------
#### [ On other operating systems ]
Untuk menginstal shell mongo pada sistem operasi lain, lihat [Instal MongoDB Community Edition](https://www.mongodb.com/docs/manual/administration/install-community/) dalam dokumentasi MongoDB.
------
### 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](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html).
### Langkah 6: Connect ke cluster Amazon DocumentDB Anda
1. Di konsol Amazon DocumentDB, **di bawah** Clusters, temukan klaster Anda. Pilih cluster yang Anda buat dengan mengklik **pengenal Cluster** untuk cluster tersebut.
1. Di tab **Konektivitas dan keamanan**, cari **Connect to this cluster dengan shell mongo** di kotak **Connect**:
![\[Pengaturan koneksi cluster dengan string koneksi MongoDB yang disorot untuk menghubungkan ke cluster Amazon DocumentDB menggunakan shell mongo.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/connect-mongosh.png)
Salin string koneksi yang disediakan dan tempel ke terminal Anda.
Buat perubahan berikut untuk itu:
1. Pastikan Anda memiliki nama pengguna yang benar dalam string.
1. Hilangkan `` sehingga Anda diminta kata sandi oleh shell mongo saat Anda terhubung.
1. 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 --password`
Ganti `mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1` dengan informasi yang sama dari cluster Anda.
1. Tekan enter di terminal Anda. Anda sekarang diminta untuk kata sandi Anda. Masukkan kata sandi Anda.
1. Saat Anda memasukkan kata sandi dan dapat melihat perintah `rs0 [direct: primary] >`, Anda berhasil terhubung ke klaster Amazon DocumentDB Anda.
Mengalami masalah saat menghubungkan? Lihat [Pemecahan Masalah Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html).
### Langkah 7: Masukkan dan kueri data
Sekarang setelah Anda terhubung ke klaster, Anda dapat menjalankan beberapa kueri untuk mengenali penggunaan basis data dokumen.
1. Untuk memasukkan satu dokumen, masukkan hal berikut ini:
```
db.collection.insertOne({"hello":"DocumentDB"})
```
Anda mendapatkan output berikut ini:
```
{
acknowledged: true,
insertedId: ObjectId('673657216bdf6258466b128c')
}
```
1. 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" }
```
1. 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 } }
```
1. 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.
1. 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}
```
1. 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}]
```
1. 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\$1 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:
+ [Mengelola Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html)
+ [Penskalaan](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html)
+ [Mencadangkan dan memulihkan](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html)
**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**
1. Akses kluster Amazon DocumentDB Anda.
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Tentukan cluster yang Anda inginkan dengan memilih tombol di sebelah kiri nama cluster.
1. Siapkan koneksi Amazon EC2.
1. Pilih **Tindakan**, lalu pilih **Siapkan koneksi EC2**.
![\[Daftar dropdown Tindakan dengan opsi Siapkan koneksi EC2 yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/setup-ec2-connect.png)
Dialog **Mengatur koneksi EC2** muncul.
1. Di bidang **instans EC2, pilih instans** EC2 yang ingin Anda sambungkan ke cluster Anda.
![\[Pengaturan antarmuka koneksi EC2 dengan daftar dropdown instans EC2 disorot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/setup-ec2-connect-dialog.png)
1. Pilih **Lanjutkan**.
Dialog **Tinjau dan konfirmasi** muncul.
1. Pastikan perubahannya benar. Kemudian pilih **Siapkan koneksi**.
![\[Antarmuka Tinjau dan konfirmasi yang menampilkan ringkasan perubahan. Tombol Atur koneksi ada di sudut kanan bawah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/setup-ec2-review-confirm.png)
Jika berhasil, verifikasi berikut akan muncul:
![\[Pesan konfirmasi untuk penyiapan koneksi yang berhasil antara database Amazon DocumentDB dan instans EC2.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/setup-ec2-connect-success.png)
## 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:AuthorizeSecurityGroupEgress`
+ `ec2:AuthorizeSecurityGroupIngress`
+ `ec2:CreateSecurityGroup`
+ `ec2:DescribeInstances`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:DescribeSecurityGroups`
+ `ec2:ModifyNetworkInterfaceAttribute`
+ `ec2: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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/connect-ec2-auto.html) | Salah satu syarat berikut dipenuhi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/connect-ec2-auto.html) | 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/connect-ec2-auto.html) | 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](db-cluster-create.md) 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](#connect-ec2-auto).
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-n` pola (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**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Databases, lalu pilih nama database** Amazon DocumentDB.
1. Pada tab **Konektivitas & keamanan**, lihat sumber daya komputasi di bagian Sumber daya **komputasi yang terhubung**.
# Hubungkan Amazon EC2 secara manual
**Topics**
+ [Langkah 1: Buat instans Amazon EC2](#manual-connect-ec2.launch-ec2-instance)
+ [Langkah 2: Buat grup keamanan](#manual-connect-ec2.security-group)
+ [Langkah 3: Buat klaster Amazon DocumentDB](#manual-connect-ec2.launch-cluster)
+ [Langkah 4: Hubungkan ke instans Amazon EC2 Anda](#manual-connect-ec2.connect)
+ [Langkah 5: Instal MongoDB Shell](#manual-connect-ec2.install-mongo-shell)
+ [Langkah 6: Kelola Amazon DocumentDB TLS](#manual-connect-ec2.tls)
+ [Langkah 7: Hubungkan ke klaster Amazon DocumentDB Anda](#manual-connect-ec2.connect-use)
+ [Langkah 8: Masukkan dan kueri data](#manual-cloud9-insert-query)
+ [Langkah 9: Jelajahi](#manual-connect-ec2.explore)
Langkah-langkah berikut mengasumsikan Anda telah menyelesaikan langkah-langkah dalam [Prasyarat](connect-ec2.md#connect-ec2-prerequisites) topik.
## 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.
1. Pada konsol Amazon EC2, pilih **Luncurkan instans**.
![\[Bagian Launch instance di konsol Amazon EC2.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/launch-instance.png)
1. Masukkan nama atau pengenal di bidang **Nama** yang terletak di bagian **Nama dan tag**.
1. Di daftar drop-down **Amazon Machine Image (AMI)**, cari **Amazon Linux 2 AMI** dan pilih.
![\[Antarmuka Aplikasi dan Gambar OS dengan opsi Amazon Linux 2 AMI yang dipilih di bagian Mulai Cepat.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/linux2-ami.png)
1. Cari dan pilih **t3.micro** dalam daftar drop-down **tipe Instance**.
1. Di bagian **Key pair (login)**, masukkan identifier dari key-pair yang ada, atau pilih **Create new key pair**.
![\[Antarmuka Key pair menunjukkan bidang nama key pair dan opsi Create new key pair.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/key-pair.png)
Anda harus menyediakan pasangan kunci Amazon EC2.
+ Jika Anda memiliki pasangan kunci Amazon EC2:
1. Pilih pasangan kunci, pilih pasangan kunci Anda dari daftar.
1. 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:
1. Pilih **Create new key pair**, kotak dialog **Create key pair** muncul.
1. Masukkan nama di bidang **Nama pasangan kunci**.
1. Pilih **jenis pasangan kunci** dan **format file kunci pribadi**.
1. Pilih **Buat pasangan kunci**.
![\[Antarmuka Create key pair dengan bidang untuk nama, tipe, dan format file key pair. Tombol Create key pair ada di pojok kanan bawah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/create-key-pair.png)
**catatan**
Untuk tujuan keamanan, kami sangat menyarankan menggunakan pasangan kunci untuk konektivitas SSH dan internet ke instans EC2 Anda.
1. Di **bagian Pengaturan jaringan**, di bawah **Firewall (grup keamanan)**, pilih **Buat grup keamanan** atau **Pilih grup keamanan yang ada**.
![\[Antarmuka pengaturan Jaringan menampilkan opsi untuk membuat grup keamanan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/firewall.png)
Jika Anda memilih untuk memilih grup keamanan yang ada, pilih salah satu dari daftar drop-down **grup keamanan umum**.
Jika Anda memilih untuk membuat grup keamanan baru, lakukan hal berikut:
1. Periksa semua aturan izin lalu lintas yang berlaku untuk konektivitas EC2 Anda.
1. Di bidang IP, pilih **IP Saya** atau pilih **Kustom** untuk memilih dari daftar blok CIDR, daftar awalan, atau grup keamanan. Kami tidak merekomendasikan **Anywhere** sebagai pilihan, kecuali instans EC2 Anda berada di jaringan yang terisolasi, karena memungkinkan akses alamat IP apa pun ke instans EC2 Anda.
![\[Dropdown IP Saya.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/ip-field.png)
1. Di bagian **Ringkasan**, tinjau konfigurasi EC2 Anda dan pilih **Launch instance** jika benar.
## Langkah 2: Buat grup keamanan
Anda sekarang akan membuat grup keamanan baru di Amazon VPC default Anda. Grup keamanan `demoDocDB` memungkinkan Anda untuk terhubung ke klaster Amazon DocumentDB Anda pada port 27017 (port default untuk Amazon DocumentDB) dari instans Amazon EC2 Anda.
1. Di [Konsol Manajemen Amazon EC2](https://console.aws.amazon.com/ec2), di bawah **Jaringan dan Keamanan**, pilih **Grup keamanan**.
![\[Panel navigasi konsol Amazon DocumentDB dengan opsi Grup Keamanan yang dipilih di dropdown Jaringan dan Keamanan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/nav-security-groups.png)
1. Pilih **Buat grup keamanan**.
![\[Tombol Buat grup keamanan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/create-sg-btn-2.png)
1. Di bagian **Detail dasar**:
1. Untuk **Nama grup keamanan**, masukkan `demoDocDB`.
1. Untuk **Deskripsi**, masukkan deskripsi.
1. Untuk **VPC**, terima penggunaan VPC default Anda.
1. Di bagian **Aturan masuk**, pilih **Tambahkan aturan**.
1. Untuk **Jenis**, pilih **Aturan TCP Kustom** (default).
1. Untuk **Rentang port**, masukkan `27017`.
1. Untuk **Sumber**, pilih **Kustom**. Di bidang di sebelahnya, cari grup keamanan yang baru saja Anda buat di langkah 1. Anda mungkin perlu untuk me-refresh peramban Anda bagi konsol Amazon EC2 untuk mengisi otomatis nama sumber .
![\[Bagian aturan masuk yang menampilkan bidang untuk jenis, protokol, rentang port, sumber, dan deskripsi. Tombol Tambah aturan ada di sudut kiri bawah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/inbound-rules.png)
1. Terima semua default lainnya dan pilih **Buat grup keamanan**.
![\[Tombol Buat grup keamanan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/create-sg-btn-2.png)
## Langkah 3: Buat klaster Amazon DocumentDB
Saat instans Amazon EC2 sedang disediakan, Anda akan membuat klaster Amazon DocumentDB Anda.
1. Navigasikan ke konsol Amazon DocumentDB dan pilih **Klaster** dari panel navigasi.
1. Pilih **Buat**.
1. Biarkan pengaturan **tipe Cluster** pada defaultnya dari **Instance Based Cluster**.
1. 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**.
1. Untuk **konfigurasi penyimpanan Cluster**, tinggalkan pengaturan default **Amazon DocumentDB** Standard.
1. 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](db-instance-nvme.md).
+ Untuk **kelas Instance**, pilih jenis instance yang sesuai dengan kebutuhan Anda. Untuk penjelasan lebih rinci tentang kelas instance, lihat[Spesifikasi kelas instans](db-instance-classes.md#db-instance-class-specs).
+ 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.
![\[Antarmuka konfigurasi dengan nilai default untuk pengidentifikasi cluster, versi engine, dan kelas instance, dengan jumlah instance yang disetel ke satu.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/instance-config.png)
1. Untuk **Konektivitas**, biarkan pengaturan default **Jangan sambungkan ke sumber daya komputasi EC2**.
**catatan**
Menyambung ke sumber daya komputasi EC2 secara otomatis membuat grup keamanan untuk koneksi Anda ke klaster Anda. Karena Anda membuat grup keamanan ini secara manual pada langkah sebelumnya, Anda harus memilih **Jangan sambungkan ke sumber daya komputasi EC2** agar tidak membuat kumpulan grup keamanan kedua.
1. 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](docdb-secrets-manager.md) untuk informasi selengkapnya.
1. Pilih **Buat klaster**.
## Langkah 4: Hubungkan ke instans Amazon EC2 Anda
Menghubungkan ke instans Amazon EC2 Anda akan memungkinkan Anda menginstal shell MongoDB. Instalasi shell mongo memungkinkan Anda untuk terhubung ke dan kueri klaster Amazon DocumentDB Anda. Selesaikan langkah-langkah berikut:
1. 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.
![\[Tabel instans mencantumkan dua instance di konsol Amazon EC2.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/ec2-instance-table.png)
1. Pilih **Hubungkan**.
![\[Ringkasan instans untuk instans Amazon EC2. Tombol Connect mengarah ke sudut kanan atas.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/ec2-instance-summary.png)
1. 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**.
![\[Antarmuka yang menampilkan opsi konfigurasi untuk metode koneksi EC2 Instance Connect.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec2/connect-options.png)
**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 5: 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.
------
#### [ On Amazon Linux ]
**Untuk menginstal shell MongoDB di Amazon Linux**
Jika Anda *tidak* menggunakan IAM dan ingin menggunakan shell MongoDB terbaru (mongosh) untuk terhubung ke cluster Amazon DocumentDB Anda, ikuti langkah-langkah berikut:
1. Buat file repositori. Pada baris perintah instans EC2 yang Anda buat, jalankan perintah berikut:
```
echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo
```
1. Setelah selesai, instal mongosh dengan salah satu dari dua opsi perintah berikut di prompt perintah:
**Opsi 1** - Jika Anda memilih default Amazon Linux 2023 selama konfigurasi Amazon EC2, masukkan perintah ini:
```
sudo yum install -y mongodb-mongosh-shared-openssl3
```
**Opsi 2** - Jika Anda memilih Amazon Linux 2 selama konfigurasi Amazon EC2, masukkan perintah ini:
```
sudo yum install -y mongodb-mongosh
```
Jika Anda menggunakan IAM, Anda harus menggunakan shell MongoDB versi sebelumnya (5.0) untuk terhubung ke cluster Amazon DocumentDB Anda, ikuti langkah-langkah ini:
1. Buat file repositori. Pada baris perintah instans EC2 yang Anda buat, jalankan perintah berikut:
```
echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo
```
1. Setelah selesai, instal shell mongodb 5.0 dengan opsi perintah berikut di prompt perintah:
```
sudo yum install -y mongodb-org-shell
```
------
#### [ On Ubuntu ]
**Untuk menginstal mongosh di Ubuntu**
1. Impor kunci publik yang akan digunakan oleh sistem manajemen paket.
```
curl -fsSL https://pgp.mongodb.com/server-5.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-5.0.gpg
```
1. Buat file daftar `mongodb-org-5.0.list` untuk MongoDB menggunakan perintah yang sesuai untuk versi Ubuntu Anda.
```
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
```
1. Impor dan perbarui database paket lokal menggunakan perintah berikut:
```
sudo apt-get update
```
1. Instal mongosh.
```
sudo apt-get install -y mongodb-mongosh
```
Untuk informasi tentang menginstal versi sebelumnya dari MongoDB pada sistem Ubuntu Anda, lihat [Instal MongoDB Community Edition di Ubuntu](https://docs.mongodb.com/v3.6/tutorial/install-mongodb-on-ubuntu/).
------
#### [ On other operating systems ]
Untuk menginstal shell mongo pada sistem operasi lain, lihat [Instal MongoDB Community Edition](https://www.mongodb.com/docs/manual/administration/install-community/) dalam dokumentasi MongoDB.
------
## Langkah 6: 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](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html).
## Langkah 7: Hubungkan ke klaster Amazon DocumentDB Anda
1. Di konsol Amazon DocumentDB, **di bawah** Clusters, temukan klaster Anda. Pilih cluster yang Anda buat dengan mengklik **pengenal Cluster** untuk cluster tersebut.
![\[Daftar klaster Amazon DocumentDB menampilkan klaster regional dengan detail instans utama.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-connect-choose.png)
1. Di tab **Konektivitas dan keamanan**, cari **Connect to this cluster dengan shell mongo** di kotak **Connect**:
![\[Pengaturan koneksi cluster dengan string koneksi MongoDB yang disorot untuk menghubungkan ke cluster Amazon DocumentDB menggunakan shell mongo.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/connect-mongosh.png)
Salin string koneksi yang disediakan dan tempel ke terminal Anda.
Buat perubahan berikut untuk itu:
1. Pastikan Anda memiliki nama pengguna yang benar dalam string.
1. Hilangkan `` sehingga Anda diminta kata sandi oleh shell mongo saat Anda terhubung.
1. 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 --password`
Ganti `mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1` dengan informasi yang sama dari cluster Anda.
1. Tekan enter di terminal Anda. Anda sekarang diminta untuk kata sandi Anda. Masukkan kata sandi Anda.
1. Saat Anda memasukkan kata sandi dan dapat melihat perintah `rs0 [direct: primary] >`, Anda berhasil terhubung ke klaster Amazon DocumentDB Anda.
Mengalami masalah saat menghubungkan? Lihat [Pemecahan Masalah Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html).
## Langkah 8: Masukkan dan kueri data
Sekarang setelah Anda terhubung ke klaster, Anda dapat menjalankan beberapa kueri untuk mengenali penggunaan basis data dokumen.
1. Untuk memasukkan satu dokumen, masukkan hal berikut ini:
```
db.collection.insertOne({"hello":"DocumentDB"})
```
Anda mendapatkan output berikut ini:
```
{
acknowledged: true,
insertedId: ObjectId('673657216bdf6258466b128c')
}
```
1. 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" }
```
1. 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 } }
```
1. 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.
1. 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}
```
1. 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}]
```
1. 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 9: Jelajahi
Selamat\$1 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:
+ [Mengelola Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html)
+ [Penskalaan](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html)
+ [Mencadangkan dan memulihkan](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html)
**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.