Skip to main content
Version: Early Access

MongoDB Cloud Plugin

The MongoDB Cloud Plugin for Digital.ai Release enables seamless integration and task automation for MongoDB databases hosted on the cloud. This plugin uses containerized environments to run MongoDB shell scripts for common tasks like inserting and retrieving data, using the Digital.ai Release Runner. It works with both local and cloud MongoDB databases and can be set up for various MongoDB configurations.

To run MongoDB scripts, the MongoDB Cloud Plugin includes a Node.js MongoDB shell client within a container. This Node.js dependency is essential for executing MongoDB shell scripts. For more information about MongoDB shell scripting, see MongoDB Shell Scripting Guide.

The MongoDB Cloud Plugin for Digital.ai Release makes it easy to connect to and automate tasks for MongoDB databases in the cloud.

Features​

  • Insert Data Task: Inserts specified data into a MongoDB collection.
  • Get Data Task: Retrieves data from a MongoDB collection and displays the output.
  • Insert and Get Data Task: Combines data insertion and retrieval, allowing a single task to both add new data and return existing data.

Requirements​

For MongoDB cloud integration within Digital.ai Release, you need the following:

  • A MongoDB cloud server running and accessible via HTTP(s).
  • Digital.ai Release Runner setup to run the container tasks.
  • A MongoDB database instance created and configured for access.

Set up a MongoDB: Server (Container) - Cloud Server​

You can define a MongoDB: Server (Container) - Cloud server configuration in two locations:

  • On a global level in Connections under the CONFIGURATION group in the navigation pane.
  • On a folder level in Overview > Folders of the navigation pane, under the CONFIGURATION tab of the desired folder.

To set up a connection to a MongoDB cloud server:

  1. In Release, go to one of the specified locations.
  2. Under HTTP server connections, next to MongoDB: Server (Container), click add button. The MongoDB: Server (Container) - Cloud page opens.
  3. In the Title field, enter the name of the configuration. This name will display in MongoDB Cloud tasks.
  4. In the URL field, enter the URL to access the server.
  5. In Username, enter the MongoDB cloud username.
  6. In Password, enter the MongoDB cloud password.
  7. To test the connection, click Test.
  8. To save the configuration, click Save.

Connecting to MongoDB in Various Environments in Digital.ai Release​

  • Protocol Requirements: When configuring a MongoDB connection in Digital.ai Release, make sure the connection URL includes the correct protocol (mongodb:// for local instances or mongodb+srv:// for cloud instances) to avoid connection errors.
  • Connection String Flexibility: Digital.ai Release allows you to directly paste the MongoDB connection URL, obtained from the cloud instance. This simplifies setup and ensures accurate connections across different MongoDB environments.

MongoDB Server Connection

Insert Data Task (Container)​

In Digital.ai Release, you can configure an Insert Data task for MongoDB to insert data into a MongoDB collection:

  1. In the release flow tab of a Release template, add a task of type MongoDB > Insert Data (Container).

  2. Click the added task to open it.

  3. In the Capabilities field, enter a value that matches the capability set for your Runner. This helps you to route jobs to that particular Runner.

  4. In the Server field, select the configured MongoDB server to run the script on.

  5. In the Script field, enter the MongoDB script.

    Insert Data

Note: The Insert Data task does not return an output by default, as it only performs data insertion.

Get Data Task (Container)​

In Digital.ai Release, you can configure a Get Data task for MongoDB to retrieve data from a MongoDB collection:

  1. In the release flow tab of a Release template, add a task of type MongoDB > Get Data (Container).

  2. Click the added task to open it.

  3. In the Capabilities field, enter a value that matches the capability set for your Runner. This helps you to route jobs to that particular Runner.

  4. In the Server field, select the configured MongoDB server to run the script on.

  5. In the Script field, enter the MongoDB script.

    Get Data

Note: The Get Data task fetches data from the database and displays it in the task output, allowing you to view query results directly.

Insert and Get Data Task (Container)​

In Digital.ai Release, you can configure an Insert and Get Data task for MongoDB to combine data insertion and retrieval:

  1. In the release flow tab of a Release template, add a task of type MongoDB > Insert and Get Data (Container).

  2. Click the added task to open it.

  3. In the Capabilities field, enter a value that matches the capability set for your Runner. This helps you to route jobs to that particular Runner.

  4. In the Server field, select the configured MongoDB server to run the script on.

  5. In the Script field, enter the MongoDB script.

    Insert and Get Data

Note: This task allows both data insertion and retrieval, providing output that reflects both the newly inserted data and any query results from the script.