Chapter 1. The Image service (glance)

Procedure

1. In an environment file, set the value of the GlanceCacheEnabled parameter to true, which automatically sets the flavor value to keystone+cachemanagement in the glance-api.conf heat template:

   parameter_defaults:
       GlanceCacheEnabled: true

   Copy to Clipboard Toggle word wrap
2. Include the environment file in the openstack overcloud deploy command when you redeploy the overcloud.

3. Optional: Tune the glance_cache_pruner to an alternative frequency when you redeploy the overcloud. The following example shows a frequency of 5 minutes:

   parameter_defaults:
     ControllerExtraConfig:
       glance::cache::pruner::minute: '*/5'

   Copy to Clipboard Toggle word wrap

   Adjust the frequency according to your needs to avoid file system full scenarios. Include the following elements when you choose an alternative frequency:

   • The size of the files that you want to cache in your environment.
   • The amount of available file system space.
   • The frequency at which the environment caches images.

Procedure

1. Log in to the undercloud node as the stack user.

2. Source the stackrc credentials file:

   $ source stackrc

   Copy to Clipboard Toggle word wrap

3. Create an environment file with the following content:

   parameter_defaults:
       GlanceSparseUploadEnabled: true

   Copy to Clipboard Toggle word wrap

4. Add your new environment file to the stack with your other environment files and deploy the overcloud:

   $ openstack overcloud deploy \
       --templates \
       …
       -e <existing_overcloud_environment_files> \
       -e <new_environment_file>.yaml \
       ...

   Copy to Clipboard Toggle word wrap

1. Download the image file locally:

   $ wget <file_location>/<file_name>

   Copy to Clipboard Toggle word wrap
   • Replace <file_location> with the location of the file.

   • Replace <file_name> with the name of the file.

     For example:

     $ wget https://cloud.centos.org/centos/6/images/CentOS-6-x86_64-GenericCloud-1508.qcow2

     Copy to Clipboard Toggle word wrap

2. Check the disk size and the virtual size of the image to be uploaded:

   $ qemu-img info <file_name>

   Copy to Clipboard Toggle word wrap

   For example:

   $ qemu-img info CentOS-6-x86_64-GenericCloud-1508.qcow2
   
   image: CentOS-6-x86_64-GenericCloud-1508.qcow2
   file format: qcow2
   virtual size: 8 GiB (8589934592 bytes)
   disk size: 1.09 GiB
   cluster_size: 65536
   Format specific information:
   compat: 0.10
   refcount bits: 1

   Copy to Clipboard Toggle word wrap

3. Import the image:

   $ glance image-create-via-import --disk-format qcow2 --container-format bare --name centos_1 --file <file_name>

   Copy to Clipboard Toggle word wrap
4. Record the image ID. It is required in a subsequent step.

5. Verify that the image is imported and in an active state:

   $ glance image show <image_id>

   Copy to Clipboard Toggle word wrap

6. From a Ceph Storage node, verify that the size of the image is less than the virtual size from the output of step 1:

   $ sudo rbd -p images diff <image_id> | awk '{ SUM += $2 } END { print SUM/1024/1024/1024 " GB" }'
   
   1.03906 GB

   Copy to Clipboard Toggle word wrap

7. Optional: You can confirm that rbd_thin_provisioning is configured in the Image service configuration file on the Controller nodes:

   1. Use SSH to access a Controller node:

      $ ssh -A -t tripleo-admin@<controller_node_IP_address>

      Copy to Clipboard Toggle word wrap

   2. Confirm that rbd_thin_provisioning equals True on that Controller node:

      $ sudo podman exec -it glance_api sh -c 'grep ^rbd_thin_provisioning /etc/glance/glance-api.conf'

      Copy to Clipboard Toggle word wrap

Procedure

1. As a cloud administrator, log in to the undercloud and create a file for policy overrides. For example:

   $ cat open-up-glance-api-metadef.yaml

   Copy to Clipboard Toggle word wrap

2. Configure the policy override file to allow metadef API read-write access to all users:

   GlanceApiPolicies: {
       glance-metadef_default: { key: 'metadef_default', value: '' },
       glance-get_metadef_namespace: { key: 'get_metadef_namespace', value: 'rule:metadef_default' },
       glance-get_metadef_namespaces: { key: 'get_metadef_namespaces', value: 'rule:metadef_default' },
       glance-modify_metadef_namespace: { key: 'modify_metadef_namespace', value: 'rule:metadef_default' },
       glance-add_metadef_namespace: { key: 'add_metadef_namespace', value: 'rule:metadef_default' },
       glance-delete_metadef_namespace: { key: 'delete_metadef_namespace', value: 'rule:metadef_default' },
       glance-get_metadef_object: { key: 'get_metadef_object', value: 'rule:metadef_default' },
       glance-get_metadef_objects: { key: 'get_metadef_objects', value: 'rule:metadef_default' },
       glance-modify_metadef_object: { key: 'modify_metadef_object', value: 'rule:metadef_default' },
       glance-add_metadef_object: { key: 'add_metadef_object', value: 'rule:metadef_default' },
       glance-delete_metadef_object: { key: 'delete_metadef_object', value: 'rule:metadef_default' },
       glance-list_metadef_resource_types: { key: 'list_metadef_resource_types', value: 'rule:metadef_default' },
       glance-get_metadef_resource_type: { key: 'get_metadef_resource_type', value: 'rule:metadef_default' },
       glance-add_metadef_resource_type_association: { key: 'add_metadef_resource_type_association', value: 'rule:metadef_default' },
       glance-remove_metadef_resource_type_association: { key: 'remove_metadef_resource_type_association', value: 'rule:metadef_default' },
       glance-get_metadef_property: { key: 'get_metadef_property', value: 'rule:metadef_default' },
       glance-get_metadef_properties: { key: 'get_metadef_properties', value: 'rule:metadef_default' },
       glance-modify_metadef_property: { key: 'modify_metadef_property', value: 'rule:metadef_default' },
       glance-add_metadef_property: { key: 'add_metadef_property', value: 'rule:metadef_default' },
       glance-remove_metadef_property: { key: 'remove_metadef_property', value: 'rule:metadef_default' },
       glance-get_metadef_tag: { key: 'get_metadef_tag', value: 'rule:metadef_default' },
       glance-get_metadef_tags: { key: 'get_metadef_tags', value: 'rule:metadef_default' },
       glance-modify_metadef_tag: { key: 'modify_metadef_tag', value: 'rule:metadef_default' },
       glance-add_metadef_tag: { key: 'add_metadef_tag', value: 'rule:metadef_default' },
       glance-add_metadef_tags: { key: 'add_metadef_tags', value: 'rule:metadef_default' },
       glance-delete_metadef_tag: { key: 'delete_metadef_tag', value: 'rule:metadef_default' },
       glance-delete_metadef_tags: { key: 'delete_metadef_tags', value: 'rule:metadef_default' }
     }

   Copy to Clipboard Toggle word wrap
   Note

   You must configure all metadef policies to use rule:metadef_default. For information about policies and policy syntax, see this Policies chapter.

3. Include the new policy file in the deployment command with the -e option when you deploy the overcloud:

   $ openstack overcloud deploy -e open-up-glance-api-metadef.yaml

   Copy to Clipboard Toggle word wrap