Getting started with Yandex StoreDoc

To get started:

• Create a cluster.
• Connect to the database.

Getting startedGetting started

1. Navigate to the management console and log in to Yandex Cloud or sign up if not signed up yet.

2. If you do not have a folder yet, create one:

   1. In the management console, in the top panel, click or and select the cloud.

   2. To the right of the cloud name, click .

   3. Select Create folder.

      

   4. Give your folder a name. The naming requirements are as follows:

      • Length: between 3 and 63 characters.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

   5. Optionally, specify the description for your folder.

   6. Select Create a default network. This will create a network with subnets in each availability zone. Within this network, you will also have a default security group, within which all network traffic will be allowed.

   7. Click Create.

      

3. Assign the following roles to your Yandex Cloud account:

   • managed-mongodb.editor or higher: To create a cluster.

   • vpc.user: To use the cluster network.

   • mdb.viewer: To view managed database (MDB) clusters on the dashboard in the management console.

   Note

   If you cannot manage roles, contact your cloud or organization administrator.

4. You can connect to database clusters both from within and outside Yandex Cloud:

   • To connect from within Yandex Cloud, create a Linux-based VM in the same cloud network as your database cluster.

   • To connect to your cluster from the internet, request public access to its hosts when creating it.

   Note

   The next step requires connecting to the cluster from a Linux-based VM.

5. Connect to your VM over SSH.

6. Install MongoDB Shell:

   cd ~/ && \
   wget https://repo.mongodb.org/apt/ubuntu/dists/focal/mongodb-org/4.4/multiverse/binary-amd64/mongodb-org-shell_4.4.1_amd64.deb && \
   sudo dpkg -i mongodb-org-shell_4.4.1_amd64.deb
   

Create a clusterCreate a cluster

1. In the management console, select the folder where you want to create your database cluster.
2. Navigate to Yandex StoreDoc.
3. Click Create cluster.
4. Specify the cluster settings and click Create cluster. For more information, see Creating a cluster.
5. Wait until the cluster is ready: its status on the Yandex StoreDoc dashboard will change to Running, and its state to Alive. This may take a while.

Connect to the databaseConnect to the database

1. If using security groups for the cloud network, configure them to allow all required traffic between the cluster and your connection host.

2. Obtain an SSL certificate:

   Linux (Bash)/macOS (Zsh)

   Windows (PowerShell)

   mkdir -p ~/.mongodb && \
   wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
        --output-document ~/.mongodb/root.crt && \
   chmod 0644 ~/.mongodb/root.crt
   

   The certificate will be saved to the ~/.mongodb/root.crt file.

   mkdir $HOME\.mongodb; curl.exe -o $HOME\.mongodb\root.crt https://storage.yandexcloud.net/cloud-certs/CA.pem
   

   The certificate will be saved to the $HOME\.mongodb\root.crt file.

   Your corporate security policies and antivirus software may block the certificate download. For more information, see FAQ.

3. Connect to the cluster using the MongoDB CLI:

   mongo --norc \
         --ssl \
         --sslCAFile ~/.mongodb/root.crt \
         --host '<Yandex_StoreDoc_host_1_FQDN>:27018,...,<Yandex_StoreDoc_host_N_FQDN>:27018' \
         --username <DB_username> \
         --password <DB_user_password> \
         <DB_name>
   

   For how to get a host FQDN, see this guide.

What's nextWhat's next

• Read about the service concepts.
• Learn more about creating a cluster and connecting to a database.
• View the "Yandex StoreDoc guide" webinar on YouTube or Cloud Video.
• Check out the questions and answers.