Connect Amazon EC2 automatically

1. On the Amazon EC2 console, choose Launch instance.

   

2. Enter a name or identifier in the Name field located in the Name and tags section.

3. In the Amazon Machine Image (AMI) drop-down list, locate Amazon Linux 2 AMI and choose it.

   

4. Locate and choose t3.micro in the Instance type drop-down list.

   

5. In the Key pair (login) section, enter the identifier of an existing key-pair, or choose Create new key pair.

   

   You must provide an Amazon EC2 key pair.

   If you do have an Amazon EC2 key pair:

   1. Select a key pair, choose your key pair from the list.

   2. You must already have the private key file (.pem or .ppk file) available to log in to your Amazon EC2 instance.

   If you do not have an Amazon EC2 key pair:

   1. Choose Create new key pair, the Create key pair dialog box appears.

   2. Enter a name in the Key pair name field.

   3. Choose the Key pair type and Private key file format.

   4. Choose Create key pair.

   

   Note

   For security purposes, we highly recommand using a key-pair for both SSH and internet connectivity to your EC2 instance.

6. Optional: In the Network seetings section, under Firewall (security groups), choose either Create security group or Select existing security group.

   

   If you chose to select an existing security group, select one from the Common security groups drop-down list.

   If you chose to create a new security group, check all the traffic allow rules that apply to your EC2 connectivity.

7. In the Summary section, review your EC2 configuration and choose Launch instance if correct.Edit security groups.

   

1. Navigate to the Amazon DocumentDB console and choose Clusters from the navigation pane.

   

2. Choose Create.

   

3. Leave the Cluster type setting at it's default of Instance Based Cluster.

   

4. For Number of instances, choose 1. This will minimize cost. Leave the other settings at their default.

   

5. For Connectivity, choose Connect to an EC2 compute resource. This is the EC2 instance you created in Step 1.

   

   Note

   Connecting to an EC2 compute resource automatically creates a security group for your EC2 compute resource connection to your Amazon DocumentDB cluster. When you have completed creating your cluster and you want to see the newly created security group, navigate to the cluster list and choose your cluster's identifier. In the Connectivity & security tab, go to Security Groups and find your group under Security group name (ID). It will contain the the name of your cluster and look similar to this: docdb-ec2-docdb-2023-12-11-21-33-41:i-0e4bb09985d2bbc4c (sg-0238e0b0bf0f73877).

6. For Authentication, enter sign-in credentials. Important: You will need the sign-in credentials to authenticate your cluster in a later step.

   

7. Turn on Show advanced settings.

   

8. In the Network settings section, for Amazon VPC security groups, choose demoDocDB.

   

9. Choose Create cluster.

   

1. On the Amazon EC2 console, navigate to your instances and see if the instance you just created is running. If it is, select the instance by clicking the instance ID.

   

2. Choose Connect.

   

3. There are four tabbed options for your connection method: Amazon EC2 Instance Connect, Session Manager, SSH client, or EC2 serial console. You must choose one and follow its instructions. When complete, choose Connect.

   

1. On the Amazon DocumentDB console, under Clusters, locate your cluster. Choose the cluster you created by clicking the Cluster identifier.

   

2. In the Connectivity and security tab, locate Connect to this cluster with the mongo shell in the Connect box:

   

   Copy the connection string provided and paste it into your terminal.

   Make the following changes to it:

   1. Make sure you have the correct username in the string.

   2. Omit <insertYourPassword> so that you are prompted for the password by the mongo shell when you connect.

   Your connection string should look similar to the following:

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

3. Press enter in your terminal. You are now be prompted for your password. Enter your password.

4. When you enter your password and can see the rs0:PRIMARY> prompt, you are successfully connected to your Amazon DocumentDB cluster.

1. To insert a single document, enter the following:

   db.collection.insert({"hello":"DocumentDB"})

2. You get the following output:

   WriteResult({ "nInserted" : 1 })

3. You can read the document that you wrote with the findOne() command (because it only returns a single document). Input the following:

   db.collection.findOne()

4. You get the following output:

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

5. To perform a few more queries, consider a gaming profiles use case. First, insert a few entries into a collection titled profiles. Input the following:

   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. You get the following output:

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

7. Use the find() command to return all the documents in the profiles collection. Input the following:

   db.profiles.find()

8. You will get an output that will match the data you typed in Step 5.

9. Use a query for a single document using a filter. Input the following:

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

10. You should get back this output:

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

11. Now let’s try to find a profile and modify it using the findAndModify command. We’ll give the user Matt an extra ten points with the following code:

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

12. You get the following output (note that his score hasn’t increased yet):

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

13. You can verify that his score has changed with the following query:

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

14. You get the following output:

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

Access your Amazon DocumentDB cluster and set up the Amazon EC2 connection

1. Access your Amazon DocumentDB cluster.

   1. Sign in to the Amazon Web Services Management Console, and open the Amazon DocumentDB console at https://console.amazonaws.cn/docdb.

   2. In the navigation pane, choose Clusters.

      Tip

      If you don't see the navigation pane on the left side of your screen, choose the menu icon () in the upper-left corner of the page.

   3. Specify the cluster that you want by choosing the button to the left of the cluster's name.

2. Set up the Amazon EC2 connection.

   1. Choose Actions, and then choose Set up EC2 connection.

      

      The Set up EC2 connection dialog appears.

   2. In the EC2 instance field, choose the EC2 instance you want connected to your cluster.

      

   3. Choose Continue.

      The Review and confirm dialog appears.

   4. Make sure the changes are correct. Then choose Set up connection.

      

1. Sign in to the Amazon Web Services Management Console, and open the Amazon DocumentDB console at https://console.amazonaws.cn/docdb.

2. In the navigation pane, choose Databases, and then choose the name of the Amazon DocumentDB database.

3. On the Connectivity & security tab, view the compute resources in the Connected compute resources section.