Last chance! 50% off DataCamp Premium
Sale ends in
MongoDB Atlas adalah layanan database berbasis cloud yang memungkinkan Anda melakukan deploy, mengelola, dan melakukan scale database MongoDB. Anda dapat mengelola Atlas melalui Atlas UI, antarmuka berbasis web, atau Atlas CLI, alat command-line yang memungkinkan Anda melakukan tugas yang sama menggunakan perintah.
MongoDB Atlas CLI menawarkan alternatif yang lebih cepat dibanding Atlas UI. Anda dapat menjalankan dan mengotomatiskan tugas manajemen database langsung dari terminal.
Dalam artikel ini, saya akan memandu Anda menggunakan Atlas CLI untuk mengelola database Anda.
Sebelum mulai, pastikan Anda memiliki:
MongoDB Atlas CLI mengikuti struktur perintah yang konsisten:
atlas [command] [subcommand] [flags]
Saat Anda menjalankan perintah tanpa subcommand atau flag apa pun, CLI menampilkan informasi bantuan yang mencakup:
Sebagai contoh, jika Anda menjalankan:
atlas clusters
Anda akan mendapatkan respons serupa ini:
Manage clusters for your project. The clusters command provides access to your cluster configurations. You can create, edit, and delete clusters.
Usage:
atlas clusters [command]
Aliases:
clusters, cluster
Available Commands:
list Return all clusters for your project.
describe Return the details for the specified cluster for your project.
advancedSettings Manage advanced configuration settings for your cluster.
...
Flags:
-h, --help help for clusters
Global Flags:
-P, --profile string Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.
Use "atlas clusters [command] --help" for more information about a command.
Nama perintah, argumen, dan nama flag di Atlas CLI peka huruf besar/kecil. Gunakan kapitalisasi persis seperti yang ditunjukkan pada contoh—misalnya, --orgId bukan --orgID.
Deployment adalah instance MongoDB yang berjalan untuk menyimpan dan melayani data Anda. Setiap deployment mencakup server database, penyimpanan, jaringan, dan backup otomatis. MongoDB Atlas menangani manajemen infrastruktur, sehingga Anda dapat fokus menggunakan database alih-alih memelihara server.
Untuk membuat deployment MongoDB, instal atau perbarui Atlas CLI, lalu jalankan perintah:
atlas setup
Perintah atlas setup memandu Anda melalui proses interaktif. Perintah ini meminta pilihan konfigurasi dan membuat proyek, menyediakan cluster, serta mengonfigurasi pengaturan keamanan dasar.
Jika Anda sudah memiliki deployment MongoDB Atlas dan ingin mengelolanya dengan CLI, Anda perlu melakukan autentikasi. Untuk masuk, jalankan:
atlas auth login
Perintah ini meminta Anda memilih jenis autentikasi, lalu memberikan kode verifikasi satu kali. Salin kode tersebut dan tempelkan di browser saat diminta. Misalnya:
atlas auth login
? Select authentication type: UserAccount
To verify your account, copy your one-time verification code:
QPWF-6GT4
Paste the code in the browser when prompted to activate your Atlas CLI. Your code will expire after 3 minutes.
To continue, go to https://account.mongodb.com/account/connect
Press Enter to open the browser and complete authentication...
Successfully logged in as your-email@example.com.
Setelah autentikasi, Anda akan memilih organisasi dan format output default. CLI menyimpan sesi Anda, tetapi akan kedaluwarsa secara berkala. Saat Anda melihat error "session expired", jalankan atlas auth login lagi.
Profil memungkinkan Anda mengelola beberapa lingkungan MongoDB Atlas dari instalasi CLI yang sama. Setiap profil menyimpan pengaturan koneksi untuk lingkungan yang berbeda, seperti development, staging, atau production.
Dengan profil, Anda dapat dengan cepat beralih antar lingkungan tanpa autentikasi ulang atau mengubah file konfigurasi. Ini berguna saat Anda memelihara proyek atau organisasi MongoDB Atlas terpisah untuk tahapan berbeda dalam alur kerja pengembangan Anda.
Praktik umum adalah membuat proyek Atlas terpisah untuk tiap lingkungan dan menggunakan profil untuk mengelolanya—misalnya:
Saat pertama kali menjalankan atlas auth login, CLI membuat profil default. Untuk membuat profil tambahan untuk lingkungan lain, gunakan flag --profile:
atlas auth login --profile dev
Ini membuat profil bernama "dev" dan memandu Anda melalui proses autentikasi. Ulangi untuk tiap lingkungan:
atlas auth login --profile staging
atlas auth login --profile production
Setiap profil menyimpan kredensial autentikasi, proyek default, dan pengaturan organisasi masing-masing.
Untuk melihat semua profil yang telah dikonfigurasi, jalankan:
atlas config list
Perintah ini menampilkan semua nama profil yang telah Anda buat.
Untuk melihat konfigurasi profil tertentu, jalankan:
atlas config describe <profileName>
Sebagai contoh:
atlas config describe dev
Ini menampilkan pengaturan profil, termasuk ID organisasi dan proyek default.
Untuk menggunakan profil tertentu pada sebuah perintah, tambahkan flag --profile:
atlas clusters list --profile production
Ini menampilkan daftar cluster menggunakan kredensial dan pengaturan dari profil production.
Anda juga dapat menetapkan profil default sehingga tidak perlu menyebutkannya di setiap perintah:
atlas config set --profile staging
Setelah menetapkan default, semua perintah akan menggunakan profil tersebut kecuali Anda menimpanya dengan flag --profile.
Untuk mengubah konfigurasi profil, jalankan:
atlas config set <setting> <value> --profile <profileName>
Sebagai contoh, untuk menetapkan proyek default untuk profil dev:
atlas config set project_id 5f8e8d9a1b2c3d4e5f6g7h8i --profile dev
Untuk mengganti nama profil, jalankan:
atlas config rename <oldName> <newName>
Sebagai contoh:
atlas config rename dev development
Proyek di MongoDB Atlas mengelompokkan cluster, pengguna, dan pengaturan Anda. Anggap proyek sebagai kontainer yang mengelompokkan sumber daya database terkait.
Setiap proyek berisi beberapa cluster dan memiliki kumpulan pengguna serta kontrol akses sendiri. Pemisahan ini berguna ketika Anda memiliki aplikasi, lingkungan, atau tim berbeda yang memerlukan sumber daya database terisolasi.
Untuk membuat proyek baru, jalankan:
atlas projects create <projectName> [options]
Gunakan nama proyek deskriptif yang menunjukkan tujuannya, seperti "ecommerce-transactions" atau "mobile-app-staging."
[options] mencakup flag yang memodifikasi bagaimana dan di mana proyek dibuat. Misalnya, Anda dapat menentukan organisasi tempat proyek akan dibuat:
atlas projects create mobile-app-staging --orgId <organizationId>
Flag --orgId menentukan organisasi tempat proyek dibuat. Ini wajib kecuali Anda telah menetapkan organisasi default. Anda dapat menjalankan perintah atlas organizations list untuk mendapatkan daftar organisasi Anda dan Id-nya.
In all examples, replace placeholders like <projectId>, <clusterName>, and <username> with your actual project, cluster, or user names and identifiers.
Untuk memperbarui pengaturan proyek, gunakan:
atlas projects update <projectId> [options]
Sebagai contoh, Anda dapat menggunakan flag --name sebagai opsi untuk mengubah nama proyek:
atlas projects update <projectId> --name newProjectName
Untuk menampilkan semua proyek dalam organisasi Anda, gunakan:
atlas projects list [options]
Perintah di atas menggunakan flag --orgId sebagai opsi untuk menentukan organisasi mana yang proyeksinya akan ditampilkan:
atlas projects list --orgId <organizationId>
Anda juga dapat mengatur format output, misalnya menampilkan hasil dalam JSON:
atlas projects list --output json
Anda dapat menghapus proyek menggunakan perintah Atlas CLI.
atlas projects delete <projectId> --orgId <organizationId>
Anda tidak dapat menghapus proyek yang masih memiliki cluster aktif. Jadi sebelum menghapus proyek, pastikan Anda menghapus semua cluster di dalamnya.
Cluster adalah kumpulan server MongoDB yang menyimpan data Anda. Atlas mengelola infrastruktur, replikasi, dan backup untuk cluster Anda.
Untuk membuat cluster baru, jalankan:
atlas clusters create <clusterName> [options]
[options] mencakup flag yang menentukan konfigurasi cluster. Misalnya, Anda dapat menyertakan opsi tambahan untuk mengonfigurasi penyedia cloud, region, dan tier harga MongoDB:
atlas clusters create myCluster --provider AWS --region US_EAST_1 --tier M0
Pada perintah ini, flag --provider menentukan penyedia cloud, seperti AWS, GCP, atau Azure. Flag --region menentukan region tempat cluster akan dideploy. Flag --tier menentukan ukuran cluster.
Jika Anda belum menetapkan proyek default, sertakan flag --projectId:
atlas clusters create myCluster --projectId <projectId> --provider AWS --region US_EAST_1 --tier M0
Untuk melihat detail tentang cluster tertentu, jalankan:
atlas clusters describe <clusterName> --projectId <projectId>
Perintah ini menampilkan konfigurasi, ukuran, region, dan connection string cluster.
Untuk menampilkan semua cluster di proyek Anda, jalankan:
atlas clusters list --projectId <projectId>
Flag --projectId wajib kecuali Anda telah menetapkan proyek default menggunakan:
atlas config set project_id <projectId>
Anda dapat menjeda cluster sementara tanpa menghapusnya. Ini menghentikan operasi cluster tetapi mempertahankan data dan konfigurasi Anda:
atlas clusters pause <clusterName> --projectId <projectId>
Untuk menghapus cluster secara permanen, jalankan:
atlas clusters delete <clusterName> --projectId <projectId>
Setelah membuat cluster, Anda harus mengonfigurasi keamanan jaringan sebelum dapat tersambung ke cluster tersebut.
Daftar akses IP mengontrol alamat IP mana yang dapat terhubung ke cluster MongoDB Atlas Anda. Setiap proyek dapat memiliki hingga 200 entri daftar akses IP. Anda dapat menambahkan alamat IP individual, rentang dengan notasi CIDR, atau ID security group AWS. Rentang notasi CIDR mendefinisikan blok alamat IP menggunakan IP dasar dan prefiks—misalnya, 192.168.0.0/24. ID security group AWS memungkinkan akses dari semua sumber daya dalam security group AWS yang ditentukan.
Untuk mengelola daftar akses IP, Anda harus memiliki akses Project Owner pada proyek.
Untuk menambahkan alamat IP Anda saat ini ke daftar akses, jalankan:
atlas accessLists create --currentIp --projectId <projectId>
Flag --currentIp secara otomatis menambahkan alamat IP mesin yang menjalankan perintah. Ini berguna saat Anda memerlukan akses cepat dari mesin pengembangan Anda.
Untuk menambahkan alamat IP tertentu, jalankan:
atlas accessLists create <ipAddress> --type ipAddress --projectId <projectId>
<ipAddress> adalah alamat IP yang ingin Anda izinkan. Misalnya:
atlas accessLists create 192.0.2.15 --type ipAddress --comment "Office network" --projectId <projectId>
Flag --comment menambahkan deskripsi untuk membantu Anda mengidentifikasi entri di kemudian hari.
Untuk menambahkan rentang alamat IP menggunakan notasi CIDR, jalankan:
atlas accessLists create <cidrBlock> --type cidrBlock --projectId <projectId>
Sebagai contoh:
atlas accessLists create 73.231.201.0/24 --type cidrBlock --comment "Development servers" --projectId <projectId>
Untuk menambahkan alamat IP yang otomatis kedaluwarsa setelah waktu tertentu, gunakan flag --deleteAfter. Anda dapat menetapkan tanggal kedaluwarsa hingga tujuh hari ke depan:
atlas accessLists create <ipAddress> --type ipAddress --deleteAfter <isoDateTime> --projectId <projectId>
Flag --deleteAfter menerima tanggal berformat ISO-8601. Misalnya:
atlas accessLists create 192.0.2.20 --type ipAddress --deleteAfter 2025-12-31T23:59:59Z --comment "Temporary contractor access" --projectId <projectId>
MongoDB Atlas secara otomatis menghapus entri setelah tanggal dan waktu yang ditentukan.
Untuk melihat semua entri daftar akses IP di proyek Anda, jalankan:
atlas accessLists list --projectId <projectId>
Untuk melihat detail tentang entri tertentu, jalankan:
atlas accessLists describe <entry> --projectId <projectId>
<entry> adalah alamat IP, blok CIDR, atau ID security group AWS yang ingin Anda lihat.
Untuk menghapus alamat IP dari daftar akses, jalankan:
atlas accessLists delete <entry> --projectId <projectId>
Peran memberikan hak istimewa untuk melakukan serangkaian tindakan pada sumber daya tertentu. Pengguna adalah entitas yang diberikan satu atau lebih peran yang menentukan apa yang dapat mereka akses di database.
Untuk mengonfigurasi pengguna dan peran database, Anda harus memiliki akses Organization Owner, Project Owner, atau Project Database Access Admin di MongoDB Atlas.
Untuk membuat pengguna database, jalankan:
atlas dbusers create [builtInRole] [options]
[builtInRole] adalah satu atau lebih peran bawaan yang akan ditetapkan ke pengguna. [options] mencakup flag yang menentukan kredensial dan konfigurasi pengguna. Misalnya:
atlas dbusers create --username myUser --password myPassword --role readWriteAnyDatabase --projectId <projectId>
Flag --username menentukan nama pengguna. Flag --password menentukan kata sandi. Flag --role menentukan peran yang akan ditetapkan. Dalam kasus ini, nama pengguna adalah myUser, sedangkan kata sandi adalah myPassword.
Untuk menampilkan semua pengguna database di proyek Anda, jalankan:
atlas dbusers list --projectId <projectId>
Untuk melihat detail tentang pengguna database tertentu, jalankan:
atlas dbusers describe <username> --projectId <projectId>
Anda juga dapat memperbarui pengguna database. Misalnya, untuk memperbarui kata sandi pengguna, jalankan:
atlas dbusers update myUser --password newPassword --projectId <projectId>
Untuk memperbarui peran pengguna, jalankan:
atlas dbusers update myUser --role readWriteAnyDatabase --role dbAdmin --projectId <projectId>
Untuk menghapus pengguna database tertentu, jalankan:
atlas dbusers delete <username> --projectId <projectId>
Ada dua kategori peran yang dapat Anda tetapkan kepada pengguna:
Peran bawaan adalah peran yang telah ditentukan oleh MongoDB Atlas. Peran ini mencakup kumpulan izin umum untuk berbagai penggunaan database, seperti:
local dan config.Anda tidak dapat mengedit atau menghapus peran bawaan. Anda hanya dapat menugaskannya ke pengguna. Untuk menugaskan peran bawaan saat membuat pengguna, tentukan peran dengan flag --role:
atlas dbusers create --username app-reader --password myPassword --role readAnyDatabase --projectId <projectId>
Untuk menugaskan atau mengubah peran pengguna yang sudah ada, jalankan:
atlas dbusers update app-reader --role readWriteAnyDatabase --projectId <projectId>
Lihat [Built-In Roles and Privileges](https://www.mongodb.com/docs/atlas/mongodb-users-roles-and-privileges/?utm_campaign=devrel&utm_source=third-party-content&utm_medium=cta&utm_content=atlas-cli-datacamp&utm_term=megan.grant) untuk peran bawaan lainnya yang dapat Anda tetapkan ke pengguna.
MongoDB Atlas memungkinkan Anda membuat peran kustom ketika peran bawaan tidak memenuhi kebutuhan Anda. Peran kustom mendefinisikan serangkaian tindakan hak istimewa spesifik yang sesuai dengan kebutuhan aplikasi atau tim Anda.
Saat membuat peran kustom, tentukan koleksi mana yang boleh diakses pengguna dan tindakan apa pada sumber daya yang boleh mereka lakukan—misalnya, membaca, menyisipkan, memperbarui, atau menghapus data.
Dalam definisi hak istimewa MongoDB, Anda harus menggunakan nama tindakan hak istimewa dalam huruf besar pada perintah CLI Anda, seperti FIND, bukan find. Lihat Privilege Actions untuk lebih banyak tindakan hak istimewa terdefinisi yang dapat dilakukan pengguna pada sumber daya.
Anda dapat mengelola peran kustom dengan Atlas CLI.
Untuk membuat peran kustom, jalankan:
atlas customDbRoles create <roleName> [options]
<roleName> adalah nama peran kustom yang ingin Anda buat. [options] mencakup flag yang menentukan izin peran—misalnya:
atlas customDbRoles create customAnalyticsRole --privilege FIND@myDatabase.users
Pada perintah di atas:
customAnalyticsRole adalah nama peran kustom baru. Anda dapat memilih nama deskriptif apa pun yang mencerminkan tujuan peran.--privilege menentukan tindakan pada sumber daya yang dapat dilakukan peran.action@database.collection, di mana @ memisahkan tindakan dari sumber daya.FIND adalah tindakan hak istimewa yang dikenali oleh MongoDB.myDatabase.users adalah sumber daya tempat hak istimewa berlaku—dalam hal ini, koleksi users di database myDatabase.Untuk melihat detail tentang peran kustom, jalankan:
atlas customDbRoles list --projectId <projectId>
Perintah di atas menampilkan semua peran kustom dan izinnya.
Untuk memperbarui peran kustom, jalankan:
atlas customDbRoles update <roleName> [options]
[options] mencakup flag yang menentukan apa yang akan diperbarui. Misalnya, untuk menambahkan hak istimewa baru pada peran yang ada, jalankan:
atlas customDbRoles update customAnalyticsRole --privilege FIND@myDatabase.analytics --privilege INSERT@myDatabase.logs --projectId <projectId>
Perintah di atas memperbarui customAnalyticsRole yang ada untuk memberikan hak istimewa tambahan. FIND@myDatabase.analytics memungkinkan peran membaca dokumen dari koleksi analytics, dan INSERT@myDatabase.logs memungkinkan menambahkan dokumen ke koleksi logs di database myDatabase.
Flag --projectId menentukan proyek MongoDB Atlas tempat peran tersebut berada.
Untuk menghapus peran kustom, jalankan:
atlas customDbRoles delete <roleName> --projectId <projectId>
Proses menugaskan peran kustom ke pengguna serupa dengan menugaskan peran bawaan. Gunakan flag --role dengan perintah atlas dbusers create atau atlas dbusers update:
atlas dbusers create --username analytics-user --password myPassword --role customAnalyticsRole --projectId <projectId>
Setelah membuat pengguna database dan menetapkan peran, Anda siap untuk tersambung ke cluster.
Connection string berisi informasi yang dibutuhkan aplikasi Anda untuk terhubung ke cluster Atlas. String ini mencakup hostname cluster, database autentikasi, dan opsi koneksi.
Sebelum Anda dapat menggunakan connection string, pastikan Anda telah mengonfigurasi daftar akses IP dan membuat setidaknya satu pengguna database.
Untuk mengambil connection string sebuah cluster, jalankan:
atlas clusters connectionStrings describe <clusterName> --projectId <projectId>
Perintah ini mengembalikan connection string SRV untuk cluster Anda.
MongoDB Atlas menyediakan dua jenis connection string:
Connection string standar (mongodb://): Mencantumkan semua node cluster secara eksplisit. Gunakan format ini saat Anda perlu menentukan alamat server secara individual.
Connection string SRV (mongodb+srv://): Menggunakan DNS untuk mengambil informasi cluster secara otomatis. Ini adalah format yang direkomendasikan karena otomatis diperbarui jika konfigurasi cluster Anda berubah.
Ganti <username> dan <password> pada connection string dengan kredensial pengguna database Anda:
mongodb+srv://<username>:<password>@cluster0.example.mongodb.net/
Sebagai contoh, jika nama pengguna Anda appUser dan kata sandinya securePass123:
mongodb+srv://appUser:securePass123@cluster0.example.mongodb.net/
Anda kemudian dapat menggunakan connection string ini dengan MongoDB Drivers, MongoDB Shell, atau alat MongoDB lainnya untuk terhubung ke cluster Anda.
Backup adalah salinan data database Anda yang dapat digunakan untuk memulihkan cluster jika data hilang atau rusak. Atlas secara otomatis membuat backup sesuai jadwal rutin.
Automated continuous backups are only available for M10+ dedicated clusters. M0 free-tier clusters do not have backup capabilities. M2/M5 shared clusters have basic cloud backups, but not continuous backup. For more information, see [Snapshots for Flex Clusters](https://www.mongodb.com/docs/atlas/backup-restore-cluster/?utm_campaign=devrel&utm_source=third-party-content&utm_medium=cta&utm_content=atlas-cli-datacamp&utm_term=megan.grant#snapshots-for-flex-clusters).
Untuk mengelola backup, Anda harus memiliki akses Organization Owner atau Project Owner di Atlas.
Untuk membuat backup segera, jalankan:
atlas backups snapshots create <clusterName> --desc "Backup description" --projectId <projectId>
Pada perintah di atas, --desc adalah flag wajib yang menjelaskan snapshot.
Untuk menampilkan semua backup untuk sebuah cluster, jalankan:
atlas backups snapshots list <clusterName> --projectId <projectId>
Untuk melihat pengaturan backup sebuah cluster, jalankan:
atlas backups schedule describe <clusterName> --projectId <projectId>
Untuk memulihkan data dari backup, jalankan:
atlas backups restores start <clusterName> --snapshotId <snapshotId> --targetClusterName <targetClusterName> --projectId <projectId>
Flag --snapshotId menentukan backup mana yang akan dipulihkan. Flag --targetClusterName menentukan nama cluster tempat data akan dipulihkan—misalnya:
atlas backups restores start myCluster --snapshotId 5f8e8d9a1b2c3d4e5f6g7h8i --targetClusterName myCluster-restored --projectId <projectId>
Untuk menghapus backup, jalankan:
atlas backups snapshots delete <snapshotId> --projectId <projectId>
Dalam artikel ini, saya telah memandu Anda melalui struktur perintah CLI, membuat deployment, mengelola proyek dan cluster, mengonfigurasi pengguna dan peran, serta mengelola backup. Anda dapat mengotomatiskan operasi ini dengan menggabungkannya ke dalam skrip, sehingga lebih mudah mengelola banyak lingkungan dan mengintegrasikan manajemen database ke alur kerja pengembangan Anda.
Tidak. CLI menyimpan sesi Anda setelah Anda menjalankan atlas auth login. Namun, demi alasan keamanan, sesi akan kedaluwarsa secara berkala. Anda hanya perlu autentikasi ulang saat melihat error "session expired".
Ya, Anda dapat mengelola cluster free tier dengan MongoDB Atlas CLI untuk sebagian besar operasi seperti membuat pengguna, mengelola peran, dan konfigurasi cluster. Namun, operasi backup tidak tersedia untuk cluster free atau shared tier.
Peran pengguna Atlas (seperti Organization Owner, Project Owner, dan Project Cluster Manager) mengontrol siapa yang dapat mengelola platform MongoDB Atlas itu sendiri melalui UI, CLI, atau API. Peran database (seperti read, readWrite, dan peran kustom) mengontrol apa yang dapat dilakukan pengguna database saat mereka terhubung ke database MongoDB. Anda memerlukan peran pengguna Atlas yang sesuai untuk membuat dan menetapkan peran database kepada pengguna database.
Ya, Anda dapat mengelola beberapa proyek dengan satu instalasi CLI. Anda dapat menetapkan proyek default saat autentikasi, atau menentukan proyek yang akan digunakan dengan menyertakan flag --projectId pada perintah Anda. Untuk bekerja dengan beberapa organisasi, gunakan flag --orgId. Anda dapat menampilkan semua proyek menggunakan atlas projects list dan organisasi menggunakan atlas organizations list.
Jalankan atlas organizations list untuk melihat semua organisasi Anda beserta ID-nya. Jalankan atlas projects list untuk melihat semua proyek Anda beserta ID-nya.

Kursus Teratas DataCamp
Kursus
Kursus
blogs
Dario Radečić
15 mnt

blogs
Javier Canales Luna
14 mnt
blogs
David Woods
13 mnt
blogs
Hugo Bowne-Anderson
13 mnt