f9f907732e
Convert RPC installation guide from DocBook to RST, remove content specific to Rackspace, and create initial OSAD installation guide. Change-Id: I3eedadc8ba441b4d931720dd6e3f7f3489302a9c Co-Authored-By: Matt Kassawara <mkassawara@gmail.com>
113 lines
3.0 KiB
ReStructuredText
113 lines
3.0 KiB
ReStructuredText
`Home <index.html>`__ 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.
|
|
|
|
#. Change the default store to use Object Storage (swift), the
|
|
underlying architecture of Cloud Files:
|
|
|
|
.. code-block:: yaml
|
|
|
|
glance_default_store: swift
|
|
|
|
#. Set the appropriate authentication URL:
|
|
|
|
.. code-block:: yaml
|
|
|
|
glance_swift_store_auth_address: https://127.0.0.1/v2.0
|
|
|
|
#. Set the swift account credentials:
|
|
|
|
.. code-block:: yaml
|
|
|
|
# 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
|
|
|
|
#. Change the *``glance_swift_store_endpoint_type``* from the default
|
|
*``internalURL``* settings to *``publicURL``* if needed.
|
|
|
|
.. code-block:: yaml
|
|
|
|
glance_swift_store_endpoint_type: publicURL
|
|
|
|
#. Define the store name:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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.
|
|
|
|
#. Define the store region:
|
|
|
|
.. code-block:: yaml
|
|
|
|
glance_swift_store_region: STORE_REGION
|
|
|
|
Replace *``STORE_REGION``* if needed.
|
|
|
|
#. (Optional) Set the paste deploy flavor:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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``:
|
|
|
|
.. code-block:: yaml
|
|
|
|
glance_flavor: keystone
|
|
|
|
Or, to disable both authentication and caching, set
|
|
*``GLANCE_FLAVOR``* to no value:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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``
|
|
|
|
--------------
|
|
|
|
.. include:: navigation.txt
|