7a12374003
This patch does the following: - Move the CONTRIBUTING doc content into the developer documentation - Move the development-stack doc content into the developer documentation - Rename all instances of 'OpenStack Ansible' to 'OpenStack-Ansible' - Implements a simpler navigation index for the bottom of the page - Implements a navigation index at the bottom of all developer docs - Updates the README to reflect where to get documentation and further information - Adds more information into the 'scripts' developer doc - Updates the 'Additional Resources' Appendix with Ansible information Change-Id: Ic08ba072f3b3d1e4e446d1e81c20c0cdf01833de
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
|