Juju Charm - Swift storage
Go to file
James Page cae0a2c4f5 Add support for application version
Juju 2.0 provides support for display of the version of
an application deployed by a charm in juju status.

Insert the os_application_version_set function into the
existing assess_status function - this gets called after
all hook executions, and periodically after that, so any
changes in package versions due to normal system updates
will also be reflected in the status output.

This review also includes a resync of charm-helpers to
pickup hookenv and contrib.openstack support for this
feature.

Change-Id: I75009a66ce9c9d43e234f9c5acbb185ac4a66ba5
2016-09-20 13:32:28 +01:00
actions Re-license charm as Apache-2.0 2016-07-01 18:15:00 +01:00
charmhelpers Add support for application version 2016-09-20 13:32:28 +01:00
files [bradm] Adding nrpe checks, handle rsyncd config fragments 2014-10-30 00:52:15 -05:00
hooks Add support for application version 2016-09-20 13:32:28 +01:00
lib Add support for application version 2016-09-20 13:32:28 +01:00
templates fix minor nit in template 2015-11-27 09:28:53 +00:00
tests Add support for application version 2016-09-20 13:32:28 +01:00
unit_tests Add support for application version 2016-09-20 13:32:28 +01:00
.coveragerc Add actions.actions to coverage measuring and reporting. 2015-08-11 09:27:28 +01:00
.gitignore Resync charm-helpers 2016-03-03 11:50:13 +00:00
.gitreview Add gitreview prior to migration to openstack 2016-02-24 21:53:37 +00:00
.project Resynced helpers 2014-03-20 13:47:54 +00:00
.pydevproject Resynced helpers 2014-03-20 13:47:54 +00:00
.testr.conf Add tox support 2015-11-03 14:03:25 +00:00
LICENSE Re-license charm as Apache-2.0 2016-07-01 18:15:00 +01:00
Makefile Use bundletester for amulet test execution 2016-07-20 11:48:59 +01:00
README.md updating swift-storage charm for landscape 2013-01-15 11:40:49 -07:00
actions.yaml Action Managed Upgrades 2015-09-22 15:58:18 -07:00
charm-helpers-hooks.yaml Add support for application version 2016-09-20 13:32:28 +01:00
charm-helpers-tests.yaml Revert to pointing at regular charm-helpers 2015-08-17 13:17:15 +01:00
config.yaml Change worker-multiplier to float 2016-07-12 17:06:46 -07:00
copyright Re-license charm as Apache-2.0 2016-07-01 18:15:00 +01:00
hardening.yaml Add hardening support 2016-03-24 11:11:58 +00:00
icon.svg Update icon.svg 2013-10-23 13:14:57 -07:00
metadata.yaml Add charm series data to metadata.yaml 2016-09-14 09:40:37 +01:00
requirements.txt Fix pbr requirement 2016-04-13 10:25:06 +00:00
revision Remove debug. 2013-07-19 14:13:59 -07:00
setup.cfg Add actions.actions to coverage measuring and reporting. 2015-08-11 09:27:28 +01:00
test-requirements.txt Use bundletester for amulet test execution 2016-07-20 11:48:59 +01:00
tox.ini Update tox.ini files from release-tools gold copy 2016-09-09 19:42:33 +00:00

README.md

Overview

This charm provides the swift-storage component of the OpenStack Swift object storage system. It can be deployed as part of its own standalone storage cluster or it can be integrated with the other OpenStack components, assuming those are also managed by Juju. For Swift to function, you'll also need to deploy an additional swift-proxy using the cs:precise/swift-proxy charm.

For more information about Swift and its architecture, visit the official project website at http://swift.openstack.org.

This charm was developed to support deploying multiple version of Swift on Ubuntu Precise 12.04, as they relate to the release series of OpenStack. That is, OpenStack Essex corresponds to Swift 1.4.8 while OpenStack Folsom shipped 1.7.4. This charm can be used to deploy either (and future) versions of Swift onto an Ubuntu Precise 12.04, making use of the Ubuntu Cloud Archive when needed.

Usage

This charm is quite simple. Its basic function is to get a storage device setup for swift usage, and run the container, object and account services. The deployment workflow for swift using this charm is covered in the README for the swift-proxy charm at cs:precise/swift-proxy. The following are deployment options to take into consideration when deploying swift-storage.

Zone assignment

If the swift-proxy charm is configured for manual zone assignment (recommended), the 'zone' option should be set for each swift-storage service being deployed. See the swift-proxy README for more information about zone assignment.

Storage

Swift storage nodes require access to local storage and filesystem. The charm takes a 'block-device' config setting that can be used to specify which storage device(s) to use. Options include:

  • 1 or more local block devices (eg, sdb or /dev/sdb). It's important that this device be the same on all machine units assigned to this service. Multiple block devices should be listed as a space-separated list of device nodes.
  • a path to a local file on the filesystem with the size appended after a pipe, eg "/etc/swift/storagedev1.img|5G". This will be created if it does not exist and be mapped to a loopback device. Good for development and testing.
  • "guess" can be used to tell the charm to do its best to find a local devices to use. EXPERIMENTAL

Multiple devices can be specified. In all cases, the resulting block device(s) will each be formatted as XFS file system and mounted at /srv/node/$devname.

Installation repository

The 'openstack-origin' setting allows Swift to be installed from installation repositories and can be used to setup access to the Ubuntu Cloud Archive to support installing Swift versions more recent than what is shipped with Ubuntu 12.04 (1.4.8). For more information, see config.yaml.