Files
openstack-ansible/doc/source/install-guide/configure-glance.rst
Matt Thompson 06708191d6 Install Guide Cleanup
This commit does the following:

- sets all shell prompts in code-blocks to the root prompt
- uses shell-session code-block since the shell prompt was being
  treated as a comment
- links configure-aodh.rst in configure.rst (running tox was
  complaining that this file wasn't being linked anywhere)
- other minor cleanup

Change-Id: I9e3ac8bb0cabd1cc17952cfd765dbb0d8f7b6fa2
2015-10-21 07:25:25 +01:00

3.0 KiB

Home OpenStack-Ansible Installation Guide

Configuring the Image service

In an all-in-one deployment with a single infrastructure node, the Image service uses the local file system on the target host to store images. When deploying production clouds we recommend backing Glance with a swift backend or some form or another of shared storage.

The following procedure describes how to modify the /etc/openstack_deploy/user_variables.yml file to enable Cloud Files usage.

  1. Change the default store to use Object Storage (swift), the underlying architecture of Cloud Files:

    glance_default_store: swift
  2. Set the appropriate authentication URL:

    glance_swift_store_auth_address: https://127.0.0.1/v2.0
  3. Set the swift account credentials:

    # Replace this capitalized variables with actual data.
    glance_swift_store_user: GLANCE_SWIFT_TENANT:GLANCE_SWIFT_USER
    glance_swift_store_key: SWIFT_PASSWORD_OR_KEY
  4. Change the glance_swift_store_endpoint_type from the default internalURL settings to publicURL if needed.

    glance_swift_store_endpoint_type: publicURL
  5. Define the store name:

    glance_swift_store_container: STORE_NAME

    Replace STORE_NAME with the container name in swift to be used for storing images. If the container doesn't exist, it will be automatically created.

  6. Define the store region:

    glance_swift_store_region: STORE_REGION

    Replace STORE_REGION if needed.

  7. (Optional) Set the paste deploy flavor:

    glance_flavor: GLANCE_FLAVOR

    By default, the Image service uses caching and authenticates with the Identity service. The default maximum size of the image cache is 10 GB. The default Image service container size is 12 GB. In some configurations, the Image service might attempt to cache an image which exceeds the available disk space. If necessary, you can disable caching. For example, to use Identity without caching, replace GLANCE_FLAVOR with keystone:

    glance_flavor: keystone

    Or, to disable both authentication and caching, set GLANCE_FLAVOR to no value:

    glance_flavor:

    This option is set by default to use authentication and cache management in the playbooks/roles/os_glance/defaults/main.yml file. To override the default behavior, set glance_flavor to a different value in /etc/openstack_deploy/user_variables.yml.

    The possible values for GLANCE_FLAVOR are:

    • (Nothing)
    • caching
    • cachemanagement
    • keystone
    • keystone+caching
    • keystone+cachemanagement (default)
    • trusted-auth
    • trusted-auth+cachemanagement