Connecting to NoSQL

Last updated: 2020-07-10 11:26:07

    Operation Scenarios

    You can use the Serverless Framework component to create, deploy, and manage a Serverless DB instance easily and connect to and access the database through the SCF SDK. Based on the serverless services in the cloud, you can conveniently develop and rapidly deploy your business with "zero" configuration so as to implement it more easily.

    Currently, Serverless Framework supports connecting to and deploying two types of databases: PostgreSQL and NoSQL. This document describes how to use an SCF function to connect to a NoSQL database.

    Prerequisites

    You have installed Serverless Framework on at least the following versions; otherwise, please install it as instructed in Installing Serverless Framework.

    Framework Core: 1.67.3
    Plugin: 3.6.6
    SDK: 2.3.0
    Components: 2.30.1

    Notes

    • Please make sure that the executing role of SLS_QcsRole under your account has been granted the QcloudTCBFullAccess permission; otherwise, please go to the CAM Console to configure it.
    • Currently, TCB allows you to create/terminate an environment for up to 4 times per month. Please create an environment with caution, as an error will be reported if the limit is exceeded.

    Directions

    This document uses a function in the Node.js programming language as an example to describes how to use the Serverless Framework component to write and create a function and use it to create and access a NoSQL database. The configuration process is as follows:

    1. Configure identity information: configure the Tencent Cloud account information locally.
    2. Create a TCB environment configuration file: use the Serverless Framework component to create a TCB environment and create and use a NoSQL database in the environment.
    3. Write business code: use the Serverless DB SDK to call the database. SCF allows you to directly call the Serverless DB SDK to create and manage a NoSQL database.
    4. Deploy and debug: use Serverless Framework to deploy the project in the cloud and test it in the SCF Console.
    5. Remove project: you can use Serverless Framework to remove the project.

    Configuring identity information

    1. Create a local directory to store code and dependent modules. This document uses the test-NoSQL folder as an example.
    2. Serverless Framework allows you to configure identity information in the following two ways. Please choose one as needed:
      • Run the following command for authentication:
        serverless login
      • Create a .env file in test-NoSQL and configure the corresponding Tencent Cloud SecretId and SecretKey as follows:
        # .env
        TENCENT_SECRET_ID=xxx  // `SecretId` of your account
        TENCENT_SECRET_KEY=xxx // `SecretKey` of your account
        • If you don't have a Tencent Cloud account yet, please sign up first.
        • If you already have a Tencent Cloud account, please make sure that your account has been granted the AdministratorAccess permission. In addition, you can get SecretId and SecretKey in API Key Management.

    Creating TCB environment configuration file

    1. Create a DB folder in test-NoSQL.
    2. Create a serverless.yml file in the DB folder and enter the following content to use the Serverless Framework component to configure the TCB environment:
      # serverless.yml 
      component: mongodb
      name: mongoDBDemoMongo
      org: anycodes
      app: mongoDBAPP
      stage: dev
      inputs:
        name: Mydemo

    Writing business code

    1. Create a function folder in test-NoSQL to store the business logic code and relevant dependencies.
    2. Create an src folder in the function folder, enter it on the command line, and run the following command to install the TCB dependency package:
      npm install --save tcb-admin-node@latest
    3. Create an index.js file in the src folder and enter the following sample code, so that you can use the Serverless TCB SDK to call the TCB environment through the function and call the NoSQL database in the environment:
      const tcb = require('tcb-admin-node')
      const app = tcb.init({
       secretId: process.env.SecretId,
       secretKey: process.env.SecretKey,
       env: process.env.MongoId,
       serviceUrl: 'https://tcb-admin.tencentcloudapi.com/admin'
      })
      const db = app.database()
      const _ = db.command
      exports.main = async (event, context) => {
       await db.createCollection('serverless')
       const username = 'serverless'
       const collection = db.collection('serverless')
       if (username) {
               await collection.add({username: username})
                   }
           const userList = await collection.get()
           return userList
      }
    4. After writing the business code, create a serverless.yml file and enter your SecretId and SecretKey in the environment variables.

      If you use the following configuration, a TCB environment will be created free of charge. If you already have a free TCB environment, please enter its ID in MongoId; otherwise, an error will be reported.

      component: scf
      name: mongoDBDemoSCF
      org: anycodes
      app: mongoDBAPP
      stage: dev
      inputs:
        name: MongoDBDemo
        src: ./src
        runtime: Nodejs8.9
        region: ap-guangzhou
        handler: index.main
        environment:
          variables:
            SecretId: enter your `SecretId`
            SecretKey: enter your `SecretKey`
            MongoId: ${output:${stage}:${app}:mongoDBDemoMongo.EnvId}

    Deploying and debugging

    1. Run the following command for deployment in test-NoSQL on the command line:
      sls deploy --all
      If the following result is returned, the deployment is successful:
      serverless ⚡ framework
      mongoDBDemoMongo:
        Region:    ap-guangzhou
        Name:      Mydemo
        EnvID:     Mydemo-dyxfxv
        FreeQuota: basic
      mongoDBDemoSCF: 
        FunctionName: MongoDBDemo
        Description:  
          Namespace:    default
          Runtime:      Nodejs8.9
          Handler:      index.main
          MemorySize:   128
      25s › tcbdemo › Success
    2. After the deployment succeeds, you can view and debug the function in the SCF Console. For more information on the test steps, please see Cloud Test. The test success result is as shown below:

      You can also use Serverless Dashboard to monitor the deployed project in real time with ease.

    Removing project

    Run the following command in the test-NoSQL directory to remove the project:

    sls remove --all

    If the following result is returned, the removal is successful:

    serverless ⚡ framework
    4s › test-NoSQL › Success

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help