ceph fs #1

Supports: xenial bionic cosmic
Add to new model

Description

Ceph is a distributed storage and network file system designed to provide excellent performance, reliability, and scalability.


CephFS Charm

Overview

Ceph is a distributed storage and network file system designed to provide excellent performance, reliability, and scalability.

This charm deploys a Ceph MDS cluster.

Usage

Boot things up by using:

juju deploy -n 3 ceph-mon
juju deploy -n 3 ceph-osd

You can then deploy this charm by simply doing:

juju deploy ceph-fs
juju add-relation ceph-fs ceph-mon

Once the ceph-mon and osd charms have bootstrapped the cluster, the ceph-mon charm will notify the ceph-fs charm.

Contact Information

Ceph


Configuration

ceph-public-network
(string) The IP address and netmask of the public (front-side) network (e.g., 192.168.0.0/24). If multiple networks are to be used, a space-delimited list of a.b.c.d/x can be provided.
compression-algorithm
(string) Compression algorithm
snappy
compression-mode
(string) Compression mode to use for the pool
compression-required-ratio
(float) The required ration for compression to be used
0.5
erasure-failure-domain
(string) The erasure failure domain. This only applies if the pool-type is set to erasure and the erasure-profile is not 'default'
osd
erasure-k
(int) The number of erasure data chunks. This only applies if the pool-type is set to erasure and the erasure-profile is not 'default'
3
erasure-l
(int) The locality setting for erasure encoding. This only applies if the pool-type is set to erasure, the erasure-profile is not 'default', and the erasure-plugin supports a locality setting.
3
erasure-m
(int) The number of encoding chunks. This only applies if the pool-type is set to erasure and the erasure-profile is not 'default'
2
erasure-plugin
(string) The erasure plugin to use. This only applies if the pool-type is set to erasure and the erasure-profile is not 'default'
jerasure
erasure-profile
(string) The name of the erasure profile to use, this only applies if the pool-type is set to erasure. Settingn this to a custom value enables setting several of the erasure configuration parameters.
default
extra_packages
(string) Space separated list of extra deb packages to install.
fs-name
(string) The name to use when creating the pool for the filesystem
install_keys
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
install_sources
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
key
(string) Key ID to import to the apt keyring to support use with arbitary source configuration from outside of Launchpad archives or PPA's.
loglevel
(int) Mon and OSD debug level. Max is 20.
1
package_status
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
install
pool-type
(string) Type of pool to use, replicated or erasure
replicated
pool-weight
(int) The percentage (0-100) of the cluster data on this pool is expected to consume. This is used to scale the number of pgs in the pool. For example, a single pool as the only use of a ceph cluster would be set to 100. If two filesystems share a Ceph cluster with equal expected data, set to 50.
10
prefer-ipv6
(boolean) If True enables IPv6 support. The charm will expect network interfaces to be configured with an IPv6 address. If set to False (default) IPv4 is expected. NOTE: these charms do not currently support IPv6 privacy extension. In order for this charm to function correctly, the privacy extension must be disabled and a non-temporary address must be configured/available on your network interface.
source
(string) Optional configuration to support use of additional sources such as: - ppa:myteam/ppa - cloud:trusty-proposed/kilo - http://my.archive.com/ubuntu main The last option should be used in conjunction with the key configuration option. Note that a minimum ceph version of 0.48.2 is required for use with this charm which is NOT provided by the packages in the main Ubuntu archive for precise but is provided in the Ubuntu cloud archive.
use-syslog
(boolean) If set to True, supporting services will log to syslog.