Add README, copyright. Drop example and deployer logs.
This commit is contained in:
parent
6223b50673
commit
9d443dd14f
|
@ -0,0 +1,123 @@
|
|||
Overview
|
||||
--------
|
||||
|
||||
This charm provides the Cinder volume service for OpenStack. It is intended to
|
||||
be used alongside the other OpenStack components, starting with the Folsom
|
||||
release.
|
||||
|
||||
Cinder is made up of 3 separate services: an API service, a scheduler and a
|
||||
volume service. This charm allows them to be deployed in different
|
||||
combination, depending on user preference and requirements.
|
||||
|
||||
This charm was developed to support deploying Folsom on both
|
||||
Ubuntu Quantal and Ubuntu Precise. Since Cinder is only available for
|
||||
Ubuntu 12.04 via the Ubuntu Cloud Archive, deploying this charm to a
|
||||
Precise machine will by default install Cinder and its dependencies from
|
||||
the Cloud Archive.
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
Cinder may be deployed in a number of ways. This charm focuses on 3 main
|
||||
configurations. All require the existence of the other core OpenStack
|
||||
services deployed via Juju charms, specifically: mysql, rabbitmq-server,
|
||||
keystone and nova-cloud-controller. The following assumes these services
|
||||
have already been deployed.
|
||||
|
||||
a. Basic, all-in-one using local storage and iSCSI.
|
||||
|
||||
The api server, scheduler and volume service are all deployed into the same
|
||||
unit. Local storage will be initialized as a LVM phsyical device, and a volume
|
||||
group initialized. Instance volumes will be created locally as logical volumes
|
||||
and exported to instances via iSCSI. This is ideal for small-scale deployments
|
||||
or testing:
|
||||
|
||||
$ cat >cinder.cfg <<END
|
||||
cinder:
|
||||
block-device: sdc
|
||||
overwrite: true
|
||||
END
|
||||
$ juju deploy --config=cinder.cfg cinder
|
||||
$ juju add-relation cinder keystone
|
||||
$ juju add-relation cinder mysql
|
||||
$ juju add-relation cinder rabbitmq-server
|
||||
$ juju add-relation cinder nova-cloud-controller
|
||||
|
||||
b. Separate volume units for scale out, using local storage and iSCSI.
|
||||
|
||||
Separating the volume service from the API service allows the storage pool
|
||||
to easily scale without the added complexity that accompanies load-balancing
|
||||
the API server. When we've exhausted local storage on volume serve, we can
|
||||
simply add-unit to expand our capacity. Future requests to allocate volumes
|
||||
will be distributed across the pool for volume servers according to the
|
||||
availability of storage space.
|
||||
|
||||
$ cat >cinder.cfg <<END
|
||||
cinder-api:
|
||||
enabled-services: api, scheduler
|
||||
cinder-volume:
|
||||
enabled-serfvices: volume
|
||||
block-device: sdc
|
||||
overwrite: true
|
||||
END
|
||||
$ juju deploy --config=cinder.cfg cinder cinder-api
|
||||
$ juju deploy --config=cinder.cfg cinder cinder-api
|
||||
$ juju add-relation cinder-api mysql
|
||||
$ juju add-relation cinder-api rabbitmq-server
|
||||
$ juju add-relation cinder-api keystone
|
||||
$ juju add-relation cinder-api nova-cloud-controller
|
||||
$ juju add-relation cinder-volume mysql
|
||||
$ juju add-relation cinder-volume rabbitmq-server
|
||||
|
||||
# When more storage is needed, simply add more volume servers.
|
||||
$ juju add-unit cinder-volume
|
||||
|
||||
c. All-in-one using Ceph-backed RBD volumes.
|
||||
|
||||
All 3 services can be deployed to the same unit, but instead of relying
|
||||
on local storage to back volumes an external Ceph cluster is used. This
|
||||
allows scalability and redundancy needs to be satisified and Cinder's RBD
|
||||
driver used to create, export and connect volumes to instances. This assumes
|
||||
a functioning Ceph cluster has already been deployed using the official Ceph
|
||||
charm and a relation exists between the Ceph service and nova-compute.
|
||||
service.
|
||||
|
||||
$ cat >cinder.cfg <<END
|
||||
cinder:
|
||||
block-device: None
|
||||
END
|
||||
$ juju deploy --config=cinder.cfg cinder
|
||||
$ juju add-relation cinder ceph
|
||||
$ juju add-relation cinder keystone
|
||||
$ juju add-relation cinder mysql
|
||||
$ juju add-relation cinder rabbitmq-server
|
||||
$ juju add-relation cinder nova-cloud-controller
|
||||
|
||||
|
||||
Configuration
|
||||
-------------
|
||||
|
||||
The default value for most config options should work for most deployments.
|
||||
|
||||
Users should be aware of three options, in particular:
|
||||
|
||||
openstack-origin: Allows Cinder to be installed from a specific apt repository.
|
||||
See config.yaml for a list of supported sources.
|
||||
|
||||
block-device: When using local storage, a block device should be specified to
|
||||
back a LVM volume group. It's important this device exists on
|
||||
all nodes that the service may be deployed to.
|
||||
|
||||
overwrite: Whether or not to wipe local storage that of data that may prevent
|
||||
it from being initialized as a LVM phsyical device. This includes
|
||||
filesystems and partition tables. *CAUTION*
|
||||
|
||||
enabled-services: Can be used to separate cinder services between service
|
||||
service units (see previous section)
|
||||
|
||||
Contact Information
|
||||
-------------------
|
||||
|
||||
Author: Adam Gandelman <adamg@canonical.com>
|
||||
Report bugs at: http://bugs.launchpad.net/charms
|
||||
Location: http://jujucharms.com
|
41
README.ex
41
README.ex
|
@ -1,41 +0,0 @@
|
|||
Describe the intended usage of this charm and anything unique about how
|
||||
this charm relates to others here.
|
||||
|
||||
This README will be displayed in the Charm Store, it should be either Markdown or RST. Ideal READMEs include instructions on how to use the charm, expected usage, and charm features that your audience might be interested in. For an example of a well written README check out Hadoop: http://jujucharms.com/charms/precise/hadoop
|
||||
|
||||
Here's an example you might wish to template off of:
|
||||
|
||||
Overview
|
||||
--------
|
||||
|
||||
This charm provides (service) from (service homepage). Add a description here of what the service itself actually does.
|
||||
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
Step by step instructions on using the charm:
|
||||
|
||||
juju deploy servicename
|
||||
|
||||
and so on. If you're providing a web service or something that the end user needs to go to, tell them here, especially if you're deploying a service that might listen to a non-default port.
|
||||
|
||||
You can then browse to http://ip-address to configure the service.
|
||||
|
||||
Configuration
|
||||
-------------
|
||||
|
||||
The configuration options will be listed on the charm store, however If you're making assumptions or opinionated decisions in the charm (like setting a default administrator password), you should detail that here so the user knows how to change it immediately, etc.
|
||||
|
||||
|
||||
Contact Information
|
||||
-------------------
|
||||
|
||||
Though this will be listed in the charm store itself don't assume a user will know that, so include that information here:
|
||||
|
||||
Author:
|
||||
Report bugs at: http://bugs.launchpad.net/charms
|
||||
Location: http://jujucharms.com
|
||||
|
||||
* Be sure to remove the templated parts before submitting to https://launchpad.net/charms for inclusion in the charm store.
|
||||
|
|
@ -1,5 +1,5 @@
|
|||
options:
|
||||
cinder-release:
|
||||
openstack-origin:
|
||||
default: distro
|
||||
type: string
|
||||
description: |
|
||||
|
@ -11,7 +11,7 @@ options:
|
|||
cloud:precise-folsom/updates, cloud:precise-folsom/staging,
|
||||
cloud:precise-folsom/proposed.
|
||||
|
||||
When deploying to Precise, the default distro option will use
|
||||
When deploying to Precise, the default distro option will use
|
||||
the cloud:precise-folsom/updates repository instead, since Cinder
|
||||
was not available in the Ubuntu archive for Precise and is only
|
||||
available via the Ubuntu Cloud Archive.
|
||||
|
@ -58,7 +58,3 @@ options:
|
|||
default: 8776
|
||||
type: int
|
||||
description: OpenStack Volume API listening port.
|
||||
config-flags:
|
||||
default: None
|
||||
type: string
|
||||
description: Comma separated list of key=value config flags to be set in cinder.conf
|
||||
|
|
|
@ -0,0 +1,17 @@
|
|||
Format: http://dep.debian.net/deps/dep5/
|
||||
|
||||
Files: *
|
||||
Copyright: Copyright 2012, Canonical Ltd., All Rights Reserved.
|
||||
License: GPL-3
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
.
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
.
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
17
debug.log
17
debug.log
|
@ -1,17 +0,0 @@
|
|||
[DEBUG] Calling 'juju status'...
|
||||
[DEBUG] Destroying service: nova-volume
|
||||
[DEBUG] Calling juju, attempt 1: juju destroy-service nova-volume
|
||||
[DEBUG] Destroying service: keystone
|
||||
[DEBUG] Calling juju, attempt 1: juju destroy-service keystone
|
||||
[DEBUG] Destroying service: nova-cloud-controller
|
||||
[DEBUG] Calling juju, attempt 1: juju destroy-service nova-cloud-controller
|
||||
[DEBUG] Destroying service: mysql
|
||||
[DEBUG] Calling juju, attempt 1: juju destroy-service mysql
|
||||
[DEBUG] Terminating machine: 16
|
||||
[DEBUG] Calling juju, attempt 1: juju terminate-machine 16
|
||||
[DEBUG] Terminating machine: 13
|
||||
[DEBUG] Calling juju, attempt 1: juju terminate-machine 13
|
||||
[DEBUG] Terminating machine: 14
|
||||
[DEBUG] Calling juju, attempt 1: juju terminate-machine 14
|
||||
[DEBUG] Terminating machine: 15
|
||||
[DEBUG] Calling juju, attempt 1: juju terminate-machine 15
|
80
juju.log
80
juju.log
|
@ -1,80 +0,0 @@
|
|||
2012-09-21 17:52:34,141 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:34,141 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:34,141 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:34,141 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:34,143 INFO Connecting to environment...
|
||||
2012-09-21 17:52:36,151 INFO Connected to environment.
|
||||
2012-09-21 17:52:37,124 INFO Service 'nova-volume' destroyed.
|
||||
2012-09-21 17:52:37,124 INFO 'destroy_service' command finished successfully
|
||||
2012-09-21 17:52:37,572 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:37,572 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:37,572 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:37,572 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:37,573 INFO Connecting to environment...
|
||||
2012-09-21 17:52:39,589 INFO Connected to environment.
|
||||
2012-09-21 17:52:40,608 INFO Service 'keystone' destroyed.
|
||||
2012-09-21 17:52:40,609 INFO 'destroy_service' command finished successfully
|
||||
2012-09-21 17:52:41,047 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:41,047 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:41,047 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:41,047 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:41,048 INFO Connecting to environment...
|
||||
2012-09-21 17:52:43,035 INFO Connected to environment.
|
||||
2012-09-21 17:52:43,990 INFO Service 'nova-cloud-controller' destroyed.
|
||||
2012-09-21 17:52:43,990 INFO 'destroy_service' command finished successfully
|
||||
2012-09-21 17:52:44,427 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:44,428 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:44,428 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:44,428 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:44,429 INFO Connecting to environment...
|
||||
2012-09-21 17:52:46,524 INFO Connected to environment.
|
||||
2012-09-21 17:52:47,378 INFO Service 'mysql' destroyed.
|
||||
2012-09-21 17:52:47,379 INFO 'destroy_service' command finished successfully
|
||||
2012-09-21 17:52:47,822 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:47,822 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:47,822 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:47,822 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:47,823 INFO Connecting to environment...
|
||||
2012-09-21 17:52:49,836 INFO Connected to environment.
|
||||
2012-09-21 17:52:49,837 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:49,837 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:49,838 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:49,838 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:50,158 INFO Machines terminated: 16
|
||||
2012-09-21 17:52:50,158 INFO 'terminate_machine' command finished successfully
|
||||
2012-09-21 17:52:50,604 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:50,605 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:50,605 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:50,605 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:50,606 INFO Connecting to environment...
|
||||
2012-09-21 17:52:52,668 INFO Connected to environment.
|
||||
2012-09-21 17:52:52,669 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:52,669 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:52,669 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:52,669 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:52,988 INFO Machines terminated: 13
|
||||
2012-09-21 17:52:52,989 INFO 'terminate_machine' command finished successfully
|
||||
2012-09-21 17:52:53,427 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:53,427 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:53,427 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:53,427 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:53,428 INFO Connecting to environment...
|
||||
2012-09-21 17:52:55,482 INFO Connected to environment.
|
||||
2012-09-21 17:52:55,483 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:55,483 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:55,483 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:55,484 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:55,801 INFO Machines terminated: 14
|
||||
2012-09-21 17:52:55,802 INFO 'terminate_machine' command finished successfully
|
||||
2012-09-21 17:52:56,243 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:56,243 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:56,243 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:56,243 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:56,244 INFO Connecting to environment...
|
||||
2012-09-21 17:52:58,284 INFO Connected to environment.
|
||||
2012-09-21 17:52:58,285 WARNING ssl-hostname-verification is disabled for this environment
|
||||
2012-09-21 17:52:58,285 WARNING EC2 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:58,286 WARNING S3 API calls encrypted but not authenticated
|
||||
2012-09-21 17:52:58,286 WARNING Ubuntu Cloud Image lookups encrypted but not authenticated
|
||||
2012-09-21 17:52:58,605 INFO Machines terminated: 15
|
||||
2012-09-21 17:52:58,606 INFO 'terminate_machine' command finished successfully
|
Loading…
Reference in New Issue