Red Hat OpenShiftへの接続

最終公開日 : Oct 24, 2026
接続とリソースの作成および管理では、接続を作成するウィザードについて説明しています。以下の情報は、Red Hat OpenShiftに固有の詳細を扱っています。
注:
Red Hat OpenShiftへの接続を作成する前に、まずRed Hat OpenShiftのセットアップを完了する必要があります。Red Hat OpenShift仮想化環境を参照してください。

接続を作成する

Red Hat OpenShiftクラスターへの接続は、以下を使用して作成できます。

Studioを使用して接続を作成する

  1. ホスティング > 接続とリソースの追加に移動します。
  2. 接続ページで、以下の手順に従って接続を構成します。
    1. 新しい接続を作成を選択します。
    2. 接続の種類としてRed Hat OpenShiftを選択します。
    3. 接続アドレスフィールドに、OpenShiftサーバーのIPアドレス、ホスト名、またはFQDNを入力します。
    4. サービスアカウントトークンとわかりやすい接続名を入力します。
    5. 「ゾーン名」フィールドでゾーンを選択します。オプションは、構成したすべてのリソースの場所です。
    6. 仮想マシンを作成するには、「その他のツール」を選択します。
      注:
      「その他のツール」を選択すると、ホスティングユニットなしでホスティング接続のみが作成されます。
  3. 「次へ」をクリックします。
  4. 自己署名証明書が検出された場合、証明書のサムプリントを含む警告ページが表示されます。続行するには:
    1. サムプリントをサーバーのものと比較して、証明書の有効性を確認します。
    2. 有効な場合は、「証明書を信頼する」を選択し、「OK」をクリックして接続設定を完了します。
      証明書は信頼済みとしてマークされ、サムプリントは今後の検証のために保存されます。
  5. 「スコープ」ページで、このホストのスコープを1つ以上選択します。
  6. 「概要」ページで、構成を確認し、「完了」をクリックします。

PowerShellコマンドを使用した接続の作成

PowerShellコマンドを使用して接続を作成する場合、次の情報を提供します。
  • ホスティング接続名
  • クラスターAPIアドレス
  • ユーザー名
  • パスワード(サービスアカウントトークン)
  • SSLサムプリント: これはCA証明書のサムプリントであり、APIサーバーのサムプリントではありません。サムプリントを指定せずにホスティング接続を作成しようとすると、サーバーがCA証明書のサムプリントを提供します。
  • ゾーンUID
  1. PowerShellウィンドウを開きます。
  2. add-pssnapin citrix*を実行します。
  3. ホスティング接続を作成するには、次のコマンドを実行します。
    サムプリントを指定せずにホスティング接続を作成しようとすると、サーバーがCA証明書のサムプリントを提供します。例:
    $newItemParameters = @{
    ConnectionType= "Custom"
    PluginId= "OpenShiftPluginFactory"
    HypervisorAddress = "https://api.myopenshiftclusteraddress.mydomain.local:6443"
    Path= "XDHyp:\Connections\OpenShiftConnectionName"
    Persist= $true
    UserName= "__ServiceAccount__"
    Password= "<service account token>"
    ErrorVariable= "connectionError"
     }

    & New-Item @newItemParameters


    $newItemParameters["SSLThumbprint"] = $connectionError[0].ErrorData.Thumbprint
    $connection = & New-Item @newItemParameters
    $brokerConnection = New-BrokerHypervisorConnection -HypHypervisorConnectionUid $connection.HypervisorConnectionUid

ホスティングユニットを作成する

ホスティングユニットは、VMが作成される環境を表します。ホスティングユニットを作成するには、OpenShiftから次の入力が必要です。
  • 名前空間
  • ストレージクラス
  • ネットワークアタッチメント定義
ホスティングユニットは名前空間にバインドされます。これは、1つのホスティングユニットが1つの名前空間のみにアクセスでき、その名前空間下のVMを管理することを意味します。
ホスティングユニットは、次の方法で作成できます。

Studio を使用してホスティングユニットを作成する

  1. Hosting > Add Connection and Resources に移動します。
  2. Connection ページで:
    • ホスティングユニットとともに新しいホスティング接続を作成するには、Create a new connection を選択し、次の手順を実行します:
      1. 接続の種類として Red Hat OpenShift を選択します。
      2. Connection address フィールドに、OpenShiftサーバーのIPアドレス、ホスト名、またはFQDNを入力します。
      3. サービスアカウントトークンと、わかりやすい接続名を入力します。
      4. Zone name フィールドでゾーンを選択します。オプションは、構成したすべてのリソースの場所です。
      5. 仮想マシンを作成するための Citrix provisioning tools (Machine Creation Services™ or Citrix Provisioning) を選択します。
      6. Next をクリックします。
      7. Warning ページで、証明書の有効性を確認し、Trust certificate を選択します。
    • 既存のホスト接続からホスティングユニットを作成するには、Use an existing Connection を選択し、その後、関連する接続を選択します。
  3. Namespace Selection ページで、この接続の名前空間を選択します。
  4. ストレージの選択ページで、ウィザードの次のページに進む前に、サポートされているデータ型ごとに少なくとも1つのストレージデバイスを選択します。ストレージの選択について詳しくは、「ホストストレージ」を参照してください。
  5. ネットワークページで、リソースの名前を入力します。この名前は、接続に関連付けられているストレージとネットワークの組み合わせを識別するためにStudioに表示されます。VMが使用するネットワークを1つ以上選択します。
  6. 概要ページで詳細を確認し、完了をクリックします。

PowerShellを使用してホスティングユニットを作成する

PowerShellコマンドを使用してホスティングユニットを作成する場合は、次の情報を提供します。
  • ホスティング接続名
  • ホスティングユニット名
  • ターゲットの名前空間名
  • StorageClasses 名
  • NetworkAttachmentDefinition 名
  1. PowerShellウィンドウを開きます。
  2. add-pssnapin citrix*を実行します。
  3. PowerShellコマンドを実行して、ホスティングユニットを作成します。例:
    $HostingConnectionName = "OpenShiftConnectionName"
    $HostingUnitName = "HostingUnitName"
    $TargetNamespace = "TargetNamespaceName"
    $StorageClassToUse = "YourStorageClassesName"
    $NetworkAttachmentDefinition = "YourNetworkAttachmentDefinitionName"
    New-HypStorage `
    -StoragePath @("XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace\$StorageClassToUse.storage") `
    -StorageType "TemporaryStorage"
    New-Item `
    -CustomProperties "" `
    -HypervisorConnectionName $HostingConnectionName `
    -NetworkPath @("XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace\$NetworkAttachmentDefinition.network") `
    -Path @("XDHyp:\HostingUnits\$HostingUnitName") -RootPath "XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace" `
    -StoragePath @("XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace\$StorageClassToUse.storage")

次の手順

詳細情報