Hubungkan Amazon EC2 secara manual - Amazon DocumentDB
Langkah 1: Buat EC2 instance AmazonLangkah 2: Membuat grup keamananLangkah 3: Buat klaster Amazon DocumentDBLangkah 4: Hubungkan ke EC2 instans Amazon AndaLangkah 5: Instal shell mongoLangkah 6: Kelola Amazon DocumentDB TLS Langkah 7: Hubungkan ke klaster Amazon DocumentDB AndaLangkah 8: Masukkan dan kueri dataLangkah 9: Jelajahi

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

Langkah-langkah berikut mengasumsikan Anda telah menyelesaikan langkah-langkah dalam Prasyarat topik.

Langkah 1: Buat EC2 instance Amazon

Pada langkah ini, Anda akan membuat EC2 instance Amazon di Wilayah dan Amazon VPC yang sama yang nantinya akan Anda gunakan untuk menyediakan cluster Amazon DocumentDB Anda.

  1. Di EC2 konsol Amazon, pilih Launch instance.

    Launch instance button with dropdown and Migrate a server option in AWS EC2 interface.

  2. Masukkan nama atau pengenal di bidang Nama yang terletak di bagian Nama dan tag.

  3. Di daftar drop-down Amazon Machine Image (AMI), cari Amazon Linux 2 AMI dan pilih.

    Application and OS Images selection interface with Quick Start options for various operating systems.

  4. Cari dan pilih t3.micro dalam daftar drop-down tipe Instance.

    Instance type dropdown showing t3.micro with 2 vCPU, 1 GiB memory, and pricing details.

  5. Di bagian Key pair (login), masukkan identifier dari key-pair yang ada, atau pilih Create new key pair.

    Key pair selection dropdown with option to create a new key pair for secure instance connection.

    Anda harus menyediakan EC2 key pair Amazon.

    Jika Anda memiliki EC2 key pair Amazon:

    1. Pilih pasangan kunci, pilih pasangan kunci Anda dari daftar.

    2. Anda harus sudah memiliki file kunci pribadi (file.pem atau .ppk) yang tersedia untuk masuk ke instance Amazon Anda. EC2

    Jika Anda tidak memiliki EC2 key pair Amazon:

    1. Pilih Create new key pair, kotak dialog Create key pair muncul.

    2. Masukkan nama di bidang Nama pasangan kunci.

    3. Pilih jenis pasangan kunci dan format file kunci pribadi.

    4. Pilih Buat pasangan kunci.

    Create key pair dialog with options for name, type, and private key file format.
    catatan

    Untuk tujuan keamanan, kami sangat merekomendasikan penggunaan pasangan kunci untuk keduanya SSH dan konektivitas internet ke instans Anda. EC2

  6. Di bagian Network seetings, di bawah Firewall (grup keamanan), pilih Buat grup keamanan atau Pilih grup keamanan yang ada.

    Network settings interface showing VPC, subnet, IP, and security group options.

    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 EC2 konektivitas Anda.

    2. Di bidang IP, pilih IP Saya atau pilih Kustom untuk memilih dari daftar CIDR blok, daftar awalan, atau grup sekurioty. Kami tidak merekomendasikan Anywhere sebagai pilihan, kecuali EC2 instans Anda berada di jaringan yang terisolasi, karena memungkinkan akses alamat IP apa pun ke EC2 instans Anda.

    Text field displaying an IP address with a dropdown arrow.

  7. Di bagian Ringkasan, tinjau EC2 konfigurasi Anda dan pilih Launch instance jika benar. Edit grup keamanan.

    EC2 instance summary showing configuration details and free tier information.

Langkah 2: Membuat grup keamanan

Anda sekarang akan membuat grup keamanan baru di Amazon default AndaVPC. Grup keamanan demoDocDB memungkinkan Anda untuk terhubung ke cluster Amazon DocumentDB di port 27017 (port default untuk Amazon DocumentDB) dari instans Amazon Anda. EC2

  1. Di Amazon EC2 Management Console, di bawah Jaringan dan Keamanan, pilih Grup keamanan.

    Navigation menu showing Network & Security options including Security Groups.

  2. Pilih Buat grup keamanan.

    Orange button labeled "Create security group" for initiating the process.

  3. Di bagian Detail dasar:

    1. Untuk Nama grup keamanan, masukkan demoDocDB.

    2. Untuk Deskripsi, masukkan deskripsi.

    3. Untuk VPC, terima penggunaan default AndaVPC.

    Security group configuration form with name, description, and VPC selection fields.

  4. Di bagian Aturan masuk, pilih Tambahkan aturan.

    1. Untuk Jenis, pilih TCPAturan Kustom.

    2. Untuk Rentang port, masukkan 27017.

    3. Untuk Tujuan, pilih Kustom. Di bidang di sebelahnya, cari grup keamanan yang baru saja Anda buat bernama demoEC2. Anda mungkin perlu menyegarkan browser Anda untuk EC2 konsol Amazon untuk mengisi nama demoEC2 sumber secara otomatis.

    Inbound rules configuration interface showing custom TCP rule for port 27017.

  5. Terima semua default lainnya dan pilih Buat grup keamanan.

    Orange button labeled "Create security group" for creating a new security group.

Langkah 3: Buat klaster Amazon DocumentDB

Saat EC2 instans Amazon sedang disediakan, Anda akan membuat cluster Amazon DocumentDB Anda.

  1. Navigasikan ke konsol Amazon DocumentDB dan pilih Klaster dari panel navigasi.

    Navigation pane showing Dashboard, Clusters, Performance Insights, and Snapshots options.

  2. Pilih Buat.

    Orange button labeled "Create" for initiating a new item or process.

  3. Biarkan pengaturan tipe Cluster pada defaultnya dari Instance Based Cluster.

    Klaster type selection with Instance Based Klaster option highlighted.

  4. Untuk Jumlah instans, pilih 1. Ini akan meminimalkan biaya. Biarkan pengaturan lain di defaultnya.

    Configuration form with klaster identifier, engine version, instance class, and number of instances.

  5. Untuk Konektivitas, biarkan pengaturan default Jangan sambungkan ke sumber daya EC2 komputasi.

    Connectivity options for compute resources, with "Don't connect to an EC2 compute resource" selected.
    catatan

    Menyambung ke sumber daya EC2 komputasi secara otomatis membuat grup keamanan untuk koneksi sumber daya EC2 komputasi Anda ke klaster Anda. Karena Anda membuat grup keamanan ini secara manual pada langkah sebelumnya, Anda harus memilih Jangan sambungkan ke sumber daya EC2 komputasi agar tidak membuat kumpulan grup keamanan kedua.

  6. Untuk Otentikasi, masukkan kredenal masuk. Penting: Anda akan memerlukan kredensi login untuk mengautentikasi klaster Anda di langkah selanjutnya.

    Authentication form with username and password fields, including input requirements.

  7. Hidupkan Tampilkan pengaturan lanjutan.

    Estimated hourly cost for DocumentDB instance with toggle for advanced settings and Create klaster button.

  8. Di bagian Pengaturan jaringan, untuk grup VPC keamanan Amazon, pilih demoDocDB.

    Network settings panel showing VPC, subnet group, and security group options for a klaster.

  9. Pilih Buat klaster.

    Orange button labeled "Create klaster" for initiating klaster creation process.

Langkah 4: Hubungkan ke EC2 instans Amazon Anda

Untuk menginstal shell mongo, Anda harus terlebih dahulu terhubung ke EC2 instans Amazon Anda. Instalasi shell mongo memungkinkan Anda untuk terhubung ke dan kueri klaster Amazon DocumentDB Anda. Selesaikan langkah-langkah berikut:

  1. Di EC2 konsol Amazon, navigasikan ke instans Anda dan lihat apakah instance yang baru saja Anda buat sedang berjalan. Jika ya, pilih instance dengan mengklik ID instance.

    EC2 console showing two instances, one stopped and one running, with details like ID and type.

  2. Pilih Hubungkan.

    Instance summary showing details like ID, IP addresses, state, and other configuration information.

  3. Ada empat opsi tab untuk metode koneksi Anda: Amazon EC2 Instance Connect, Session Manager, SSH client, atau EC2 serial console. Anda harus memilih satu dan mengikuti instruksinya. Setelah selesai, pilih Connect.

    EC2 Instance Connect interface showing connection options and instance details.
catatan

Jika alamat IP Anda berubah setelah Anda memulai panduan 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 baru Anda. API

Langkah 5: Instal shell mongo

Anda sekarang dapat menginstal shell mongo, yang merupakan utilitas baris perintah yang Anda gunakan untuk menghubungkan dan mengajukan kueri pada klaster Amazon DocumentDB Anda. Ikuti petunjuk di bawah ini untuk menginstal shell mongo untuk sistem operasi Anda.

On Amazon Linux
Untuk menginstal shell mongo di Amazon Linux

  1. Buat file repositori. Pada baris perintah EC2 instance Anda, jalankan perintah ikuti:

    echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo

  2. Setelah selesai, instal shell mongo dengan menjalankan perintah berikut:

    sudo yum install -y mongodb-org-shell
On Ubuntu 18.04
Untuk menginstal shell mongo di Ubuntu 18.04

  1. Impor kunci publik yang akan digunakan oleh sistem manajemen paket.

    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5

  2. Buat file daftar /etc/apt/sources.list.d/mongodb-org-3.6.list untuk MongoDB menggunakan perintah yang sesuai untuk versi Ubuntu Anda.

    Ubuntu 18.04

    echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.6 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
    catatan

    Perintah di atas akan menginstal shell mongo 3.6 untuk Bionic dan Xenial.

  3. Muat ulang basis data paket lokal menggunakan perintah berikut:

    sudo apt-get update

  4. Instal shell MongoDB.

    sudo apt-get install -y mongodb-org-shell

Untuk informasi tentang menginstal versi sebelumnya dari MongoDB pada sistem Ubuntu Anda, lihat Instal MongoDB Community Edition di Ubuntu.

 

On other operating systems

Untuk menginstal shell mongo pada sistem operasi lain, lihat Instal MongoDB Community Edition 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

Transport Layer Security (TLS) diaktifkan secara default untuk klaster Amazon DocumentDB baru. Untuk informasi selengkapnya, lihat Mengelola setelan klaster Amazon TLS DocumentDB.

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.

    DocumentDB klaster list showing one klaster with identifier, role, version, region, and status.

  2. Di tab Konektivitas dan keamanan, cari Connect to this cluster dengan shell mongo di kotak Connect:

    Command to connect to a MongoDB klaster using mongo shell with SSL and authentication details.

    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.

    2. Hilangkan <insertYourPassword> sehingga Anda diminta kata sandi oleh shell mongo saat Anda terhubung.

    String koneksi Anda akan terlihat serupa dengan berikut ini:

    mongo --ssl host docdb-2020-02-08-14-15-11. cluster.region.docdb.amazonaws.com:27107 --sslCAFile global-bundle.pem --username demoUser --password

  3. Tekan enter di terminal Anda. Anda sekarang diminta untuk kata sandi Anda. Masukkan kata sandi Anda.

  4. Saat Anda memasukkan kata sandi dan dapat melihat perintah rs0:PRIMARY>, Anda berhasil terhubung ke klaster Amazon DocumentDB Anda.

Mengalami masalah saat menghubungkan? Lihat Pemecahan Masalah Amazon DocumentDB.

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.insert({"hello":"DocumentDB"})

  2. Anda mendapatkan output berikut ini:

    WriteResult({ "nInserted" : 1 })

  3. Anda dapat membaca dokumen yang Anda tulis dengan perintah findOne() (karena hanya mengembalikan satu dokumen). Masukkan yang berikut ini:

    db.collection.findOne()

  4. Anda mendapatkan output berikut ini:

    { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

  5. 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}
            ])

  6. Anda mendapatkan output berikut ini:

    { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

  7. Gunakan perintah find() untuk mengembalikan semua dokumen dalam koleksi profil. Masukkan yang berikut ini:

    db.profiles.find()

  8. Anda akan mendapatkan output yang akan cocok dengan data yang Anda ketik di Langkah 5.

  9. Gunakan kueri untuk satu dokumen dengan menggunakan filter. Masukkan yang berikut ini:

    db.profiles.find({name: "Katie"})

  10. Anda harus mendapatkan kembali output ini:

    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}

  11. Sekarang mari kita coba untuk menemukan profil dan memodifikasinya dengan menggunakan perintah findAndModify. Kami akan memberi pengguna Matt sepuluh poin tambahan dengan kode berikut:

    
    db.profiles.findAndModify({
        query: { name: "Matt", status: "active"},
        update: { $inc: { score: 10 } }
    })

  12. Anda mendapatkan output berikut (perhatikan bahwa skornya belum meningkat):

    
    {
    "_id" : 1,
    "name" : "Matt",
    "status" : "active",
    "level" : 12,
    "score" : 202
    }

  13. Anda dapat memverifikasi bahwa skornya telah berubah dengan kueri berikut:

    db.profiles.find({name: "Matt"})

  14. Anda mendapatkan output berikut ini:

    { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }

Langkah 9: 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 EC2 instans Amazon yang mendasarinya.