63 lines
1.8 KiB
Plaintext
63 lines
1.8 KiB
Plaintext
Overview
|
|
========
|
|
|
|
Ceph is a distributed storage and network file system designed to provide
|
|
excellent performance, reliability, and scalability.
|
|
|
|
This charm deploys the RADOS Gateway, a S3 and Swift compatible HTTP gateway
|
|
for online object storage on-top of a ceph cluster.
|
|
|
|
This charm only supports the S3 gateway at this point in time.
|
|
|
|
Usage
|
|
=====
|
|
|
|
In order to use this charm, it assumed that you have already deployed a ceph
|
|
storage cluster using the 'ceph' charm with something like this::
|
|
|
|
juju deploy -n 3 --config ceph.yaml ceph
|
|
|
|
To deploy the RADOS gateway simple do::
|
|
|
|
juju deploy ceph-radosgw
|
|
juju add-relation ceph-radosgw ceph
|
|
|
|
You can then directly access the RADOS gateway by exposing the service::
|
|
|
|
juju expose ceph-radosgw
|
|
|
|
The gateway can be accessed over port 80 (as show in juju status exposed
|
|
ports).
|
|
|
|
Note that you will need to login to one of the service units supporting the
|
|
ceph charm to generate some access credentials::
|
|
|
|
juju ssh ceph/0 \
|
|
'sudo radosgw-admin user create --uid="ubuntu" --display-name="Ubuntu Ceph"'
|
|
|
|
For security reasons the ceph-radosgw charm is not setup with appropriate
|
|
permissions to administer the ceph cluster.
|
|
|
|
Scale-out
|
|
=========
|
|
|
|
Its possible to scale-out the RADOS Gateway itself::
|
|
|
|
juju add-unit -n 2 ceph-radosgw
|
|
|
|
and then stick a HA loadbalancer on the front::
|
|
|
|
juju deploy haproxy
|
|
juju add-relation haproxy ceph-radosgw
|
|
|
|
Should give you a bit more bang on the front end if you really need it.
|
|
|
|
Bootnotes
|
|
=========
|
|
|
|
The Ceph RADOS Gateway makes use of a multiverse package,
|
|
libapache2-mod-fastcgi. As such it will try to automatically enable the
|
|
multiverse pocket in /etc/apt/sources.list. Note that there is noting
|
|
'wrong' with multiverse components - they typically have less liberal
|
|
licensing policies or suchlike.
|