O MongoDB CLI fornece uma interface de linha de comando para gerenciar seus projetos e clusters do MongoDB Cloud Manager .
Este tutorial demonstra como:
Criar clusters em seu projeto do Cloud Manager
Recuperar detalhes sobre o novo cluster
As páginas de referência para os comandos mencionados neste tutorial estão disponíveis em Comandos da MongoDB CLI .
Pré-requisitos
Antes de começar, conclua as seguintes tarefas:
Certifique-se de que seu ambiente seja compatível
Criar uma organização do Cloud Manager
Gerar chaves de API programáticas que tenham: - A role
project ownerou superior - A entrada da lista de acesso para seu endereço IP ou faixaCIDR
Criar um cluster
Use o comando mongocli cloud-manager clusters create para criar um cluster no Cloud Manager.
O comando a seguir cria um cluster de amostra com as seguintes configurações:
Nome do cluster:
getStartedVersão do servidor MongoDB:
5.0.0versão de compatibilidade do recurso:
5.0Membros do conjunto de réplicas:
3Nomes de host do membro:
host1,host2,host3Observação
Este tutorial utiliza os nomes de host
host1,host2ehost3. Substitua esses nomes de host por nomes de host de MongoDB Server válidos.linguagem de definição de dados (DDL) para cada instância
mongod:/data/cluster/rs1,/data/cluster/rs2,/data/cluster/rs3Caminho do arquivo de log para cada instância
mongod:/data/cluster/rs1/mongodb.log,/data/cluster/rs2/mongodb.log,/data/cluster/rs3/mongodb.logPorta para cada processo
mongod:29010,29020,29030Prioridade de votação para cada membro:
1Número de votos para cada membro:
1
Copie e cole as seguintes propriedades de configuração do cluster e getStartedCluster.json do conjunto de réplicas em um arquivo chamado.
Para saber mais sobre as propriedades do arquivo de configuração, consulte Arquivo de Configuração de Cluster.
{ "name": "getStarted", "version": "5.0.0", "featureCompatibilityVersion": "5.0", "processes": [ { "hostname": "host1", "dbPath": "/data/cluster/rs1", "logPath": "/data/cluster/rs1/mongodb.log", "priority": 1, "votes": 1, "port": 29010 }, { "hostname": "host2", "dbPath": "/data/cluster/rs2", "logPath": "/data/cluster/rs2/mongodb.log", "priority": 1, "votes": 1, "port": 29020 }, { "hostname": "host3", "dbPath": "/data/cluster/rs3", "logPath": "/data/cluster/rs3/mongodb.log", "priority": 1, "votes": 1, "port": 29030 } ] }
Recuperar o cluster
Você pode verificar se o cluster foi criado com êxito recuperando os detalhes do cluster usando o comando mongocli Cloud Manager clusters describe .
mongocli cloud-manager cluster describe getStarted
A saída do comando deve ser semelhante ao seguinte:
{ "mongoURI": "mongodb://host1:29010,host2:29020,host3:29030", "name": "getStarted", "processes": [ { "buildIndexes": true, "db_path": "/data/cluster/rs1", "featureCompatibilityVersion": "5.0", "hostname": "host1", "log_path": "/data/cluster/rs1/mongodb.log", "name": "getStartedCluster", "port": 29010, "priority": 1, "process_type": "mongod", "slave_delay": 0, "version": "5.0.0", "votes": 1, "arbiter_only": false, "disabled": false, "hidden": false }, { "buildIndexes": true, "db_path": "/data/cluster/rs2", "featureCompatibilityVersion": "5.0", "hostname": "host2", "log_path": "/data/cluster/rs2/mongodb.log", "name": "getStartedCluster", "port": 29020, "priority": 1, "process_type": "mongod", "slave_delay": 0, "version": "5.0.0", "votes": 1, "arbiter_only": false, "disabled": false, "hidden": false }, { "buildIndexes": true, "db_path": "/data/cluster/rs3", "featureCompatibilityVersion": "5.0", "hostname": "host3", "log_path": "/data/cluster/rs3/mongodb.log", "name": "getStartedCluster", "port": 29030, "priority": 1, "process_type": "mongod", "slave_delay": 0, "version": "5.0.0", "votes": 1, "arbiter_only": false, "disabled": false, "hidden": false } ] }
Observe o status da configuração da automação
Execute o comando mongocli cloud-manager automation watch para determinar se o cluster está pronto para uso. O comando a seguir usa o perfil padrão para acessar o projeto do Cloud Manager:
mongocli cm automation watch
Resumo
Parabéns! Você criou com sucesso um cluster para hospedar seus dados. Você pode se conectar ao cluster usando a string de conexão para mongosh ou seu aplicação, ou visualizar seu cluster fazendo login na UI.