Nutanix AHV (Acropolis )
Nutanix AHV コネクタ構成には、アプライアンスがNutanix Acropolisに接続するために必要な資格情報とストレージコンテナが含まれています。
次の場合、このコネクタ構成を使用して、Nutanix 環境の特定の場所にアクセスできます。
- OS レイヤーを作成するために、クリーンな OS イメージをインポートします。
- プラットフォームレイヤーまたはアプリレイヤーの作成の一部として、または Layer へのバージョン追加の一部として Layer をパッケージ化します。
- レイヤー化された画像を Nutanix に公開します。
はじめに
Nutanix Acropolis 環境を使用して、レイヤーの作成やレイヤー画像の公開を行うことができます。各コネクタ構成は、Nutanix Acropolis 環境内の特定のストレージコンテナーにアクセスします。このコンテナーでは、レイヤーを作成したり、レイヤー画像を公開したりできます。
各目的に合わせて正しいコンテナにアクセスするために、複数の Nutanix Acropolis コネクタ設定が必要な場合があります。さらに、各レイヤードイメージを、公開イメージを使用してProvisioning するシステムに便利なコンテナに公開することが重要です。コネクタとコネクタ構成の詳細については、「 コネクタ構成」を参照してください。
Nutanix Prism要素コンソールの指定
App Layering は Prism Elements ウェブコンソールを使用し、Prism Central コンソールをサポートしていません 。
重要:
Nutanix コネクタを使用する場合、App Layering が正しく動作するためには、ホストへの NFS 直接アクセスが必要です。古いバージョンの Nutanix AHV (5.6 および 5.7) では、Prism Element ホストまたはクラスターが Prism Central に登録されている場合、ホストへのこの直接の NFS アクセスは許可されませんでした。Nutanix のセットアップでこのアクセスを許可していることを確認してください。さまざまな Nutanix バージョンでのこの問題の詳細については、「Nutanix でレイヤーバージョンを追加するとエラーで失敗する:スクリプトの実行に失敗しました」を参照してください。
Nutanix コネクタを構成するときは、Prism Elements コンソールの URL を必ず入力してください。
コネクタに Prism Central が指定されている場合に表示されるエラー
コネクタ構成で Prism Central が使用されている場合は、「内部エラー 500」というエラーが表示されます。」
Citrix App LayeringアプライアンスをNutanix許可リストに追加します
必要に応じて、適切なストレージコンテナにアクセスできるように、アプライアンスが Nutanix 許可リストに追加されていることを確認します。これは、ファイルシステムレベルおよびコンテナレベルの許可リスト設定を構成することで実現できます。Nutanix で許可リストを追加する方法については、Nutanix のマニュアルを参照してください。
Acropolis コネクタの構成設定に必要な情報
Nutanix Connector構成では、新しい構成に使用する認証情報とコンテナを定義できます。
重要:
フィールドでは大文字と小文字が区別されるため、手動で入力する値は Nutanix のオブジェクトの大文字と小文字と一致する必要があります。一致しない場合、検証は失敗します。
- コネクタ構成名 -このコネクタ構成を識別するのに役立つ便利な名前です。
- Web コンソール (Prism) アドレス -Prism Web コンソールのホスト名 (DNS 経由で解決可能) または IP アドレス。このアドレスは、Nutanix Prism Web コンソールへのアクセスに使用するアドレスと同じです。
-
ユーザー名/パスワード -Nutanix システムとの対話時に使用される資格情報。指定したユーザーには、次の操作を実行するための十分な権限が必要です。
- VMの操作：
- 複製
- 削除
- 電源オン/オフ
- 仮想ディスクの接続
- イメージ操作：
- 作成
- 更新（別名アップロード）
- 削除
- 仮想ディスク：
- 作成
- 仮想マシンへの接続
- VMの操作：
-
証明書エラーを無視する -コネクタと Nutanix Acropolis 間の API 接続トラフィックに SSL 暗号化を使用できます。このフィールドは、デフォルトではクリアされています。
-
仮想マシンテンプレート（推奨） -メモリ、CPU、ビデオ設定など、Nutanix のハードウェア設定で仮想マシンのクローンを作成するために使用できる仮想マシンテンプレート。生成される VM を構成するためのホスト、データストア、ネットワークを指定できます。Nutanixには「テンプレート」という概念がないため、これらの「テンプレート」は実際のVMです。選択した「テンプレート」で使用する OS のバージョンは、レイヤーの構築またはレイヤー画像の公開に使用する OS のバージョンと一致する必要があります。 テンプレートにはディスクが接続されておらず 、少なくとも 1 つのネットワークカードが取り付けられている必要があります。そうでない場合は、設定の検証または保存を試行するときにエラーが表示されます。
-
ストレージコンテナ -アップロードされるイメージ（仮想ディスク、VHD）のストレージコンテナと、それらのイメージから作成される仮想ディスクを選択できます。アプリレイヤーと OS レイヤーのバージョンを作成するときは、ストレージコンテナを NFS マウントポイントとしてマウントします。
Nutanix ウェブコンソールまたは Nutanix CLI ツールを使用して許可リストを構成します。許可リストをクラスターに設定し、使用していないストレージコンテナも含め、クラスター上の各ストレージコンテナに許可リストを設定します。
注： 選択したストレージコンテナに対してアプライアンスが許可リストされていない場合、検証フェーズは失敗し、ストレージコンテナの選択にエラーが示されます。
- レイヤーディスクキャッシュサイズ (GB) (オプション) -各レイヤーに許可されるキャッシュのサイズを指定します。
仮想マシンの整理方法
Nutanix は、仮想マシンを整理するためのメカニズムを提供していません。このため、仮想マシンの総数が多い場合、アプライアンスによって作成された仮想マシンを見つけるのが難しい場合があります。これらの VM を検索しやすくするために、次の命名規則が使用されます。
-
パッケージマシン （アプリケーションレイヤーまたは OS バージョンの作成中に作成された仮想マシン）
- 仮想マシン名は、作成/変更するレイヤー名で始まります
- 仮想マシン名は、次のテキストで終わります:(マシンのパッケージ化)
-
レイヤードイメージ仮想マシン (レイヤードイメージの公開の結果として作成された仮想マシン)
- 仮想マシン名は、公開されたイメージ名から始まります
- 仮想マシン名は、次のテキストで終わります:(公開イメージ)
Nutanix Web コンソールで仮想マシンを表示する場合、次のフィルタで仮想マシンを検索できます。
- 「Citrix App Layering」を使用して、App Layeringサービスによって作成されたすべての仮想マシンを検索します。
- 「Citrix App Layering Packaging Machine」を使用して、レイヤー管理ジョブ用に作成されたすべての仮想マシンを検索します。
- 「Citrix App Layering 公開イメージ」を使用して、レイヤー化イメージを公開するために作成されたすべての仮想マシンを検索します。
- 特定のレイヤー化されたイメージ公開ジョブまたはアプリケーションまたはOSの作成に関連する仮想マシンを検索するためのイメージ名またはレイヤー名。
仮想マシンのネットワーク接続
Nutanix AHV コネクタ構成で指定されたソーステンプレートの仮想ネットワーク設定は、Nutanix Acropolis Hypervisor (AHV) コネクタを介して仮想マシンを作成するときに引き継がれます。Connector Configuration UI には、ネットワーク設定を上書きするオプションはありません。
コネクタ構成の作成
値を入力する手順は、次のとおりです。
- 最初の 3 つの [コネクタ] フィールドは手動で入力する必要があります。これらのフィールドの認証情報が検証されると、ドロップダウンメニューから残りのフィールドの値を選択できます。
- 値を手動で入力するには、クリックしてフィールドにカーソルを置き、大文字と小文字がAcropolis の値と一致していることを確認します。
- ドロップダウンリストから値を選択するには、1 回クリックしてフィールドにカーソルを置き、2 回目をクリックして使用可能な値のリストを表示します。
コネクタ構成を追加するには
- 管理コンソールに管理者としてログインします。
- [ コネクタ] > [コネクタ構成の追加]を選択します。
- [ コネクタタイプ ] ドロップダウンメニューから [ Nutanix ] を選択し、[ 新規作成] をクリックします。これにより、コネクタ構成が開きます。
- 設定名、Acropolis アドレス、ユーザー名、パスワードを入力します。ガイダンスについては、上記のフィールド定義を参照してください。
- Acropolis 設定フィールドの下にある [ 認証情報の確認 ] ボタンをクリックします。仮想マシンのクローン設定フィールドが有効になります。
- 仮想マシンテンプレートを選択します。
- ストレージリポジトリを選択し、[ テスト ] ボタンをクリックして、指定された認証情報を使用して指定されたコンテナにアプライアンスがアクセスできることを確認します。
- ［保存］ をクリックします。新しいコネクタ構成が [ コネクタ ] ページにリストされていることを確認します。
スクリプト設定（拡張機能、オプション）
新しいコネクタ構成を作成するときに、App Layering Agent を実行する任意の Windows マシンで実行するように、オプションの Powershell スクリプトを構成できます。これらのスクリプトは、エージェントがインストールされているマシンと同じマシンに格納する必要があります。このマシンは、階層化イメージの展開が成功した後にのみ実行されます。
いくつかのプリセット変数は、異なるテンプレートイメージおよび異なるコネクタ構成でスクリプトを再利用できるようにするために使用できます。これらの変数には、Acropolis 公開レイヤー画像の一部として作成された仮想マシンを識別するために必要な情報も含まれています。
これらのスクリプトを実行しても、パブリッシュジョブの結果には影響しません。また、スクリプトで実行されたコマンドの進行状況も表示されません。Acropolis コネクタのログには、実行されたスクリプトの出力が含まれます。
スクリプトの設定 (オプション)
レイヤイメージが公開されるたびにスクリプトを実行する場合は、次のセクションで説明する値を使用して次の手順を実行します。
- 上記の説明に従って、コネクタ設定を完了して保存します。
注:
[スクリプト構成] ページを選択する前に、コネクタ構成設定に対する編集内容をすべて保存 (または破棄) する必要があります。
- 左側の [ナビゲーション] メニューが開いていない場合は、そのメニューを選択し、[ スクリプト設定 ] をクリックして [スクリプトパス] ページを開きます。
- ここで説明する値を使用して必須フィールドに入力し、[保存] をクリックします。
スクリプト設定フィールド
- スクリプトを有効にする-残りのフィールドを有効にするには、このチェックボックスをオンにします。これにより、レイヤー化されたイメージが公開されるたびに実行されるスクリプトを入力できます。
- Script Agent-スクリプトが配置され、実行されるエージェントマシンです。
- Username（オプション）-スクリプトの実行時に偽装するユーザー名。これは、スクリプト内の操作を実行するために必要な権限/権限を持つユーザーのコンテキストでスクリプトを確実に実行するために使用できます。
- Password (オプション)-指定したユーザー名のパスワード。
- スクリプトパス：スクリプトファイルが存在するエージェントマシン上のフルパスとファイル名。
その他のスクリプト設定値
スクリプトが実行されると、次の変数が設定され、powershellスクリプトで使用できます。
| 値 | コネクタタイプに適用: | どのコードによって決定される値： | 説明 |
|---|---|---|---|
| connectorCfgName | 共通 | 共通 | これは、スクリプト構成が関連付けられているコネクタ構成の名前です。 |
| imageName | 共通 | 共通 | これは、レイヤードイメージの構築/公開に使用されたレイヤードイメージテンプレートの名前です。 |
| osType | 共通 | 共通 | これは、公開されたレイヤードイメージの OS タイプです。次の値のいずれかになります。 Windows10; Windows1064; Windows7 64ビット; Windows7 64ビット; Windows2016 64ビット; Windows2012 64ビット; Windows2008 64ビット |
| virtualInfrastructureServer | 共通 | Nutanix AHV | コネクタ構成で指定された Nutanix AHV (Prism Server)。 |
| vmId | 共通 | Nutanix AHV | 仮想マシンの UUID（VMUUID と同じ）。 |
| vmName | 共通 | Nutanix AHV | 作成された仮想マシンの名前。 |
| VMネットワーク | 共通 | Nutanix AHV | 仮想マシンのメイン NIC が接続されている仮想ネットワークの名前。 |
| VMNetworkID | 共通 | Nutanix AHV | 仮想マシンのメイン NIC が接続されている仮想ネットワークの UUID。 |
| vmNetworkMAC | 共通 | Nutanix AHV | VMNetwork および VMNetworkID で指定された仮想ネットワークに接続されているメイン NIC の MAC アドレス。 |
| vmUuid | 共通 | Nutanix AHV | 仮想マシンの UUID（VMID と同じ）。 |
仮想マシンの UUID（VMID と同じ）。
定義スコープ -スクリプト変数をすべてのコネクタタイプに設定するか、または特定のコネクタタイプに固有かどうかを定義します。
Value Source -変数の値が共通コードまたはコネクタ固有のコードによって決定されるかどうかを定義します。