https://github.com/openstack/charm-ceph-proxy
Juju Charm - Ceph Proxy. Mirror of code maintained at opendev.org.
https://github.com/openstack/charm-ceph-proxy
Last synced: 4 months ago
JSON representation
Juju Charm - Ceph Proxy. Mirror of code maintained at opendev.org.
- Host: GitHub
- URL: https://github.com/openstack/charm-ceph-proxy
- Owner: openstack
- License: apache-2.0
- Created: 2016-07-05T19:07:43.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-11-19T09:33:47.000Z (over 1 year ago)
- Last Synced: 2025-05-06T11:35:19.973Z (about 1 year ago)
- Language: Python
- Homepage: https://opendev.org/openstack/charm-ceph-proxy
- Size: 1.33 MB
- Stars: 11
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Overview
[Ceph][ceph-upstream] is a unified, distributed storage system designed for
excellent performance, reliability, and scalability.
The ceph-proxy charm deploys a proxy that acts as a [ceph-mon][ceph-mon-charm]
application for an external Ceph cluster. It joins a non-charmed Ceph cluster
to a Juju model.
The charm works with traditional Ceph charm clients (e.g. cinder, glance,
nova-compute) but it also supports the [ceph-radosgw][ceph-radosgw-charm] and
[ceph-fs][ceph-fs-charm] charms.
# Usage
## Configuration
This section covers common and/or important configuration options. See file
`config.yaml` for the full list of options, along with their descriptions and
default values. See the [Juju documentation][juju-docs-config-apps] for details
on configuring applications.
#### `fsid`
The `fsid` option supplies the UUID of the external cluster.
#### `admin-key`
The `admin-key` option supplies the admin Cephx key of the external cluster.
#### `monitor-hosts`
The `monitor-hosts` option supplies the network addresses (and ports) of the
Monitors of the external cluster.
## Deployment
Let file ``ceph-proxy.yaml`` contain the deployment configuration:
```yaml
ceph-proxy:
fsid: a4f1fb08-c83d-11ea-8f4a-635b3b062931
admin-key: AQCJvBFfWX+GLhAAln5dFd1rZekcGLyMmy58bQ==
monitor-hosts: '10.246.114.21:6789 10.246.114.22:6789 10.246.114.7:6789'
```
To deploy:
juju deploy --config ceph-proxy.yaml ceph-proxy
Now add relations as you normally would between a ceph-mon application and
another application, except substitute ceph-proxy for ceph-mon. For instance,
to use the external Ceph cluster as the backend for an existing glance
application:
juju add-relation ceph-proxy:client glance:ceph
## Actions
Many of the ceph-mon charm's actions are supported. See file `actions.yaml` for
the full list of actions, along with their descriptions.
# Bugs
Please report bugs on [Launchpad][lp-bugs-charm-ceph-proxy].
For general charm questions refer to the [OpenStack Charm Guide][cg].
[ceph-upstream]: https://ceph.io
[cg]: https://docs.openstack.org/charm-guide
[ceph-mon-charm]: https://charmhub.io/ceph-mon
[ceph-fs-charm]: https://charmbui.io/ceph-fs
[ceph-radosgw-charm]: https://charmbui.io/ceph-radosgw
[juju-docs-actions]: https://charmbui.io/docs/actions
[juju-docs-config-apps]: https://juju.is/docs/configuring-applications
[lp-bugs-charm-ceph-proxy]: https://bugs.launchpad.net/charm-ceph-proxy/+filebug