Mongo Library Storage
Last updated
Was this helpful?
Last updated
Was this helpful?
There is an implementation of the ILibraryStorage
interface that stores the metadata and files of libraries in MongoDB. As the library files should never be above the limit of MongoDB's binary data fields (~5 MB), we we don't use GridFS. You can find the storage class in .
There is another very similar storage class , which uses S3 to store library files and might be a better fit if you have to storage very large library files (none of the normal content types do!) or if you need to reduce load on your MongoDB server.
The implementation depends on this NPM package:
mongodb
You must add it manually to your application using npm install mongodb
!
You must import the storage implementation:
or in classic JS style:
Initialize the storage implementation like this:
You can safely call createIndexes()
every time you start you application, as MongoDB checks if indexes already exist before it creates new ones.
You can pass credentials and other configuration values to initMongo
through the function parameters. Alternatively you can use these environment variables instead of using the function parameters:
MONGODB_URL
MONGODB_DB
MONGODB_USER
MONGODB_PASSWORD
You can change the MongoDB collection name h5p
to any name you want. If the collection doesn't exist yet, it will be automatically created.
To achieve greater configurability, you can decide not to use initMongo
and instantiate the required clients yourself.
LIBRARYSTORAGE=mongo
LIBRARY_MONGO_COLLECTION
An example call would be:
The method MongoLibraryStorage.migrate
can be called when you move to a new major version of MongoLibraryStorage:
Calling this method will migrate the MongoDB collection data. Note that there is no versioning of the MongoDB collection inside MongoDB. It's your job to decide when to call the migration!
v9 to v10: Introduces new field ubername that has the same value as _id
This will start a MongoDB server and MinIO instance in containers. Note that the instances will now be started when your system boots. To stop them from doing this and completely wipe all files from your system, execute:
The function creates a MongoDB client using the mongodb
npm package.
The can be configured to use the MongoDB library storage by setting the environment variables from above and these additional variables:
There are automated tests in . However, these tests will not be called automatically when you run npm run test
or other test calls. The reason is that the tests require a running MongoDB and S3 instance and thus need more extensive setup. To manually execute the tests call npm run test:h5p-mongos3
.
To quickly get a functioning MongoDB instance, you can use the like this (you obviously must install and first):