Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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.