Juju Charm - Ceph Proxy
Go to file
Alex Kavanagh 60260cc66c Updates for stable branch creation
Set default branch for git review/gerrit.

Switch tests to stable.

Switch to using stable charm-helpers branch.

Switch to using stable charm.openstack branch.

Change-Id: I8aee823f98a9c4b3a56019b445410c645b2bb423
2020-08-13 11:29:00 +01:00
actions Convert the charm to Python3 2019-03-10 14:16:41 +00:00
charmhelpers Release sync for 20.08 2020-07-27 20:50:06 +01:00
files Sync charm/ceph helpers, tox, and requirements 2019-10-14 18:23:31 +01:00
hooks Add focal-ussuri and bionic-ussuri bundle 2020-05-17 16:01:14 +01:00
lib Update tox.ini files from release-tools gold copy 2016-09-09 19:21:57 +00:00
templates support custom admin user and user auth 2018-09-26 10:09:14 +03:00
tests Updates for stable branch creation 2020-08-13 11:29:00 +01:00
unit_tests Ensure that we define `unit` before use 2020-02-12 11:28:56 +01:00
.coveragerc [dosaboy,r=james-page] Add broker functionality 2014-11-19 16:12:04 -06:00
.gitignore Update requirements 2018-10-03 16:26:42 -05:00
.gitreview Updates for stable branch creation 2020-08-13 11:29:00 +01:00
.project Add support for Juju network spaces 2016-04-07 16:22:52 +01:00
.pydevproject Add support for Juju network spaces 2016-04-07 16:22:52 +01:00
.stestr.conf Replace ostestr with stestr in testing framework. 2019-03-07 17:10:33 -05:00
.zuul.yaml Switch to Ussuri jobs 2019-10-31 17:37:25 +08:00
Makefile Sync charm-helpers for py38, distro, and other updates 2020-03-05 13:30:57 +01:00
README.md Fix actions section of the README 2020-08-04 14:18:59 -04:00
TODO Turn on cephx support by default 2012-10-09 12:18:01 +01:00
actions.yaml Sync charm/ceph helpers, tox, and requirements 2019-10-14 18:23:31 +01:00
charm-helpers-hooks.yaml Updates for stable branch creation 2020-08-13 11:29:00 +01:00
config.yaml support custom admin user and user auth 2018-09-26 10:09:14 +03:00
copyright Updated README verbosity, added checks to harden ceph admin-daemon usage in ceph utils 2012-10-04 14:24:12 +01:00
hardening.yaml Add hardening support 2016-03-29 20:26:58 +01:00
icon.svg Update charm icon 2017-07-31 14:13:52 -05:00
metadata.yaml Updates for 20.08 cycle start for groovy and libs 2020-07-24 12:57:50 +00:00
requirements.txt Release sync for 20.08 2020-07-27 20:50:06 +01:00
revision [hopem] Added use-syslog cfg option to allow logging to syslog 2014-03-25 18:44:22 +00:00
setup.cfg [dosaboy,r=james-page] Add broker functionality 2014-11-19 16:12:04 -06:00
test-requirements.txt Sync charm/ceph helpers, tox, and requirements 2019-10-14 18:23:31 +01:00
tox.ini Sync helpers for 20.05 2020-05-18 14:39:18 +02:00

README.md

Overview

Ceph 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 application for an external Ceph cluster. It joins a non-charmed Ceph cluster to a Juju model.

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 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:

    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.

For general charm questions refer to the OpenStack Charm Guide.