Description

This cookbook installs the OpenStack Image service Glance as part of an OpenStack 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": "<Rackspace Cloud User Name>", "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
• keystone
• mysql
• openssl
• openstack-common

=======

Recipes

default

-Includes recipes api, registry

api

-Installs the glance-api server

registry

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

Attributes

• glance["verbose"] - Enables/disables verbose output for glance services.

• glance["debug"] - Enables/disables debug output for glance services.

• glance["keystone_service_chef_role"] - The name of the Chef role that installs the Keystone Service API

• `glance["user"] - User glance runs as

• `glance["group"] - Group glance runs as

• glance["glance_api_chef_role"] - The name of the Chef role that installs the Glance API service

• glance["db"]["username"] - Username for glance database access

• 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["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_role"] - User role used by glance when interacting with keystone - used in the API and registry paste.ini files

• default["glance"]["pki"]["signing_dir"] - Defaults to /tmp/glance-signing-dir. Directory where auth_token middleware writes certificate

• 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 <imagename> 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 (justin.shepherd@rackspace.com) Author:: Jason Cannavale (jason.cannavale@rackspace.com) Author:: Ron Pedde (ron.pedde@rackspace.com) Author:: Joseph Breu (joseph.breu@rackspace.com) Author:: William Kelly (william.kelly@rackspace.com) Author:: Darren Birkett (darren.birkett@rackspace.co.uk) Author:: Evan Callicoat (evan.callicoat@rackspace.com) Author:: Matt Ray (matt@opscode.com)

Copyright 2012, Rackspace US, Inc. Copyright 2012, Opscode, Inc.

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.