This is a plugin for Tutor that provides S3-like object storage for Open edX platforms. It’s S3, but without the dependency on AWS. This is achieved thanks to MinIO, an open source project that provides object storage with an API compatible with S3.
In particular, this plugin is essential for Kubernetes deployment.
Installation
The plugin is currently bundled with the binary releases of Tutor. If you have installed Tutor from source, you will have to install this plugin from source, too:
tutor plugins install minio
Then, to enable this plugin, run:
tutor plugins enable minio
Configuration
OPENEDX_AWS_ACCESS_KEY (default: "openedx")
OPENEDX_AWS_SECRET_ACCESS_KEY (default: "{{ 24|random_string }}")
MINIO_BUCKET_NAME (default: "openedx")
MINIO_FILE_UPLOAD_BUCKET_NAME (default: "openedxuploads")
MINIO_HOST (default: "files.{{ LMS_HOST }}")
MINIO_CONSOLE_HOST (default: "minio.{{ LMS_HOST }}")
MINIO_DOCKER_IMAGE (default: "docker.io/minio/minio:RELEASE.2022-05-08T23-50-31Z")
MINIO_MC_DOCKER_IMAGE (default: "docker.io/minio/mc:RELEASE.2022-05-09T04-08-26Z")
MINIO_GRADES_BUCKET_NAME (default: "openedxgrades")
These values can be modified with tutor config save --set PARAM_NAME=VALUE commands.
MINIO_GATEWAY (default: null)
This feature allows your to run the MinIO server as a gateway to another object storage solution, such as S3 or Azure. That way, static assets can be stored on these object storage backends without extensive changes to the Open edX runtime environment.
Note to Azure users: you will have to manually grant public access rights to the MINIO_BUCKET_NAME (“openedx”) bucket.
DNS records
It is assumed that the MINIO_HOST DNS record points to your server. When running MinIO on your laptop, the MinIO Web UI will be available at http://minio.local.openedx.io. In development mode, the MinIO interface will be available at http://minio.local.openedx.io:9001.
Web UI
The MinIO web UI can be accessed at http://<MINIO_HOST>. The credentials for accessing the UI can be obtained with:
tutor config printvalue OPENEDX_AWS_ACCESS_KEY tutor config printvalue OPENEDX_AWS_SECRET_ACCESS_KEY
Troubleshooting
This Tutor plugin is maintained by Abdul Rehman from Edly. Community support is available from the official Open edX forum. Do you need help with this plugin? See the troubleshooting section from the Tutor documentation.
License
This work is licensed under the terms of the GNU Affero General Public License (AGPL).
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file tutor_minio-22.0.0.tar.gz.
File metadata
- Download URL: tutor_minio-22.0.0.tar.gz
- Upload date:
- Size: 18.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
954293703ab089fa32030537210b3afa43567d9a2fa204c14388c577eab3cb47
|
|
| MD5 |
25906f10f26474b97a265f20c29f19a8
|
|
| BLAKE2b-256 |
38b4983f5c8453efa191d3ba1059a0a2c381304f2ebce19dd773687be9995b0a
|
