MongoDB Atlas CLI, web arayüzüne hızlı bir alternatiftir. Veritabanı yönetim görevlerini doğrudan terminalinizden çalıştırabilir ve otomatikleştirebilirsiniz.
MongoDB Atlas, MongoDB veritabanlarını devreye almanızı, yönetmenizi ve ölçeklendirmenizi sağlayan bulut tabanlı bir veritabanı servisidir. Atlas'ı, web tabanlı bir arayüz olan Atlas UI veya aynı görevleri komutlarla gerçekleştiren komut satırı aracı Atlas CLI üzerinden yönetebilirsiniz.
MongoDB Atlas CLI, Atlas UI’a göre daha hızlı bir alternatiftir. Veritabanı yönetim görevlerini doğrudan terminalinizden çalıştırabilir ve otomatikleştirebilirsiniz.
Bu yazıda, veritabanlarınızı yönetmek için Atlas CLI kullanımını adım adım göstereceğim.
Önkoşullar
Başlamadan önce şunlara sahip olduğunuzdan emin olun:
Bir MongoDB Atlas hesabı.
Temel komut satırı bilgisi.
İşletim sisteminiz için Atlas CLI kurulum gereksinimleri.
CLI Komutlarının Yapısı
MongoDB Atlas CLI tutarlı bir komut yapısını izler:
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, --helphelpfor 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"formore information about a command.Altyapı:
Atlas CLI’de komut adları, argümanlar ve bayrak adları büyük/küçük harf duyarlıdır. Örneklerdeki büyük/küçük harfi aynen kullanın—örneğin, --orgId yazın, --orgID değil.
Bir MongoDB Dağıtımı Oluşturun
Dağıtım, verilerinizi saklayan ve sunan çalışan bir MongoDB örneğidir. Her dağıtım; veritabanı sunucularını, depolamayı, ağ bileşenlerini ve otomatik yedeklemeleri içerir. MongoDB Atlas altyapı yönetimini üstlenir; böylece sunucu bakımı yerine veritabanını kullanmaya odaklanabilirsiniz.
atlas setup komutu sizi etkileşimli bir süreçten geçirir. Yapılandırma seçimlerini sorar ve bir proje oluşturur, bir küme (cluster) sağlanır ve temel güvenlik ayarları yapılandırılır.
Mevcut Bir Dağıtımla Kimlik Doğrulaması Yapın
Zaten mevcut bir MongoDB Atlas dağıtımınız varsa ve bunu CLI ile yönetmek istiyorsanız kimlik doğrulaması yapmanız gerekir. Oturum açmak için şunu çalıştırın:
Bu komut sizden kimlik doğrulama türünü seçmenizi ister ve tek kullanımlık bir doğrulama kodu sağlar. Kodu kopyalayın ve tarayıcıda istendiğinde yapıştırın. Örneğin:
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 [email protected].Altyapı:
Kimlik doğrulamasından sonra varsayılan bir organizasyon ve çıktı formatı seçersiniz. CLI oturumunuzu saklar ancak belirli aralıklarla sona erer. "oturum süresi doldu" hatası gördüğünüzde tekrar atlas auth login çalıştırın.
Birden Fazla Ortam İçin Profilleri Yönetin
Profiller, aynı CLI kurulumundan birden fazla MongoDB Atlas ortamını yönetmenizi sağlar. Her profil; geliştirme, hazırlık (staging) veya üretim gibi farklı bir ortamın bağlantı ayarlarını saklar.
Profilleri kullanarak, yeniden kimlik doğrulaması yapmadan veya yapılandırma dosyalarını değiştirmeden ortamlar arasında hızla geçiş yapabilirsiniz. Bu, geliştirme iş akışınızın farklı aşamaları için ayrı MongoDB Atlas projeleri veya organizasyonları tuttuğunuzda kullanışlıdır.
Yaygın bir uygulama, her ortam için ayrı Atlas projeleri oluşturmak ve bunları profillerle yönetmektir—örneğin:
Geliştirme profili: Test için küçük bir M0 kümesi bulunan dev projenizi işaretler.
Staging profili: Üretim yapılandırmasını yansıtan staging projenizi işaretler.
Üretim profili: Üretim düzeyinde kümelere sahip üretim projenizi işaretler.
Farklı ortamlar için profiller oluşturun
İlk kez atlas auth login çalıştırdığınızda, CLI varsayılan bir profil oluşturur. Diğer ortamlar için ek profiller oluşturmak üzere --profile bayrağını kullanın:
MongoDB Atlas’ta projeler, kümelerinizi, kullanıcılarınızı ve ayarlarınızı organize eder. Bir projeyi, ilgili veritabanı kaynaklarını bir arada toplayan bir kapsayıcı olarak düşünebilirsiniz.
Her proje, birden fazla küme içerir ve kendi kullanıcı ve erişim kontrollerine sahiptir. Bu ayrım, farklı uygulamalar, ortamlar veya ekipler için izole veritabanı kaynaklarına ihtiyaç duyduğunuzda kullanışlıdır.
--orgId bayrağı, projenin oluşturulacağı organizasyonu belirtir. Varsayılan bir organizasyon ayarlamadıysanız zorunludur. Organizasyonlarınızın ve Id değerlerinin listesini almak için atlas organizations list komutunu çalıştırabilirsiniz.
In all examples, replace placeholders like <projectId>, <clusterName>, and <username> with your actual project, cluster, or user names and identifiers.Altyapı:
[options], küme yapılandırmasını belirten bayrakları içerir. Örneğin, bulut sağlayıcısı, bölge ve MongoDB fiyatlandırma katmanını yapılandırmak için ek seçenekler ekleyebilirsiniz:
Bu komutta --provider bayrağı AWS, GCP veya Azure gibi bulut sağlayıcısını belirtir. --region bayrağı, kümenin devreye alınacağı bölgeyi belirtir. --tier bayrağı ise küme boyutunu belirtir.
Varsayılan bir proje ayarlamadıysanız, --projectId bayrağını ekleyin:
Kümenizi oluşturduktan sonra, ona bağlanmadan önce ağ güvenliğini yapılandırmanız gerekir.
IP Erişim Listesi Yapılandırmasını Yönetin
Bir IP erişim listesi, hangi IP adreslerinin MongoDB Atlas kümelerinize bağlanabileceğini kontrol eder. Her projede en fazla 200 IP erişim listesi girdisi olabilir. Tekil IP adresleri, CIDR gösterimli aralıklar veya AWS güvenlik grubu kimlikleri ekleyebilirsiniz. CIDR gösterimli bir aralık, bir temel IP ve önek kullanarak bir IP adresi bloğunu tanımlar—örneğin 192.168.0.0/24. Bir AWS güvenlik grubu kimliği, belirtilen AWS güvenlik grubundaki tüm kaynaklardan erişime izin verir.
IP erişim listelerini yönetmek için projede Project Owner erişimine sahip olmanız gerekir.
Erişim listesine IP adresleri ekleyin
Geçerli IP adresinizi erişim listesine eklemek için şunu çalıştırın:
--currentIp bayrağı, komutu çalıştıran makinenin IP adresini otomatik olarak ekler. Geliştirme makinenizden hızlı erişime ihtiyaç duyduğunuzda kullanışlıdır.
Belirli bir IP adresi eklemek için şunu çalıştırın:
Belirli bir süreden sonra otomatik olarak sona erecek bir IP adresi eklemek için --deleteAfter bayrağını kullanın. Gelecekte en fazla yedi güne kadar sona erme tarihi ayarlayabilirsiniz:
Bir rol, belirli kaynaklar üzerinde bir dizi işlemi gerçekleştirme ayrıcalıkları verir. Bir kullanıcı, veritabanında neye erişebileceğini belirleyen bir veya birden fazla rol verilen varlıktır.
Veritabanı kullanıcılarını ve rolleri yapılandırmak için MongoDB Atlas’ta Organization Owner, Project Owner veya Project Database Access Admin erişimine sahip olmanız gerekir.
Kullanıcıları yönetin
Bir veritabanı kullanıcısı oluşturmak için şunu çalıştırın:
[builtInRole], kullanıcıya atanacak bir veya daha fazla yerleşik roldür. [options], kullanıcının kimlik bilgilerini ve yapılandırmasını belirten bayrakları içerir. Örneğin:
--username bayrağı kullanıcı adını, --password bayrağı parolayı, --role bayrağı atanacak rolü belirtir. Bu örnekte kullanıcı adı myUser, parola ise myPassword’tır.
Projede tüm veritabanı kullanıcılarını listelemek için şunu çalıştırın:
Bir kullanıcıya atayabileceğiniz iki kategori rol vardır:
Yerleşik roller
Özel roller
Yerleşik roller
Yerleşik roller, MongoDB Atlas’ın sağladığı ön tanımlı rollerdir. Farklı veritabanı kullanım senaryoları için yaygın izin setlerini içerirler; örneğin:
read: Belirli bir veritabanına salt okuma erişimi verir.
readWrite: Belirli bir veritabanındaki verileri okumanıza ve değiştirmenize olanak tanır.
readAnyDatabase:local ve config veritabanları hariç tüm veritabanlarına salt okuma erişimi verir.
readWriteAnyDatabase: Tüm veritabanlarına okuma ve yazma erişimi verir.
dbAdmin: Dizin oluşturma veya istatistikleri görüntüleme gibi belirli bir veritabanı için yönetim ayrıcalıkları sağlar.
dbAdminAnyDatabase: Tüm veritabanlarında yönetim ayrıcalıkları verir.
clusterAdmin: Çoğaltma ve parçalama dahil tüm kümeyi yönetmenizi sağlar.
userAdminAnyDatabase: Tüm veritabanlarında kullanıcı hesapları ve rolleri oluşturup değiştirmenizi sağlar.
Yerleşik rolleri düzenleyemez veya silemezsiniz. Yalnızca kullanıcılara atayabilirsiniz. Kullanıcı oluştururken yerleşik roller atamak için --role bayrağıyla rolü belirtin:
Kullanıcılara atayabileceğiniz diğer yerleşik roller için bkz. [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).
Özel roller
Yerleşik roller ihtiyaçlarınızı karşılamadığında MongoDB Atlas özel roller oluşturmanıza olanak tanır. Özel bir rol, uygulamanızın veya ekibinizin gereksinimlerine uyan belirli ayrıcalık eylemleri kümesini tanımlar.
Özel bir rol oluştururken, kullanıcıların hangi koleksiyonlara erişmesi gerektiğine ve kaynaklar üzerinde hangi eylemleri yapmasına izin verileceğine karar verin—örneğin veri okuma, ekleme, güncelleme veya silme.
MongoDB ayrıcalık tanımlarında, CLI komutunuzda ayrıcalık eylemi adının büyük harfle yazılmış halini kullanmanız gerekir; örneğin find değil FIND. Bir kullanıcının bir kaynak üzerinde gerçekleştirebileceği daha fazla tanımlı ayrıcalık eylemi için bkz. Privilege Actions.
Yukarıdaki komut, mevcut customAnalyticsRole rolünü ek ayrıcalıklar verecek şekilde günceller. [email protected], rolün analytics koleksiyonundan belgeleri okumasına; [email protected] ise myDatabase veritabanındaki logs koleksiyonuna belge eklemesine izin verir.
--projectId bayrağı, rolün hangi MongoDB Atlas projesine ait olduğunu belirtir.
Özel bir rolü bir kullanıcıya atama süreci, yerleşik bir rol atamaya benzer. atlas dbusers create veya atlas dbusers update komutlarıyla birlikte --role bayrağını kullanın:
Veritabanı kullanıcılarını oluşturup rolleri atadıktan sonra, kümenize bağlanmaya hazırsınız.
Bağlantı Dizelerini Alın
Bir bağlantı dizesi, uygulamalarınızın Atlas kümenize bağlanması için gereken bilgileri içerir. Dize; küme ana makine adı, kimlik doğrulama veritabanı ve bağlantı seçeneklerini içerir.
Bir bağlantı dizesini kullanmadan önce IP erişim listenizi yapılandırdığınızdan ve en az bir veritabanı kullanıcısı oluşturduğunuzdan emin olun.
Bir kümenin bağlantı dizisini alın
Bir kümenin bağlantı dizesini almak için şunu çalıştırın:
Bu komut, kümeniz için SRV bağlantı dizesini döndürür.
Bağlantı dizesi biçimleri
MongoDB Atlas iki tür bağlantı dizesi sağlar:
Standart bağlantı dizesi (mongodb://): Tüm küme düğümlerini açıkça listeler. Tek tek sunucu adreslerini belirtmeniz gerektiğinde bu biçimi kullanın.
SRV bağlantı dizesi (mongodb+srv://): Küme bilgilerini otomatik olarak almak için DNS kullanır. Küme yapılandırmanız değişirse otomatik olarak güncellendiği için önerilen biçim budur.
Bağlantı dizesini kullanın
Bağlantı dizesindeki <username> ve <password> alanlarını veritabanı kullanıcı kimlik bilgilerinizle değiştirin:
Bu bağlantı dizesini MongoDB Sürücüleri, MongoDB Shell veya diğer MongoDB araçlarıyla kümenize bağlanmak için kullanabilirsiniz.
Yedeklemeleri Yönetin
Yedeklemeler, verilerinizi kaybetmeniz veya bozulması durumunda kümenizi geri yüklemek için kullanabileceğiniz veritabanı verilerinizin kopyalarıdır. Atlas, düzenli bir program dahilinde otomatik olarak yedeklemeler oluşturur.
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).Altyapı:
Yedeklemeleri yönetmek için Atlas’ta Organization Owner veya Project Owner erişimine sahip olmanız gerekir.
İsteğe bağlı yedeklemeler oluşturun
Anında bir yedekleme oluşturmak için şunu çalıştırın:
--snapshotId bayrağı, hangi yedeğin geri yükleneceğini belirtir. --targetClusterName bayrağı ise verilerin geri yükleneceği kümenin adını belirtir—örneğin:
Bu yazıda, CLI komutlarının yapısını, dağıtım oluşturmayı, proje ve kümeleri yönetmeyi, kullanıcı ve rol yapılandırmayı ve yedeklemeleri yönetmeyi ele aldım. Bu işlemleri betiklerde birleştirerek otomatikleştirebilir, birden fazla ortamı yönetmeyi kolaylaştırabilir ve veritabanı yönetimini geliştirme iş akışınıza entegre edebilirsiniz.
FAQs
MongoDB Atlas CLI'ı her kullandığımda kimlik doğrulaması yapmam gerekir mi?⌄
Hayır. CLI, atlas auth login çalıştırdıktan sonra oturumunuzu saklar. Ancak güvenlik nedeniyle oturumlar periyodik olarak sona erer. Yalnızca "oturum süresi doldu" hatasını gördüğünüzde yeniden kimlik doğrulaması yapmanız gerekir.
Evet, çoğu işlem için (kullanıcı oluşturma, rollerin yönetimi ve küme yapılandırması gibi) MongoDB Atlas CLI ile ücretsiz katmanlı kümeleri yönetebilirsiniz. Ancak, yedekleme işlemleri ücretsiz veya paylaşımlı katmanlı kümelerde mevcut değildir.
MongoDB Atlas kullanıcı rolleri ile veritabanı rolleri arasındaki fark nedir?⌄
Atlas kullanıcı rolleri (Organization Owner, Project Owner ve Project Cluster Manager gibi), MongoDB Atlas platformunu UI, CLI veya API üzerinden kimin yönetebileceğini kontrol eder. Veritabanı rolleri (read, readWrite ve özel roller gibi) ise veritabanına bağlanan kullanıcıların neler yapabileceğini kontrol eder. Veritabanı kullanıcılarına veritabanı rolleri oluşturmak ve atamak için uygun Atlas kullanıcı rollerine sahip olmanız gerekir.
Aynı CLI kurulumu ile birden fazla MongoDB Atlas projesini yönetebilir miyim?⌄
Evet, tek bir CLI kurulumu ile birden fazla projeyi yönetebilirsiniz. Kimlik doğrulaması sırasında varsayılan bir proje ayarlayabilir veya komutlarınıza --projectId bayrağını ekleyerek kullanılacak projeyi belirtebilirsiniz. Birden fazla organizasyonla çalışmak için --orgId bayrağını kullanın. Tüm projelerinizi görüntülemek için atlas projects list ve organizasyonlarınızı görüntülemek için atlas organizations list komutlarını çalıştırabilirsiniz.
Organizasyon kimliğimi ve proje kimliğimi nasıl bulurum? ⌄
Tüm organizasyonlarınızı ve kimliklerini görmek için atlas organizations list komutunu çalıştırın. Tüm projelerinizi ve kimliklerini görmek için atlas projects list komutunu çalıştırın.
Algoritmalar, sistem tasarımı ve davranışsal senaryoları kapsayan bu temel sorularla teknik mülakat sürecine hakim olun. Uzman cevapları, kod örnekleri ve kanıtlanmış hazırlık stratejileri edinin.
Git deponuzu temiz tutmak için .gitignore’u nasıl kullanacağınızı öğrenin. Bu eğitim; temelleri, yaygın kullanım durumlarını ve başlamanıza yardımcı olacak pratik örnekleri kapsar!
MongoDB Atlas, MongoDB veritabanlarını devreye almanızı, yönetmenizi ve ölçeklendirmenizi sağlayan bulut tabanlı bir veritabanı servisidir. Atlas'ı, web tabanlı bir arayüz olan Atlas UI veya aynı görevleri komutlarla gerçekleştiren komut satırı aracı Atlas CLI üzerinden yönetebilirsiniz.
MongoDB Atlas CLI, Atlas UI’a göre daha hızlı bir alternatiftir. Veritabanı yönetim görevlerini doğrudan terminalinizden çalıştırabilir ve otomatikleştirebilirsiniz.
Bu yazıda, veritabanlarınızı yönetmek için Atlas CLI kullanımını adım adım göstereceğim.
Önkoşullar
Başlamadan önce şunlara sahip olduğunuzdan emin olun:
CLI Komutlarının Yapısı
MongoDB Atlas CLI tutarlı bir komut yapısını izler:
Bir komutu alt komut veya bayrak olmadan çalıştırdığınızda, CLI şu bilgileri içeren yardım çıktısını gösterir:
Örneğin şunu çalıştırırsanız:
Benzer bir çıktı alırsınız:
Atlas CLI’de komut adları, argümanlar ve bayrak adları büyük/küçük harf duyarlıdır. Örneklerdeki büyük/küçük harfi aynen kullanın—örneğin,
--orgIdyazın,--orgIDdeğil.Bir MongoDB Dağıtımı Oluşturun
Dağıtım, verilerinizi saklayan ve sunan çalışan bir MongoDB örneğidir. Her dağıtım; veritabanı sunucularını, depolamayı, ağ bileşenlerini ve otomatik yedeklemeleri içerir. MongoDB Atlas altyapı yönetimini üstlenir; böylece sunucu bakımı yerine veritabanını kullanmaya odaklanabilirsiniz.
Bir MongoDB dağıtımı oluşturmak için, Atlas CLI’yı kurun veya güncelleyin ve ardından şu komutu çalıştırın:
atlas setup komutu sizi etkileşimli bir süreçten geçirir. Yapılandırma seçimlerini sorar ve bir proje oluşturur, bir küme (cluster) sağlanır ve temel güvenlik ayarları yapılandırılır.
Mevcut Bir Dağıtımla Kimlik Doğrulaması Yapın
Zaten mevcut bir MongoDB Atlas dağıtımınız varsa ve bunu CLI ile yönetmek istiyorsanız kimlik doğrulaması yapmanız gerekir. Oturum açmak için şunu çalıştırın:
Bu komut sizden kimlik doğrulama türünü seçmenizi ister ve tek kullanımlık bir doğrulama kodu sağlar. Kodu kopyalayın ve tarayıcıda istendiğinde yapıştırın. Örneğin:
Kimlik doğrulamasından sonra varsayılan bir organizasyon ve çıktı formatı seçersiniz. CLI oturumunuzu saklar ancak belirli aralıklarla sona erer. "oturum süresi doldu" hatası gördüğünüzde tekrar
atlas auth loginçalıştırın.Birden Fazla Ortam İçin Profilleri Yönetin
Profiller, aynı CLI kurulumundan birden fazla MongoDB Atlas ortamını yönetmenizi sağlar. Her profil; geliştirme, hazırlık (staging) veya üretim gibi farklı bir ortamın bağlantı ayarlarını saklar.
Profilleri kullanarak, yeniden kimlik doğrulaması yapmadan veya yapılandırma dosyalarını değiştirmeden ortamlar arasında hızla geçiş yapabilirsiniz. Bu, geliştirme iş akışınızın farklı aşamaları için ayrı MongoDB Atlas projeleri veya organizasyonları tuttuğunuzda kullanışlıdır.
Yaygın bir uygulama, her ortam için ayrı Atlas projeleri oluşturmak ve bunları profillerle yönetmektir—örneğin:
Farklı ortamlar için profiller oluşturun
İlk kez
atlas auth loginçalıştırdığınızda, CLI varsayılan bir profil oluşturur. Diğer ortamlar için ek profiller oluşturmak üzere--profilebayrağını kullanın:Bu, "dev" adlı bir profil oluşturur ve sizi kimlik doğrulama sürecinden geçirir. Her ortam için tekrarlayın:
Her profil kendi kimlik bilgilerini, varsayılan proje ve organizasyon ayarlarını saklar.
Kullanılabilir profilleri listeleyin
Tüm yapılandırılmış profilleri görüntülemek için şunu çalıştırın:
Bu, oluşturduğunuz tüm profil adlarını gösterir.
Profil ayrıntılarını görüntüleyin
Belirli bir profilin yapılandırmasını görmek için şunu çalıştırın:
Örneğin:
Bu, varsayılan organizasyon ve proje kimlikleri dahil profil ayarlarını görüntüler.
Profiller arasında geçiş yapın
Bir komutta belirli bir profili kullanmak için
--profilebayrağını ekleyin:Bu, production profilinin kimlik bilgileri ve ayarlarıyla kümeleri listeler.
Ayrıca her komutta belirtmek zorunda kalmamak için varsayılan bir profil de ayarlayabilirsiniz:
Varsayılan ayarladıktan sonra, komutlar
--profilebayrağıyla geçersiz kılmadığınız sürece bu profili kullanır.Profil ayarlarını güncelleyin
Bir profilin yapılandırmasını değiştirmek için şunu çalıştırın:
Örneğin, dev profili için varsayılan projeyi ayarlamak üzere:
Profilleri yeniden adlandırın
Bir profili yeniden adlandırmak için şunu çalıştırın:
Örneğin:
Projeleri Yönetin
MongoDB Atlas’ta projeler, kümelerinizi, kullanıcılarınızı ve ayarlarınızı organize eder. Bir projeyi, ilgili veritabanı kaynaklarını bir arada toplayan bir kapsayıcı olarak düşünebilirsiniz.
Her proje, birden fazla küme içerir ve kendi kullanıcı ve erişim kontrollerine sahiptir. Bu ayrım, farklı uygulamalar, ortamlar veya ekipler için izole veritabanı kaynaklarına ihtiyaç duyduğunuzda kullanışlıdır.
Proje oluşturun
Yeni bir proje oluşturmak için şunu çalıştırın:
"ecommerce-transactions" veya "mobile-app-staging" gibi, amacını belirten açıklayıcı bir proje adı kullanın.
[options], projenin nasıl ve nerede oluşturulacağını değiştiren bayrakları içerir. Örneğin, projenin oluşturulacağı organizasyonu belirtebilirsiniz:--orgIdbayrağı, projenin oluşturulacağı organizasyonu belirtir. Varsayılan bir organizasyon ayarlamadıysanız zorunludur. Organizasyonlarınızın veIddeğerlerinin listesini almak içinatlas organizations listkomutunu çalıştırabilirsiniz.Projeleri güncelleyin
Proje ayarlarını güncellemek için şunu kullanın:
Örneğin, proje adını değiştirmek için seçenek olarak
--namebayrağını kullanabilirsiniz:Projeleri listeleyin
Organizasyonunuzdaki tüm projeleri listelemek için şunu kullanın:
Yukarıdaki komut, hangi organizasyondaki projelerin listeleneceğini belirtmek için seçenek olarak
--orgIdbayrağını kullanır:Ayrıca çıktı biçimini de kontrol edebilirsiniz; örneğin sonuçları JSON olarak göstermek için:
Projeleri silin
Bir projeyi Atlas CLI komutuyla silebilirsiniz.
İçinde etkin kümeler bulunan bir projeyi silemezsiniz. Bu yüzden bir projeyi silmeden önce içindeki tüm kümeleri sildiğinizden emin olun.
Kümeleri Yönetin
Kümeler, verilerinizi saklayan MongoDB sunucuları gruplarıdır. Atlas, kümeleriniz için altyapı, çoğaltma ve yedeklemeyi yönetir.
Kümeler oluşturun
Yeni bir küme oluşturmak için şunu çalıştırın:
[options], küme yapılandırmasını belirten bayrakları içerir. Örneğin, bulut sağlayıcısı, bölge ve MongoDB fiyatlandırma katmanını yapılandırmak için ek seçenekler ekleyebilirsiniz:Bu komutta
--providerbayrağı AWS, GCP veya Azure gibi bulut sağlayıcısını belirtir.--regionbayrağı, kümenin devreye alınacağı bölgeyi belirtir.--tierbayrağı ise küme boyutunu belirtir.Varsayılan bir proje ayarlamadıysanız,
--projectIdbayrağını ekleyin:Kümeleri tanımlayın
Belirli bir küme hakkında ayrıntıları görüntülemek için şunu çalıştırın:
Bu komut, kümenin yapılandırmasını, boyutunu, bölgesini ve bağlantı dizelerini gösterir.
Kümeleri listeleyin
Projenizdeki tüm kümeleri listelemek için şunu çalıştırın:
--projectIdbayrağı, aşağıdakini kullanarak varsayılan bir proje ayarlamadığınız sürece zorunludur:Kümeleri duraklatın
Bir kümeyi silmeden geçici olarak duraklatabilirsiniz. Bu, kümenin işlemlerini durdurur ancak verilerinizi ve yapılandırmanızı korur:
Kümeleri silin
Bir kümeyi kalıcı olarak silmek için şunu çalıştırın:
Kümenizi oluşturduktan sonra, ona bağlanmadan önce ağ güvenliğini yapılandırmanız gerekir.
IP Erişim Listesi Yapılandırmasını Yönetin
Bir IP erişim listesi, hangi IP adreslerinin MongoDB Atlas kümelerinize bağlanabileceğini kontrol eder. Her projede en fazla 200 IP erişim listesi girdisi olabilir. Tekil IP adresleri, CIDR gösterimli aralıklar veya AWS güvenlik grubu kimlikleri ekleyebilirsiniz. CIDR gösterimli bir aralık, bir temel IP ve önek kullanarak bir IP adresi bloğunu tanımlar—örneğin
192.168.0.0/24. Bir AWS güvenlik grubu kimliği, belirtilen AWS güvenlik grubundaki tüm kaynaklardan erişime izin verir.IP erişim listelerini yönetmek için projede Project Owner erişimine sahip olmanız gerekir.
Erişim listesine IP adresleri ekleyin
Geçerli IP adresinizi erişim listesine eklemek için şunu çalıştırın:
--currentIpbayrağı, komutu çalıştıran makinenin IP adresini otomatik olarak ekler. Geliştirme makinenizden hızlı erişime ihtiyaç duyduğunuzda kullanışlıdır.Belirli bir IP adresi eklemek için şunu çalıştırın:
<ipAddress>, izin vermek istediğiniz IP adresidir. Örneğin:--commentbayrağı, girişi daha sonra tanımlamanıza yardımcı olacak bir açıklama ekler.CIDR gösterimini kullanarak bir IP adresi aralığı eklemek için şunu çalıştırın:
Örneğin:
Geçici erişim listesi girişleri oluşturun
Belirli bir süreden sonra otomatik olarak sona erecek bir IP adresi eklemek için
--deleteAfterbayrağını kullanın. Gelecekte en fazla yedi güne kadar sona erme tarihi ayarlayabilirsiniz:--deleteAfterbayrağı ISO-8601 biçiminde bir tarih kabul eder. Örneğin:MongoDB Atlas, belirtilen tarih ve saatten sonra girişi otomatik olarak kaldırır.
IP erişim listesi girişlerini listeleyin
Projenizdeki tüm IP erişim listesi girişlerini görüntülemek için şunu çalıştırın:
Belirli bir giriş hakkında ayrıntı görüntülemek için şunu çalıştırın:
<entry>, görüntülemek istediğiniz IP adresi, CIDR bloğu veya AWS güvenlik grubu kimliğidir.IP erişim listesi girişlerini silin
Bir IP adresini erişim listesinden kaldırmak için şunu çalıştırın:
Kullanıcıları ve Rolleri Yönetin
Bir rol, belirli kaynaklar üzerinde bir dizi işlemi gerçekleştirme ayrıcalıkları verir. Bir kullanıcı, veritabanında neye erişebileceğini belirleyen bir veya birden fazla rol verilen varlıktır.
Veritabanı kullanıcılarını ve rolleri yapılandırmak için MongoDB Atlas’ta Organization Owner, Project Owner veya Project Database Access Admin erişimine sahip olmanız gerekir.
Kullanıcıları yönetin
Bir veritabanı kullanıcısı oluşturmak için şunu çalıştırın:
[builtInRole], kullanıcıya atanacak bir veya daha fazla yerleşik roldür.[options], kullanıcının kimlik bilgilerini ve yapılandırmasını belirten bayrakları içerir. Örneğin:--usernamebayrağı kullanıcı adını,--passwordbayrağı parolayı,--rolebayrağı atanacak rolü belirtir. Bu örnekte kullanıcı adımyUser, parola isemyPassword’tır.Projede tüm veritabanı kullanıcılarını listelemek için şunu çalıştırın:
Belirli bir veritabanı kullanıcısı hakkında ayrıntı görüntülemek için şunu çalıştırın:
Veritabanı kullanıcısını da güncelleyebilirsiniz. Örneğin, bir kullanıcının parolasını güncellemek için şunu çalıştırın:
Bir kullanıcının rollerini güncellemek için şunu çalıştırın:
Belirli bir veritabanı kullanıcısını silmek için şunu çalıştırın:
Rolleri yönetin
Bir kullanıcıya atayabileceğiniz iki kategori rol vardır:
Yerleşik roller
Yerleşik roller, MongoDB Atlas’ın sağladığı ön tanımlı rollerdir. Farklı veritabanı kullanım senaryoları için yaygın izin setlerini içerirler; örneğin:
localveconfigveritabanları hariç tüm veritabanlarına salt okuma erişimi verir.Yerleşik rolleri düzenleyemez veya silemezsiniz. Yalnızca kullanıcılara atayabilirsiniz. Kullanıcı oluştururken yerleşik roller atamak için
--rolebayrağıyla rolü belirtin:Mevcut bir kullanıcının rolünü atamak veya değiştirmek için şunu çalıştırın:
Kullanıcılara atayabileceğiniz diğer yerleşik roller için bkz. [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).
Özel roller
Yerleşik roller ihtiyaçlarınızı karşılamadığında MongoDB Atlas özel roller oluşturmanıza olanak tanır. Özel bir rol, uygulamanızın veya ekibinizin gereksinimlerine uyan belirli ayrıcalık eylemleri kümesini tanımlar.
Özel bir rol oluştururken, kullanıcıların hangi koleksiyonlara erişmesi gerektiğine ve kaynaklar üzerinde hangi eylemleri yapmasına izin verileceğine karar verin—örneğin veri okuma, ekleme, güncelleme veya silme.
MongoDB ayrıcalık tanımlarında, CLI komutunuzda ayrıcalık eylemi adının büyük harfle yazılmış halini kullanmanız gerekir; örneğin find değil FIND. Bir kullanıcının bir kaynak üzerinde gerçekleştirebileceği daha fazla tanımlı ayrıcalık eylemi için bkz. Privilege Actions.
Özel rolleri Atlas CLI ile yönetebilirsiniz.
Özel bir rol oluşturmak için şunu çalıştırın:
<roleName>, oluşturmak istediğiniz özel rolün adıdır.[options], rolün izinlerini belirten bayrakları içerir—örneğin:Yukarıdaki komutta:
customAnalyticsRole, yeni özel rolün adıdır. Rolün amacını yansıtan açıklayıcı bir ad seçebilirsiniz.--privilegebayrağı, rolün kaynaklar üzerinde hangi eylemleri yapabileceğini belirtir.[email protected]şeklindedir; burada@, eylem ile kaynağı ayırır.FIND, MongoDB tarafından tanınan bir ayrıcalık eylemidir.myDatabase.users, ayrıcalığın uygulandığı kaynaktır—bu örnekte,myDatabaseveritabanındaki users koleksiyonu.Özel bir rol hakkında ayrıntı görüntülemek için şunu çalıştırın:
Yukarıdaki komut, tüm özel rolleri ve izinlerini gösterir.
Özel bir rolü güncellemek için şunu çalıştırın:
[options], nelerin güncelleneceğini belirten bayrakları içerir. Örneğin, mevcut bir role yeni bir ayrıcalık eklemek için şunu çalıştırın:Yukarıdaki komut, mevcut
customAnalyticsRolerolünü ek ayrıcalıklar verecek şekilde günceller.[email protected], rolünanalyticskoleksiyonundan belgeleri okumasına;[email protected]isemyDatabaseveritabanındakilogskoleksiyonuna belge eklemesine izin verir.--projectIdbayrağı, rolün hangi MongoDB Atlas projesine ait olduğunu belirtir.Özel bir rolü silmek için şunu çalıştırın:
Özel bir rolü bir kullanıcıya atama süreci, yerleşik bir rol atamaya benzer.
atlas dbusers createveyaatlas dbusers updatekomutlarıyla birlikte--rolebayrağını kullanın:Veritabanı kullanıcılarını oluşturup rolleri atadıktan sonra, kümenize bağlanmaya hazırsınız.
Bağlantı Dizelerini Alın
Bir bağlantı dizesi, uygulamalarınızın Atlas kümenize bağlanması için gereken bilgileri içerir. Dize; küme ana makine adı, kimlik doğrulama veritabanı ve bağlantı seçeneklerini içerir.
Bir bağlantı dizesini kullanmadan önce IP erişim listenizi yapılandırdığınızdan ve en az bir veritabanı kullanıcısı oluşturduğunuzdan emin olun.
Bir kümenin bağlantı dizisini alın
Bir kümenin bağlantı dizesini almak için şunu çalıştırın:
Bu komut, kümeniz için SRV bağlantı dizesini döndürür.
Bağlantı dizesi biçimleri
MongoDB Atlas iki tür bağlantı dizesi sağlar:
Standart bağlantı dizesi (
mongodb://): Tüm küme düğümlerini açıkça listeler. Tek tek sunucu adreslerini belirtmeniz gerektiğinde bu biçimi kullanın.SRV bağlantı dizesi (
mongodb+srv://): Küme bilgilerini otomatik olarak almak için DNS kullanır. Küme yapılandırmanız değişirse otomatik olarak güncellendiği için önerilen biçim budur.Bağlantı dizesini kullanın
Bağlantı dizesindeki
<username>ve<password>alanlarını veritabanı kullanıcı kimlik bilgilerinizle değiştirin:Örneğin, kullanıcı adınız
appUserve parolanızsecurePass123ise:Bu bağlantı dizesini MongoDB Sürücüleri, MongoDB Shell veya diğer MongoDB araçlarıyla kümenize bağlanmak için kullanabilirsiniz.
Yedeklemeleri Yönetin
Yedeklemeler, verilerinizi kaybetmeniz veya bozulması durumunda kümenizi geri yüklemek için kullanabileceğiniz veritabanı verilerinizin kopyalarıdır. Atlas, düzenli bir program dahilinde otomatik olarak yedeklemeler oluşturur.
Yedeklemeleri yönetmek için Atlas’ta Organization Owner veya Project Owner erişimine sahip olmanız gerekir.
İsteğe bağlı yedeklemeler oluşturun
Anında bir yedekleme oluşturmak için şunu çalıştırın:
Yukarıdaki komutta
--desc, anlık görüntüyü açıklayan zorunlu bir bayraktır.Mevcut yedeklemeleri listeleyin
Bir kümenin tüm yedeklemelerini listelemek için şunu çalıştırın:
Yedekleme yapılandırmalarını tanımlayın
Bir küme için yedekleme ayarlarını görüntülemek üzere şunu çalıştırın:
Yedeklemelerden geri yükleyin
Bir yedekten veri geri yüklemek için şunu çalıştırın:
--snapshotIdbayrağı, hangi yedeğin geri yükleneceğini belirtir.--targetClusterNamebayrağı ise verilerin geri yükleneceği kümenin adını belirtir—örneğin:Yedeklemeleri silin
Bir yedeği silmek için şunu çalıştırın:
Sonuç
Bu yazıda, CLI komutlarının yapısını, dağıtım oluşturmayı, proje ve kümeleri yönetmeyi, kullanıcı ve rol yapılandırmayı ve yedeklemeleri yönetmeyi ele aldım. Bu işlemleri betiklerde birleştirerek otomatikleştirebilir, birden fazla ortamı yönetmeyi kolaylaştırabilir ve veritabanı yönetimini geliştirme iş akışınıza entegre edebilirsiniz.