This is an experimental plugin for Tutor that allows Open edX to be configured with custom S3 settings, including the use of an S3 API-compatible storage platform — such as Ceph with radosgw.
This plugin is meant to make Tutor-managed Open edX interface with S3 hosted outside of Tutor. If instead you want to deploy your own S3-compatible storage platform as part of Tutor, please consider the minio Tutor plugin.
You must install a supported release of this plugin to match the Open edX and Tutor version you are deploying. If you are installing this plugin from a branch in this Git repository, you must select the appropriate one:
Open edX release | Tutor version | Plugin branch | Plugin release |
---|---|---|---|
Lilac | >=12.0, <13 |
Not supported | Not supported |
Maple | >=13.2, <14 1 |
maple |
0.3.x |
Nutmeg | >=14.0, <15 |
main |
1.x.x |
pip install git+https://github.com/hastexo/tutor-contrib-s3@v1.0.0
Then, to enable this plugin, run:
tutor plugins enable s3
OPENEDX_AWS_ACCESS_KEY
(default:""
)OPENEDX_AWS_SECRET_ACCESS_KEY
(default:""
)S3_HOST
(default:""
) - set only if using any other service than AWS S3S3_PORT
(default:""
) - set only if using any other service than AWS S3S3_REGION
(default:""
)S3_USE_SSL
(default:true
)S3_STORAGE_BUCKET
(default:"openedx"
)S3_FILE_UPLOAD_BUCKET
(default:"{{ S3_STORAGE_BUCKET }}"
)S3_PROFILE_IMAGE_BUCKET
(default:""
, meaning profile images are stored in the filesystem, rather than in S3)S3_GRADE_BUCKET
(default:"{{ S3_STORAGE_BUCKET }}"
)S3_ADDRESSING_STYLE
(default:"auto"
)S3_SIGNATURE_VERSION
(default:"s3v4"
)S3_CUSTOM_DOMAIN
(default:""
) - do not set if you are using AWS S3S3_PROFILE_IMAGE_CUSTOM_DOMAIN
(default:""
)
These values can be modified by the tutor config save --set PARAM_NAME=VALUE
command, or by setting them in $(tutor config printroot)/config.yaml
.
Depending on the nature and configuration of your S3-compatible service, some of these values may be required to set.
- If using AWS S3, you will need to set
S3_REGION
to a non-empty value. And make sureS3_ADDRESSING_STYLE
is set to"auto"
(default) andS3_CUSTOM_DOMAIN
is set to""
(default). - If you want to use an alternative S3-compatible service, you need to set the
S3_HOST
andS3_PORT
parameters. - For a Ceph Object Gateway that doesn’t set
rgw_dns_name,
you will need
S3_ADDRESSING_STYLE: path
. - Due to limitations in Open edX, if you are using
s3v4
signatures, yourS3_PROFILE_IMAGE_BUCKET
must have a public ACL and you must setS3_PROFILE_IMAGE_CUSTOM_DOMAIN
.
Follow this guide to configure buckets on AWS S3 to be used with Open edX.
Footnotes
-
For Open edX Maple and Tutor 13, you must run version 13.2.0 or later. That is because this plugin uses the Tutor v1 plugin API, which was introduced with that release. ↩