MongoDB is a NoSQL database that stores data in flexible, JSON-like documents. It is designed for scalability and developer agility. Unlike relational databases, it allows for dynamic schemas, making data integration easier and faster.
For guidance on utilizing Initialization parameter, consult the Use Cases section of the documentation.
Create a new server¶
To operate the app, you must define the Database path parameter. This is essential for importing the MongoDB database folder from a UCloud workspace. If the specified folder is empty, a fresh database will be set up.
For added security, users have the option to require authentication for the database. This can be achieved using the Admin user and Admin password (Admin password file) parameters. For further customization, you can provide additional MongoDB settings through a tailored Configuration file.
By default the database is connected to port
27017. A different port can be chosen using the corresponding optional parameter.
Schedule regular backups¶
The app provides an option to schedule backups on an hourly basis. Backup folders are timestamped and can be found at
To create a database dump in MongoDB, you can also use the
mongodump utility via the app terminal interface. This tool captures binary exports of the contents of a MongoDB instance.
$ mongodump --gizip --out /path/to/output/directory --db your_database_name
--db option is omitted, the utility will create a dump of all the databases on the server.
If the MongoDB server requires authentication, you can include the
--authenticationDatabase flags in the command line options.
The default authentication database in MongoDB server is named
Restore a database dump¶
To restore a database, choose an empty database folder. Then, import the desired backup using the Restore database parameter.
The user can also restore a database from command line using the
mongorestore utility. Here's a basic example:
$ mongorestore --gzip --db your_database_name /path/to/backup/directory/your_database_name
where the backup is generated by
Connect to the server¶
Users can directly access the MongoDB console from the app's terminal interface. e.g.:
$ mongosh -u <username> -p <password>
assuming the database server was started with login credentials. However, there's also the flexibility to connect to the MongoDB server utilizing an external client tool.
If the client tool is part of another interactive app available on UCloud, it's straightforward to establish a connection directly to the MongoDB server as detailed here. Under such circumstances, the server's hostname should be set as an external parameter via the Connect to other jobs optional setting.
Conversely, when the MongoDB client is a standalone third-party software, not residing on UCloud, it becomes essential to allocate a static IP address to the MongoDB server, facilitated by the Add public IP feature.
If the MongoDB server is started with a custom configuration file, make sure that it includes the following lines:
net: bindIp: 0.0.0.0 port: 27017
This configuration allows connections from all available IP interfaces. The
bindIp option set to
0.0.0.0 enables MongoDB to listen for connections from any IP address.
The static IP address must listen to the same port to establish a connection.