You are viewing documentation for KubeSphere version:v3.0.0

KubeSphere v3.0.0 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Deploy MongoDB on KubeSphere

MongoDB is a general purpose, document-based, distributed database built for modern application developers and for the cloud era.

This tutorial walks you through an example of deploying MongoDB from the App Store of KubeSphere.

Prerequisites

  • Please make sure you enable the OpenPitrix system.
  • You need to create a workspace, a project, and a user account (project-regular) for this tutorial. The account needs to be a platform regular user and to be invited as the project operator with the operator role. In this tutorial, you log in as project-regular and work in the project demo-project in the workspace demo-workspace. For more information, see Create Workspaces, Projects, Accounts and Roles.

Hands-on Lab

Step 1: Deploy MongoDB from the App Store

  1. On the Overview page of the project demo-project, click App Store in the top left corner.

    app-store

  2. Find MongoDB and click Deploy on the App Info page.

    mongodb-in-app-store

    deploy-mongodb

  3. Set a name and select an app version. Make sure MongoDB is deployed in demo-project and click Next.

    confirm-deployment

  4. In App Config, specify persistent volumes for the app and record the username and the password which will be used to access the app. When you finish, click Deploy.

    set-app-configuration

    Note

    To specify more values for MongoDB, use the toggle switch to see the app’s manifest in YAML format and edit its configurations.
  5. Wait until MongoDB is up and running.

    mongodb-running

Step 2: Access the MongoDB Terminal

  1. Go to Services and click the service name of MongoDB.

    mongodb-service

  2. Under Pods, expand the menu to see container details, and then click the Terminal icon.

    mongodb-terminal

  3. In the pop-up window, enter commands in the terminal directly to use the app.

    mongodb-service-terminal

    Note

    If you want to access MongoDB outside the cluster, click More and select Edit Internet Access. In the dialog that appears, select NodePort as the access mode. Use the port number to access MongoDB after it is exposed. You may need to open the port in your security groups and configure related port forwarding rules depending on your where your Kubernetes cluster is deployed.
  4. For more information, see the official documentation of MongoDB.