7.3. オーバークラウドの設定およびデプロイ

--templates [TEMPLATES]

デプロイする heat テンプレートが含まれるディレクトリー。空欄にした場合には、デプロイメントコマンドはデフォルトのテンプレートの場所である /usr/share/openstack-tripleo-heat-templates/ を使用します。

--stack STACK

作成または更新するスタックの名前

-t [TIMEOUT]、--timeout [TIMEOUT]

デプロイメントのタイムアウト時間 (分単位)

--libvirt-type [LIBVIRT_TYPE]

ハイパーバイザーに使用する仮想化タイプ

--ntp-server [NTP_SERVER]

時刻の同期に使用する Network Time Protocol (NTP) サーバー。コンマ区切りリストで複数の NTP サーバーを指定することも可能です (例: --ntp-server 0.centos.pool.org,1.centos.pool.org)。高可用性クラスターのデプロイメントの場合には、Controller ノードが一貫して同じ時刻ソースを参照することが重要です。標準的な環境には、確立された慣行によって、NTP タイムソースがすでに指定されている可能性がある点に注意してください。

--no-proxy [NO_PROXY]

環境変数 no_proxy のカスタム値を定義します。これにより、プロキシー通信から特定のホスト名は除外されます。

--overcloud-ssh-user OVERCLOUD_SSH_USER

オーバークラウドノードにアクセスする SSH ユーザーを定義します。通常、SSH アクセスは tripleo-admin ユーザーを介して行われます。

--overcloud-ssh-key OVERCLOUD_SSH_KEY

オーバークラウドノードへの SSH アクセスに使用する鍵のパスを定義します。

--overcloud-ssh-network OVERCLOUD_SSH_NETWORK

オーバークラウドノードへの SSH アクセスに使用するネットワーク名を定義します。

-e [EXTRA HEAT TEMPLATE]、--environment-file [ENVIRONMENT FILE]

オーバークラウドのデプロイメントに渡す追加の環境ファイル。このオプションは複数回指定することができます。openstack overcloud deploy コマンドに渡す環境ファイルの順序が重要である点に注意してください。たとえば、逐次的に渡される各環境ファイルは、前の環境ファイルのパラメーターを上書きします。

--environment-directory

デプロイメントに追加する環境ファイルが含まれるディレクトリー。デプロイメントコマンドでは、これらの環境ファイルは最初に番号順、その後にアルファベット順で処理されます。

-r ROLES_FILE

ロールファイルを定義し、--templates ディレクトリーのデフォルトの roles_data.yaml を上書きします。ファイルの場所は、絶対パスまたは --templates に対する相対パスになります。

-n NETWORKS_FILE

ネットワークファイルを定義し、--templates ディレクトリーのデフォルトの network_data.yaml を上書きします。ファイルの場所は、絶対パスまたは --templates に対する相対パスになります。

-p PLAN_ENVIRONMENT_FILE

プラン環境ファイルを定義し、--templates ディレクトリーのデフォルトの plan-environment.yaml を上書きします。ファイルの場所は、絶対パスまたは --templates に対する相対パスになります。

--no-cleanup

デプロイメント後に一時ファイルを削除せず、それらの場所をログに記録するには、このオプションを使用します。

--update-plan-only

実際のデプロイメントを実行せずにプランを更新するには、このオプションを使用します。

--validation-errors-nonfatal

オーバークラウドの作成プロセスでは、デプロイメントの前に一連のチェックが行われます。このオプションは、デプロイメント前のチェックで何らかの致命的でないエラーが発生した場合に終了します。どのようなエラーが発生してもデプロイメントが失敗するので、このオプションを使用することを推奨します。

--validation-warnings-fatal

オーバークラウドの作成プロセスでは、デプロイメントの前に一連のチェックが行われます。このオプションは、デプロイメント前のチェックで何らかのクリティカルではない警告が発生した場合に終了します。

--dry-run

オーバークラウドを作成せずにオーバークラウドで検証チェックを実行するには、このオプションを使用します。

--run-validations

openstack-tripleo-validations パッケージで提供される外部検証を実行するには、このオプションを使用します。

--skip-postconfig

オーバークラウドデプロイ後の設定を省略するには、このオプションを使用します。

--force-postconfig

オーバークラウドデプロイ後の設定を強制的に行うには、このオプションを使用します。

--skip-deploy-identifier

デプロイメントコマンドで DeployIdentifier パラメーターの一意の ID を生成するのを希望しない場合は、このオプションを使用します。ソフトウェア設定のデプロイメントステップは、実際に設定が変更された場合にしか実行されません。このオプションの使用には注意が必要です。特定のロールをスケールアウトする時など、ソフトウェア設定の実行が明らかに不要な場合にしか使用しないでください。

--answers-file ANSWERS_FILE

引数とパラメーターが記載された YAML ファイルへのパス

--disable-password-generation

オーバークラウドサービスのパスワード生成を無効にする場合は、このオプションを使用します。

--deployed-server

事前にプロビジョニングされたオーバークラウドノードをデプロイする場合は、このオプションを使用します。--disable-validations と併用されます。

--no-config-download, --stack-only

config-download ワークフローを無効にして、スタックおよび関連する OpenStack リソースだけを作成する場合は、このオプションを使用します。このコマンドによってオーバークラウドにソフトウェア設定が適用されることはありません。

--config-download-only

オーバークラウドスタックの作成を無効にして、ソフトウェア設定を適用する config-download ワークフローだけを実行する場合は、このオプションを使用します。

--output-dir OUTPUT_DIR

保存した config-download の出力に使用するディレクトリー。ディレクトリーは mistral ユーザーが書き込み可能でなければなりません。指定しない場合、director はデフォルトの /var/lib/mistral/overcloud を使用します。

--override-ansible-cfg OVERRIDE_ANSIBLE_CFG

Ansible 設定ファイルへのパス。このファイルの設定は、config-download がデフォルトで生成する設定を上書きします。

--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT

config-download のステップに使用するタイムアウト時間 (分単位)。設定しなければ、スタックデプロイメント操作後の --timeout パラメーターの残り時間にかかわらず、director はデフォルトをその時間に設定します。

--limit NODE1,NODE2

(テクノロジープレビュー) config-download Playbook の実行を特定のノードまたはノードセットに制限する場合は、このオプションを使用してノードのコンマ区切りリストを指定します。たとえば、--limit オプションは、スケールアップ操作時に新規ノード上でのみ config-download を実行する場合に役立ちます。この引数により、ホスト間のインスタンスのライブマイグレーションが失敗する可能性があります。ansible-playbook-command.sh スクリプトを使用した config-download の実行 を参照してください。

--tags TAG1,TAG2

(テクノロジープレビュー) config-download の特定のタスクセットでデプロイメントを実施する場合は、このオプションを使用して config-download Playbook からのタグのコンマ区切りリストを指定します。

--skip-tags TAG1,TAG2

(テクノロジープレビュー) config-download Playbook のタグの一部を省略する場合は、このオプションを使用して省略するタグのコンマ区切りリストを指定します。

--validation-errors-fatal

オーバークラウドの作成プロセスでは、デプロイメントの前に一連のチェックが行われます。このオプションは、デプロイメント前のチェックで何らかの致命的なエラーが発生した場合に終了します。どのようなエラーが発生してもデプロイメントが失敗するので、このオプションを使用することを推奨します。

パラメーターのマッピングなし

--disable-validations

デプロイメント前の検証を完全に無効にします。これらの検証は、デプロイメント前の検証として組み込まれていましたが、openstack-tripleo-validations パッケージで提供される外部検証に置き換えられています。

パラメーターのマッピングなし

--config-download

config-download のメカニズムを使用してデプロイメントを実行します。これは現在のデフォルトであり、この CLI のオプションは今後廃止される可能性があります。

パラメーターのマッピングなし

--rhel-reg

カスタマーポータルまたは Satellite 6 にオーバークラウドノードを登録する場合は、このオプションを使用します。

RhsmVars

--reg-method

このオプションを使用して、オーバークラウドノードの登録方法を定義します。Red Hat Satellite 6 または Red Hat Satellite 5 の場合は satellite、カスタマーポータルの場合は portal に設定します。

RhsmVars

--reg-org [REG_ORG]

登録に使用する組織。

RhsmVars

--reg-force

すでに登録済みでもシステムを登録する場合は、このオプションを使用します。

RhsmVars

--reg-sat-url [REG_SAT_URL]

オーバークラウドノードを登録する Satellite サーバーのベース URL。このパラメーターには、HTTPS URL ではなく、Satellite の HTTP URL を使用します。たとえば、https://satellite.example.com ではなく http://satellite.example.com を使用します。オーバークラウドの作成プロセスではこの URL を使用して、どのサーバーが Red Hat Satellite 5 または Red Hat Satellite 6 サーバーであるかを判断します。サーバーが Red Hat Satellite 6 サーバーの場合は、オーバークラウドは katello-ca-consumer-latest.noarch.rpm ファイルを取得して subscription-manager に登録し、katello-agent をインストールします。サーバーが Red Hat Satellite 5 サーバーの場合にはオーバークラウドは RHN-ORG-TRUSTED-SSL-CERT ファイルを取得して rhnreg_ks に登録します。

RhsmVars

--reg-activation-key [REG_ACTIVATION_KEY]

登録に使用するアクティベーションキーを定義する場合は、このオプションを使用します。

RhsmVars

$HOME/tripleo-deploy/undercloud

tripleo deploy に基づく undercloud install

$HOME/tripleo-deploy/<stack>

tripleo deploy、<stack> はデフォルトでは standalone です

$HOME/overcloud-deploy/<stack>

overcloud deploy、<stack> はデフォルトで overcloud です。

cli-*`

ansible-runner が CLI ansible ベースのワークフローに使用するディレクトリー。

cli-config-download
cli-enable-ssh-admin
cli-grant-local-access
cli-undercloud-get-horizon-url

config-download

config-download ディレクトリー。以前の Red Hat OpenStack Platform (RHOSP) リリースでは、このディレクトリーの名前は ~/config-download または /var/lib/mistral/<stack> でした。

environment

openstack stack environment show <stack> コマンドで生成された保存済みスタック環境が含まれています。

heat-launcher

一時的な Heat 設定とデータベースのバックアップを含む一時的な Heat 作業ディレクトリー。

outputs

openstack stack output show <stack> <output> コマンドで生成された保存済みスタック出力が含まれます。

<stack>-deployment_status.yaml

保存されたスタックステータスが含まれます。overcloud がスタックの名前である場合、このファイルの名前は overcloud-deployment_status.yaml です。

<stack>-export.yaml

openstack overcloud export --stack <stack> コマンドで生成されたスタックのエクスポート情報が含まれます。overcloud がスタックの名前である場合、このファイルの名前は overcloud-export.yaml です。

<stack>-install-*.tar.bzip2

作業ディレクトリーの tarball (例: overcloud-install-20220823213643.tar.bzip2)。

<stack>-passwords.yaml

スタックのパスワードが含まれています。overcloud がスタックの名前である場合、このファイルの名前は overcloud-passwords.yaml です。

<stack>rc

オーバークラウド API を使用するために必要な認証情報ファイル (例: overcloudrc)。

tempest-deployer-input.conf

Tempest 設定が含まれています。

tripleo-ansible-inventory.yaml

オーバークラウドの Ansible インベントリー。

tripleo-heat-templates

レンダリングされた jinja2 テンプレートのコピーが含まれています。ソーステンプレートは /usr/share/openstack-tripleo-heat-templates にあります。または、CLI で --templates オプションを使用してテンプレートを指定できます。

tripleo-overcloud-baremetal-deployment.yaml

オーバークラウドノードをプロビジョニングするためのベアメタルデプロイメントの入力。

tripleo-overcloud-network-data.yaml

オーバークラウドネットワークをプロビジョニングするためのネットワークデプロイメントの入力。

tripleo-overcloud-roles-data.yaml

CLI の -r オプションで指定されたロールデータ。

tripleo-overcloud-virtual-ips.yaml

オーバークラウドネットワーク VIP をプロビジョニングするための VIP デプロイメントの入力。