OpenStack Integration Test Suite ガイド

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。
2. stack ユーザーのホームディレクトリーにある undercloud.conf ファイルを編集します。

3. enable_tempest パラメーターを true に設定します。

   enable_tempest = true

   Copy to Clipboard Toggle word wrap

4. openstack undercloud install コマンドを実行し、アンダークラウドに追加設定を追加します。

   $ openstack undercloud install

   Copy to Clipboard Toggle word wrap

手順

1. 以下のネットワークが Red Hat OpenStack Platform (RHOSP) 環境内で利用可能であることを確認します。

   • Floating IP を提供できる外部ネットワーク

   • プライベートネットワーク

     ルーターを使用してこれらのネットワークに接続します。

     1. プライベートネットワークを作成するには、ネットワークデプロイメントに応じて以下のオプションを指定します。

        $ openstack network create <network_name> --share
        $ openstack subnet create <subnet_name> --subnet-range <address/prefix> \
          --network <network_name>
        $ openstack router create <router_name>
        $ openstack router add subnet <router_name> <subnet_name>

        Copy to Clipboard Toggle word wrap

     2. パブリックネットワークを作成するには、ネットワークデプロイメントに従って以下のオプションを指定します。

        $ openstack network create <network_name> --external \
          --provider-network-type flat \
          --provider-physical-network datacentre
        $ openstack subnet create <subnet_name> --subnet-range <address/prefix> \
          --gateway <default_gateway> --no-dhcp --network <network_name>
        $ openstack router set <router_name> --external-gateway <public_network_name>

        Copy to Clipboard Toggle word wrap

2. Integration Test Suite に関連するパッケージをインストールします。

   $ sudo dnf -y install openstack-tempest

   Copy to Clipboard Toggle word wrap

   このコマンドでは、tempest プラグインはインストールされません。RHOSP のインストールに応じて、プラグインを手動でインストールする必要があります。

3. 環境内の各コンポーネントに適切な tempest プラグインをインストールします。たとえば、keystone、neutron、cinder、および telemetry プラグインをインストールするには、以下のコマンドを入力します。

   $ sudo dnf install python3-keystone-tests-tempest python3-neutron-tests-tempest python3-cinder-tests-tempest python3-telemetry-tests-tempest

   Copy to Clipboard Toggle word wrap

   パッケージの全リストは、Integration Test Suite のパッケージ を参照してください。

手順

1. ターゲットデプロイメントの認証情報を読み込みます。

   • ターゲットがアンダークラウドにある場合は、source コマンドでアンダークラウドの認証情報を読み込みます。

     # source stackrc

     Copy to Clipboard Toggle word wrap

   • ターゲットがオーバークラウドにある場合、source コマンドでオーバークラウドの認証情報を読み込みます。

     # source overcloudrc

     Copy to Clipboard Toggle word wrap

2. tempest を初期化します。

   # tempest init mytempest
   # cd mytempest

   Copy to Clipboard Toggle word wrap

   このコマンドは、mytempest という名前の tempest ワークスペースを作成します。

3. オプション: 以下のコマンドを入力して、既存のワークスペースのリストを表示します。

   # tempest workspace list

   Copy to Clipboard Toggle word wrap

4. etc/tempest.conf ファイルを生成します。

   # discover-tempest-config --deployer-input ~/tempest-deployer-input.conf \
   --debug --create --network-id <UUID>

   Copy to Clipboard Toggle word wrap

   UUID を外部ネットワークの UUID に置き換えます。

   discover-tempest-config は、以前は config_tempest.py と呼ばれ、同じパラメーターを使用します。python-tempestconf は openstack-tempest の依存関係として、discover-tempest-config を提供しています。

   注記

   アンダークラウドの etc/tempest.conf ファイルを生成するには、tempest-deployer-input.conf ファイルのリージョン名がアンダークラウドデプロイメントの名前と同じであることを確認します。これらの名前が一致しない場合は、tempest-deployer-input.conf ファイルのリージョン名を更新して、アンダークラウドのリージョン名と一致するように更新します。

5. アンダークラウドのリージョン名を検証するには、以下のコマンドを入力します。

   $ source stackrc
   $ openstack region list

   Copy to Clipboard Toggle word wrap

6. オーバークラウドのリージョン名を検証するには、以下のコマンドを入力します。

   $ source overcloudrc
   $ openstack region list

   Copy to Clipboard Toggle word wrap

手順

1. tempest.conf の [DEFAULT] セクションで、log_dir を目的のディレクトリーに設定します。

   [DEFAULT]
   log_dir = <directory>

   Copy to Clipboard Toggle word wrap

2. tempest.conf に独自のロギング設定ファイルを使用している場合は、使用しているファイルの [DEFAULT] セクションの下に log_config_append を設定します。

   [DEFAULT]
   log_config_append = <file>

   Copy to Clipboard Toggle word wrap

手順

1. tempest.conf 設定ファイルでオプションを設定し、ターゲットマイクロバージョンを指定します。これらのオプションを設定して、サポートされているマイクロバージョンが OpenStack クラウド内のマイクロバージョンに対応するようにします。

2. 単一の Integration Test Suite 操作で複数のマイクロバージョンテストを実行するターゲットマイクロバージョンの範囲を指定できます。

   たとえば、設定ファイルの [compute] セクションで、compute サービスのマイクロバージョンの範囲を制限するには、min_microversion および max_microversion パラメーターに値を割り当てます。

   [compute]
   min_microversion = 2.14
   max_microversion = latest

   Copy to Clipboard Toggle word wrap

手順

1. ドライランを完了します。

   # tempest cleanup --dry-run

   Copy to Clipboard Toggle word wrap
2. dry_run.json ファイルをチェックして、クリーンアップにより環境に必要なファイルが削除されないようにします。

手順

1. 保存された状態を初期化し、saved_state.json ファイルを作成します。

   # tempest cleanup --init-saved-state

   Copy to Clipboard Toggle word wrap

2. クリーンアップを実行します。

   # tempest cleanup

   Copy to Clipboard Toggle word wrap