Canonical Observability Stack Lite
- Canonical Observability | bundle
Channel | Revision | Published |
---|---|---|
latest/stable | 11 | 21 Oct 2022 |
latest/candidate | 10 | 21 Oct 2022 |
latest/beta | 9 | 21 Oct 2022 |
latest/edge | 18 | 20 Jun 2023 |
1.0/stable | 16 | 21 Oct 2022 |
1.0/candidate | 14 | 21 Oct 2022 |
1.0/beta | 13 | 21 Oct 2022 |
1.0/edge | 12 | 21 Oct 2022 |
juju deploy cos-lite --channel edge
Deploy Kubernetes operators easily with Juju, the Universal Operator Lifecycle Manager. Need a Kubernetes cluster? Install MicroK8s to create a full CNCF-certified Kubernetes system in under 60 seconds.
Platform:
Table of Contents
Minio is a lightweight S3-compatible object storage system. In its single-node configuration, it is suitable for providing s3 storage backends for testing purposes for certain HA COS addons such as Tempo, Loki and Mimir.
In production, you will probably want to deploy ceph and then follow this guide instead how to use ceph for s3 storage.
The minio
charm does not directly provide an s3
endpoint. For that, we need to deploy an s3-integrator
app to act as intermediary.
Single-node Minio deployment
Deploy `minio`
Deploy the minio
charm (feel free to use stronger access and secret keys depending on how exposed your environment is)
juju deploy minio --channel edge --trust --config access-key=accesskey --config secret-key=mysoverysecretkey
Note that the secret-key must be at least 8 characters long. If not, Minio will crash.
And wait for it to go to active/idle
.
Deploy `s3-integrator`
juju deploy s3-integrator --channel edge --trust s3
We deploy s3-integrator
as s3
, but feel free to give the app a different name.
And wait for it to go to blocked/idle
.
The s3
app will go into blocked
status until you run the sync-s3-credentials
action to give it access to minio
.
juju run s3/leader sync-s3-credentials access-key=accesskey secret-key=mysoverysecretkey
,
Add a bucket
Using the Minio UI
The simplest way to create a bucket is to use the Minio console.
Obtain the Minio IP from the juju status
output and then open http://MINIO_IP:9001
in a browser using the access key and secret key you configured earlier as user and password respectively.
From there you should be able to create a bucket with a few clicks. See this guide for a step-by-step tutorial.
Using the Python sdk
Alternatively, you can use the python sdk.
pip install minio
Then execute:
from minio import Minio
address = <minio/0 unit IP>
bucket_name = "mybucket" # replace with your bucket name
mc_client = Minio(
f"{address}:9000",
access_key="accesskey",
secret_key="secretkey",
secure=False,
)
found = mc_client.bucket_exists(bucket_name)
if not found:
mc_client.make_bucket(bucket_name)
Integrate s3
Now grant the s3 integrator access to the bucket by doing:
juju config s3 endpoint=minio-0.minio-endpoints.<JUJU MODEL NAME>.svc.cluster.local:9000 bucket=mybucket
Replace with the name of the juju model minio
is deployed in, and mybucket
with the name of the bucket you just created.
Now the s3 integrator is ready to provide the s3
integration to any charm requiring it.
Note that, as of rev 41
for s3-integrator
, if multiple charms each require integration with different S3 buckets, you would need to deploy multiple s3-integrator
applications—one per unique bucket, as each s3-integrator
application can only have one set of unique bucket configurations. see more
A handy script to do it all
We have written a simple python script that does all of the above, for internal development purposes. And, as it happens, you can use it too!
juju switch cos # select the model where you have COS-lite deployed
sudo pip3 install minio # install the script's only dependency
curl https://raw.githubusercontent.com/canonical/tempo-coordinator-k8s-operator/main/scripts/deploy_minio.py | python3
The script will install minio charm, s3-integrator charm and configure them to create and use tempo
bucket where traces will be stored. Once the script finishes, you should see the following message:
Waiting for task 2...
ok: Credentials successfully updated.
all done! have fun.
Your storage is now ready, and you can integrate the s3
app to whatever needs a bucket.