Skip to main content
Version: 4.8

MongoDB DB Stack

The MongoDB db stack is used to build and deploy MongoDB database in dataspaces and produce deployment-ready containers for the SCALE environment.

MongoDB is a cross-platform document-oriented database. Classified as a NoSQL database, MongoDB eschews the traditional table-based relational database structure in favor of JSON-like documents with dynamic schemas, making the integration of data in certain types of applications easier and faster.

The containers produced in this db stack share common requirements with other application and db stacks deployed to the SCALE environment. These shared requirements include:

  • Security scanning for any vulnerabilities
  • Staging of the db container in the appropriate Docker container repositories and tagged according to SCALE conventions
  • Completion of Unit Testing and User Acceptance Testing
  • Gated approvals before allowing deployments into pre-production and production environments
  • Audit trail and history of deployment within the SCALE CI/CD Pipeline

Because of the above-listed requirements, the MongoDB db stack is provided in order to support the build and deployment of MongoDB database in a manner that integrates with SCALE requirements and processes. The flow of deployment includes first a Continuous Integration stage of processing in a pipeline prior to deployment in the Continuous Deployment stages. The Continuous Integration stage focuses on building the application, running scans to security vulnerabilities, and staging the container in the appropriate Docker repository ready for deployment. Subsequent pipeline stages deploy the application to the appropriate target Kubernetes spaces.

For details on getting started, repository structure, CI/CD pipelines, and pipeline definition, see the Common Database Documentation.

Configuration and Customization of the MongoDB v4.3 Pipeline​

Global Variables​

For details on global variables, see Global Variables.

Database-Specific Pipeline Configuration​

The extends YAML object is a complex object consisting of additional YAML objects. This object is used to extend the V4 pipeline logic (referenced by the repository defined in the resources object) by (a) referencing the correct dbstack pipeline entry point (dbaas/devexp-mongodb.yml@spaces for the MongoDB pipeline) and (b) passing a set of YAML objects as parameters to influence the behavior of the pipeline to meet an application teams specific needs.

The extends YAML object consists of 2 objects beneath it:

  • template
  • parameters

The template YAML object is a single value set to the initial entry point for the V4 pipeline for the MongoDB dbstack, so it should always be defined as follows:

variables:
- { group: mongodb-<dataspace repo name>.props }
resources:
  repositories:
  - { repository: templates, type: git, name: devexp-engg/automation, ref: release/v4.7 }
  - { repository: spaces, type: git, name: spaces, ref: dbaas/v1.5 }
extends:
  template: dbaas/mongodb-<dataspace repo name>.yml@spaces

The parameters YAML object is defined immediately following the template object and at the same indentation level. This is the object that requires the most attention and definition to be set up.

Pipeline Modes​

For details on pipeline modes, see Pipeline Modes.

Backup Schedule​

For details on backup scheduling, see Backup Schedule.

Additional Configurations​

CPU Request Tuning​

For details on CPU request tuning, see CPU Request Tuning.

Database Configuration and Deployment​

Database will be automatically configured with random password during provision. To modify the details of MongoDB passwords, you need to update <repo-name>.props variable group in pipeline library.

chartname

chartname

chartname

For general deployment configuration details, see Database Configuration and Deployment.

Helm Override Files​

For details on helm override files, see Helm Override Files.

MongoDB example:

workspace:
  helm:
    overrideFiles: |
      dbaas-mongodb1/values.workspace.yaml
dataspace:
  helm:
    overrideValues: |

Changing Database User Password​

For details on changing database user password, see Changing Database User Password.

Click the below image to watch the video

change_password_logo

Exposing Databases Outside the Cluster​

See our documention on SCALE Stunnel Client

Sysdig Monitoring​

For details on Sysdig monitoring, see Sysdig Monitoring.

DR Changes​

For details on DR changes, see DR Changes.

Detailed Pipeline Configuration​

For details on pipeline configuration, see Detailed Pipeline Configuration.

Kubernetes Deployment Objects​

For details on Kubernetes deployment objects, see Kubernetes Deployment Objects.

Troubleshooting​

For troubleshooting information, see Troubleshooting.