Description

This cookbook installs the OpenStack Image service Glance as part of the OpenStack Essex reference deployment Chef for OpenStack. The http://github.com/opscode/openstack-chef-repo contains documentation for using this cookbook in the context of a full OpenStack deployment. Glance is installed from packages, optionally populating the repository with default images.

http://glance.openstack.org/

Usage

The Glance cookbook currently supports file, swift, and Rackspace Cloud Files (swift API compliant) backing stores. NOTE: changing the storage location from cloudfiles to swift (and vice versa) requires that you manually export and import your stored images.

To enable these features set the following in the default attributes section in your environment:

Files

"glance": {
  "api": {
    "default_store": "file"
  },
  "images": [
    "cirros"
  ],
  "image_upload": true
}

Swift

"glance": {
  "api": {
    "default_store": "swift"
  },
  "images": [
    "cirros"
  ],
  "image_upload": true
}

Cloud Files

"glance": {
  "api": {
    "default_store": "swift",
    "swift_store_user": "<Cloud Files Tenant ID>:<Rackspace Cloud Files Username>",
    "swift_store_key": "<Rackspace Cloud Password>",
    "swift_store_auth_version": "2",
    "swift_store_auth_address": "https://identity.api.rackspacecloud.com/v2.0"
  },
  "images": [
    "cirros"
  ],
  "image_upload": true
}

To obtain your Cloud Files Tenant ID use the following: curl -s -X POST https://identity.api.rackspacecloud.com/v2.0/tokens -d '{"auth": {"passwordCredentials": {"username": "", "password": "<Rackspace Cloud Password"}}}' -H "Content-type: application/json" | python -mjson.tool | grep "tenantId.*Mosso" | head -1

Requirements

Chef 0.10.0 or higher required (for Chef environment use)

Platform

Ubuntu-12.04
Fedora-17

Cookbooks

The following cookbooks are dependencies:

database
mysql
keystone
osops-utils

Recipes

default

-Includes recipes api, registry

api

-Installs the glance-api server

registry

-Includes recipe mysql:client -Installs the glance-registry server

Attributes

glance["db"]["name"] - Name of glance database
glance["db"]["user"] - Username for glance database access
glance["db"]["password"] - Password for glance database access
glance["api"]["ip_address"] - IP address to use for communicating with the glance API
glance["api"]["bind_address"] - IP address for the glance API to bind to
glance["api"]["port"] - Port for the glance API to bind to
glance["api"]["adminURL"] - Used when registering image endpoint with keystone
glance["api"]["internalURL"] - Used when registering image endpoint with keystone
glance["api"]["publicURL"] - Used when registering image endpoint with keystone
glance["registry"]["ip_address"] - IP address to use for communicating with the glance registry
glance["registry"]["bind_address"] - IP address for the glance registry to bind to
glance["registry"]["port"] - IP address for the glance port to bind to
glance["service_tenant_name"] - Tenant name used by glance when interacting with keystone - used in the API and registry paste.ini files
glance["service_user"] - User name used by glance when interacting with keystone - used in the API and registry paste.ini files
glance["service_pass"] - User password used by glance when interacting with keystone - used in the API and registry paste.ini files
glance["service_role"] - User role used by glance when interacting with keystone - used in the API and registry paste.ini files
glance["image_upload"] - Toggles whether to automatically upload images in the glance["images"] array
glance["images"] - Default list of images to upload to the glance repository as part of the install
glance["image]["<imagename>"] - URL location of the image. There can be multiple instances of this line to define multiple imagess (eg natty, maverick, fedora17 etc) --- example glance["image]["natty"] - "http://c250663.r63.cf1.rackcdn.com/ubuntu-11.04-server-uec-amd64-multinic.tar.gz"
glance["api"]["default_store"] - Toggles the backend storage type. Currently supported is "file" and "swift"
`glance["api"]["swift"]["store_container"] - Set the container used by glance to store images and snapshots. Defaults to "glance"
`glance["api"]["swift"]["store_large_object_size"] - Set the size at which glance starts to chunnk files. Defaults to "200" MB
`glance["api"]["swift"]["store_large_object_chunk_size"] - Set the chunk size for glance. Defaults to "200" MB

Templates

glance-api-paste.ini.erb - Paste config for glance-api middleware
glance-api.conf.erb - Config file for glance-api server
glance-registry-paste.ini.erb - Paste config for glance-registry middleware
glance-registry.conf.erb - Config file for glance-registry server
glance-scrubber.conf.erb - Config file for glance image scrubber service
policy.json.erb - Configuration of ACLs for glance API server

License and Author

Author:: Justin Shepherd ([email protected]) Author:: Jason Cannavale ([email protected]) Author:: Ron Pedde ([email protected]) Author:: Joseph Breu ([email protected]) Author:: William Kelly ([email protected]) Author:: Darren Birkett ([email protected]) Author:: Evan Callicoat ([email protected]) Author:: Matt Ray ([email protected])

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

djoreilly / chef-glance Goto Github PK

chef-glance's Introduction