Skip to content

About

REST Application to read and write Data to an MongoDB

Topics

Resources

Stars

5 stars

Watchers

2 watching

Forks

Latest commit

 

History

822 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MongoCamp

Docker Pulls Docker Image Size (latest by date) Docker Image Version (latest by date)Maven Central

Introduction

Universal REST Handling for MongoDB ....

Supported MongoDB versions: 6.0 and later (tested against 6.0, 7.0, 8.0 and 9.0). MongoDB 4.4 and 5.0 are not supported.

Contributing

Open in Gitpod

If you find this library helpfull, so you can see here how you can help:

  • Send a pull request with your features and bug fixes
  • Help users resolve their issues.

Development

Requirements to build and test the project:

  • GraalVM for JDK 25 (for example cs java --jvm graalvm-java25:25.0.2). A plain JDK can not compile the project: the library contains the GraalVM native image substitutions (com.oracle.svm) and native-image builds the CLI and the server binary.
  • sbt 2 (the version is pinned in project/build.properties) and Scala 3 (scalaVersion in build.sbt).
  • Docker, the tests start MongoDB with Testcontainers. The CI runs the tests against MongoDB 6.0, 7.0, 8.0 and 9.0.
  • Node.js LTS (24 at the moment, the documentation tooling needs at least 20.19 or 22.12) and pnpm (version pinned in package.json) for the documentation: pnpm install and pnpm docs:dev.
sbt clean test                                   # sbt 2 caches task results, use clean to run the tests again
sbt publishLocal                                 # publishes the _3 artifacts to ~/.ivy2/local
sbt mongocamp-cli/GraalVMNativeImage/packageBin  # native CLI, the output is below target/out/jvm/<scala version>/mongocamp-cli/

Good to know:

  • The native image metadata in META-INF/native-image (reflection and resource configuration) is partly maintained by hand. A dependency update can break the native server without any failing test, so after updates build the native image (mongocamp-cli prepare native) and start it once.
  • Plugins have to be built with Scala 3, see Plugin Development.

Issues

Feel free to report your issues to Github's issue tracker. Please use one of the templates for reporting issues. report your issue

Documentation

Documentation is still on progress.

ShowCase

ShowCase is a started is an running Instance of MongoCamp-Server with installed Sample-Plugin. All Data are reverted every 30 minutes.

Admin User

User: admin Password: admin

Default User

User: test Password: test

Licence

Apache 2 License.

Usage

You can use Docker Compose or directly use directly docker run command.

docker run --publish 8080:8080 -e CONNECTION_HOST=your.mongo.db.host -e CONNECTION_DATABASE=test -e CONNECTION_USERNAME=mongodbUser -e CONNECTION_PASSWORD=mongodbPwd mongocamp/mongocamp-server:latest

About

REST Application to read and write Data to an MongoDB

Topics

Resources

Stars

5 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages