Juju Charm - Ceph Proxy
Go to file
Luciano Lo Giudice 0962f230a1 Sync charm libraries
Change-Id: Ic2916be468271eb3ff37b305429f3e4133e734c5
2023-09-13 14:05:13 -03:00
actions Remove duplicated action files 2020-09-07 09:17:05 +02:00
charmhelpers Sync charm libraries 2023-09-13 14:05:13 -03:00
files Sync libraries & common files prior to freeze 2020-09-28 13:51:24 +01:00
hooks Add support for CephFS. 2023-06-16 18:44:08 -04:00
lib/charms_ceph Sync charm libraries 2023-09-13 14:05:13 -03:00
templates support custom admin user and user auth 2018-09-26 10:09:14 +03:00
tests Add 2023.2 Bobcat support 2023-08-03 13:51:39 -04:00
unit_tests Add support for CephFS. 2023-06-16 18:44:08 -04:00
.coveragerc [dosaboy,r=james-page] Add broker functionality 2014-11-19 16:12:04 -06:00
.gitignore Update to classic charms to build using charmcraft in CI 2022-02-17 12:30:04 -05:00
.gitreview fix .gitreview repo reference 2022-10-19 11:48:57 -04: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 Add support for interim Ubuntu releases 2023-03-21 15:28:05 -04:00
LICENSE Update to classic charms to build using charmcraft in CI 2022-02-17 12:30:04 -05:00
Makefile Use charms.ceph for Ceph broker 2020-08-28 11:15:03 +01:00
README.md Add support for CephFS. 2023-06-16 18:44:08 -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
bindep.txt Add Kinetic and Zed support 2022-08-26 18:40:28 +00:00
build-requirements.txt Update to classic charms to build using charmcraft in CI 2022-02-17 12:30:04 -05:00
charm-helpers-hooks.yaml Updates to flip all libraries back to master 2021-05-03 16:03:06 +01:00
charmcraft.yaml Add 2023.2 Bobcat support 2023-08-03 13:51:39 -04:00
config.yaml Add 2023.2 Bobcat support 2023-08-03 13:51:39 -04: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 Merge "Add docs key and point at Discourse" 2023-09-04 10:20:51 +00:00
osci.yaml Add 2023.2 Bobcat support 2023-08-03 13:51:39 -04:00
rename.sh Update to classic charms to build using charmcraft in CI 2022-02-17 12:30:04 -05:00
requirements.txt Add Kinetic and Zed support 2022-08-26 18:40:28 +00: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 Add Kinetic and Zed support 2022-08-26 18:40:28 +00:00
tox.ini Unpin tox version 2023-06-16 09:33:44 -04: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.

The charm works with traditional Ceph charm clients (e.g. cinder, glance, nova-compute) but it also supports the ceph-radosgw and ceph-fs 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 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.