Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting our team. We will be in touch shortly.Close

All commands are written for juju v.3.1.7 +

How to configure S3 storage

This guide will teach you how to deploy and configure the S3 Integrator charm for AWS S3, send the configurations to the Charmed OpenSearch application, and update it. The same procedure can be extended to use Ceph RadosGW.


Configure S3 for AWS

First, deploy and run the s3-integrator charm:

juju deploy s3-integrator
juju run s3-integrator/leader sync-s3-credentials \
    access-key=<access-key-here> secret-key=<secret-key-here>

See all other configuration parameters in the Configuration section of the s3-integrator documentation.

The Amazon S3 endpoint must be specified as s3.<region>.amazonaws.com within the first 24 hours of creating the bucket. For older buckets, the endpoint s3.amazonaws.com can be used. See this AWS forum post for more information.

Configure S3 for Ceph RadosGW

First, deploy and run the s3-integrator charm:

juju deploy s3-integrator

juju run s3-integrator/leader \
    sync-s3-credentials \
    access-key=<access-key-here> \
    secret-key=<secret-key-here>

Ceph can be configured with a custom region name, or set as default if none was chosen. See the Ceph docs for More information about RadosGW configuration.

Then, use juju config to add your configuration parameters. For example:

juju config s3-integrator \
    endpoint="https://<CEPH_RADOSGW_URL>" \
    bucket="<bucket_name>" \
    path="<path_to_instance>" \
    region="<region>"

Integrate with Charmed OpenSearch

To pass these configurations to Charmed OpenSearch, integrate the two applications:

juju integrate s3-integrator opensearch

Last updated 3 days ago. Help improve this document in the forum.