第1章 Image サービス (glance)

手順

1. アンダークラウドの環境ファイルの ExtraConfig パラメーターを使用して、実際の要件に応じて新しい間隔を追加します。

   parameter_defaults:
     ControllerExtraConfig:
       glance::config::glance_api_config:
         DEFAULT/cache_prefetcher_interval:
           value: '<300>'

   <300> を、イメージを事前キャッシュする間隔の秒数に置き換えてください。

2. /home/stack/templates/ の環境ファイルで間隔を修正したら、stack ユーザーとしてログインして設定をデプロイします。

   $ openstack overcloud deploy --templates \
   -e /home/stack/templates/<env_file>.yaml

   <env_file> は、追加した ExtraConfig 設定が含まれる環境ファイルの名前に置き換えてください。

   重要

   オーバークラウドの作成時に追加の環境ファイルを渡した場合には、予定外の変更がオーバークラウドに加えられないように、ここで -e オプションを使用して環境ファイルを再度渡します。

手順

1. アンダークラウドに stack ユーザーとしてログインし、controller-0 のプロビジョニング IP アドレスを特定します。

   (undercloud) [stack@site-undercloud-0 ~]$ openstack server list -f value -c Name -c Networks | grep controller
   overcloud-controller-1 ctlplane=192.168.24.40
   overcloud-controller-2 ctlplane=192.168.24.13
   overcloud-controller-0 ctlplane=192.168.24.71
   (undercloud) [stack@site-undercloud-0 ~]$

2. オーバークラウドに対して認証するには、/home/stack/overcloudrc (デフォルト) に保存されている認証情報を controller-0 にコピーします。

   $ scp ~/overcloudrc heat-admin@192.168.24.71:/home/heat-admin/

3. controller-0 に接続します。

   $ ssh heat-admin@192.168.24.71

4. controller-0 において、heat-admin ユーザーとして glance_api service の IP アドレスを特定します。以下の例では、IP アドレスは 172.25.1.105 です。

   (overcloud) [root@controller-0 ~]# grep -A 10 '^listen glance_api' /var/lib/config-data/puppet-generated/haproxy/etc/haproxy/haproxy.cfg
   listen glance_api
    server central-controller0-0.internalapi.redhat.local 172.25.1.105:9292 check fall 5 inter 2000 rise 2

5. glance-cache-manage コマンドは glance_api コンテナーでしか利用できないため、そのコンテナーに対して実行するスクリプトを作成します。このコンテナーには、オーバークラウドに対して認証するための環境変数がすでに設定されています。controller-0 の /home/heat-admin に、以下の内容でスクリプト glance_pod.sh を作成します。

   sudo podman exec -ti \
    -e NOVA_VERSION=$NOVA_VERSION \
    -e COMPUTE_API_VERSION=$COMPUTE_API_VERSION \
    -e OS_USERNAME=$OS_USERNAME \
    -e OS_PROJECT_NAME=$OS_PROJECT_NAME \
    -e OS_USER_DOMAIN_NAME=$OS_USER_DOMAIN_NAME \
    -e OS_PROJECT_DOMAIN_NAME=$OS_PROJECT_DOMAIN_NAME \
    -e OS_NO_CACHE=$OS_NO_CACHE \
    -e OS_CLOUDNAME=$OS_CLOUDNAME \
    -e no_proxy=$no_proxy \
    -e OS_AUTH_TYPE=$OS_AUTH_TYPE \
    -e OS_PASSWORD=$OS_PASSWORD \
    -e OS_AUTH_URL=$OS_AUTH_URL \
    -e OS_IDENTITY_API_VERSION=$OS_IDENTITY_API_VERSION \
    -e OS_COMPUTE_API_VERSION=$OS_COMPUTE_API_VERSION \
    -e OS_IMAGE_API_VERSION=$OS_IMAGE_API_VERSION \
    -e OS_VOLUME_API_VERSION=$OS_VOLUME_API_VERSION \
    -e OS_REGION_NAME=$OS_REGION_NAME \
   glance_api /bin/bash

6. source コマンドで overcloudrc ファイルを読み込み、glance_pod.sh スクリプトを実行して、オーバークラウドのコントローラーノードに対して認証するのに必要な環境変数が設定されている glance_api コンテナーに対して実行します。

   [heat-admin@controller-0 ~]$ source overcloudrc
   (overcloudrc) [heat-admin@central-controller-0 ~]$ bash glance_pod.sh
   ()[glance@controller-0 /]$

7. glance image-list 等のコマンドを使用して、コンテナーでオーバークラウドに対して認証されたコマンドを実行できることを確認します。

   ()[glance@controller-0 /]$ glance image-list
   +--------------------------------------+----------------------------------+
   | ID                                   | Name                             |
   +--------------------------------------+----------------------------------+
   | ad2f8daf-56f3-4e10-b5dc-d28d3a81f659 | cirros-0.4.0-x86_64-disk.img       |
   +--------------------------------------+----------------------------------+
   ()[glance@controller-0 /]$

手順

1. 管理ユーザーとして、キャッシュするイメージをキューに追加します。

   $ glance-cache-manage --host=<host_ip> queue-image <image_id>

   • <host_ip> を glance-api コンテナーが実行されているコントローラーノードの IP アドレスに置き換えます。

   • <image_id> をキューに追加するイメージの ID に置き換えます。

     事前にキャッシュするイメージをキューに追加すると、cache_images 定期ジョブはキューに追加されたすべてのイメージを同時に事前取得します。

     注記

     イメージキャッシュは各ノードにローカルなので、Red Hat OpenStack Platform が HA 設定でデプロイされている場合 (3、5、または 7 台のコントローラー)、glance-cache-manage コマンドを実行する際に --host オプションでホストのアドレスを指定する必要があります。

2. 以下のコマンドを実行して、イメージキャッシュ内のイメージを表示します。

   $ glance-cache-manage --host=<host_ip> list-cached

   <host_ip> を環境内のホストの IP アドレスに置き換えてください。

手順

1. クラウド管理者として新たな heat テンプレートの環境ファイルを作成し (例: lock-down-glance-metadef-api.yaml)、Image サービス metadef API のポリシーオーバーライドを含めます。

   ...
   parameter_defaults:
     GlanceApiPolicies: {
   	glance-metadef_default: { key: 'metadef_default', value: '' },
   	glance-metadef_admin: { key: 'metadef_admin', value: 'role:admin' },
   	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_admin' },
   	glance-add_metadef_namespace: { key: 'add_metadef_namespace', value: 'rule:metadef_admin' },
   	glance-delete_metadef_namespace: { key: 'delete_metadef_namespace', value: 'rule:metadef_admin' },
   	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_admin' },
   	glance-add_metadef_object: { key: 'add_metadef_object', value: 'rule:metadef_admin' },
   	glance-delete_metadef_object: { key: 'delete_metadef_object', value: 'rule:metadef_admin' },
   	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_admin' },
   	glance-remove_metadef_resource_type_association: { key: 'remove_metadef_resource_type_association', value: 'rule:metadef_admin' },
   	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_admin' },
   	glance-add_metadef_property: { key: 'add_metadef_property', value: 'rule:metadef_admin' },
   	glance-remove_metadef_property: { key: 'remove_metadef_property', value: 'rule:metadef_admin' },
   	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_admin' },
   	glance-add_metadef_tag: { key: 'add_metadef_tag', value: 'rule:metadef_admin' },
   	glance-add_metadef_tags: { key: 'add_metadef_tags', value: 'rule:metadef_admin' },
   	glance-delete_metadef_tag: { key: 'delete_metadef_tag', value: 'rule:metadef_admin' },
   	glance-delete_metadef_tags: { key: 'delete_metadef_tags', value: 'rule:metadef_admin' }
     }
   
   …

2. オーバークラウドのデプロイ時に -e オプションを使用して、ポリシーオーバーライドが含まれる環境ファイルをデプロイメントコマンドに追加します。

   $ openstack overcloud deploy -e lock-down-glance-metadef-api.yaml

手順

1. クラウド管理者としてアンダークラウドにログインし、ポリシーオーバーライド用のファイルを作成します。以下に例を示します。

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

2. すべてのユーザーが metadef API を読み取り/書き込みできるように、ポリシーオーバーライドファイルを設定します。

   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' }
     }

   注記

   すべての metadef ポリシーを設定する際に、rule:metadeta_default を使用する必要があります。

3. オーバークラウドのデプロイ時に -e オプションを使用して、デプロイメントコマンドに新しいポリシーファイルを追加します。

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