イメージの作成と管理

手順

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 設定が含まれる環境ファイルの名前に置き換えてください。

手順

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

1. イメージを作成して、インポートするイメージの URI を指定します。

   $ glance image-create-via-import \
       --container-format <CONTAINER FORMAT> \
       --disk-format <DISK-FORMAT> \
       --name <NAME> \
       --import-method web-download \
       --uri <URI>

   • <CONTAINER FORMAT> は、イメージに設定するコンテナー形式 (None、ami、ari、aki、bare、ovf、ova、docker) に置き換えます。
   • <DISK-FORMAT> は、イメージに設定しているディスクフォーマット (None、ami、ari、aki、vhd、vhdx、vmdk、raw、qcow2、vdi、iso、ploop) に置き換えます。
   • <NAME> は、イメージのわかりやすい名前に置き換えます。
   • <URI> は、イメージの URI に置き換えます。

2. glance image-show <IMAGE_ID> コマンドを使用して、イメージの可用性を確認できます。

   • <IMAGE_ID> は、イメージの作成時に指定した ID に置き換えます。

1. Web ダウンロード 方式では、イメージレコードが作成されます。
2. Web ダウンロード メソッドは、指定された URI からイメージを取得します。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. source コマンドでアンダークラウドの認証情報ファイルを読み込みます。

   $ source ~/stackrc

3. 環境ファイルに GlanceDiskFormats パラメーターを追加します (例: glance_disk_formats.yaml)。

   parameter_defaults:
     GlanceDiskFormats:
       - <disk_format>

   • たとえば、RAW および ISO ディスクフォーマットだけを有効にするには、以下の設定を使用します。

     parameter_defaults:
       GlanceDiskFormats:
       - raw
       - iso

   • QCOW2 ディスクイメージを拒否するには、以下の設定例を使用します。

     parameter_defaults:
       GlanceDiskFormats:
       - raw
       - iso
       - aki
       - ari
       - ami

4. ご自分の環境に該当するその他の環境ファイルと共に、新しい設定が含まれる環境ファイルを openstack overcloud deploy コマンドに追加します。

   $ openstack overcloud deploy --templates \
     -e <overcloud_environment_files> \
     -e <new_environment_file> \
     …

   • <overcloud_environment_files> をデプロイメントに追加する環境ファイルのリストに置き換えます。
   • <new_environment_file> を新しい設定が含まれる環境ファイルに置き換えます。