tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Serverless Application Center
    Documentation
    Download PDF

    Connecting to NoSQL

    Last updated: 2024-12-02 11:16:20
    Download PDF

      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
      Note:
      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.
      Note:
      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:
      
      
      Note:
      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
      
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy