连接到 Red Hat OpenShift

March 18, 2026

投稿者:

创建和管理连接与资源介绍了创建连接的向导。以下信息涵盖了 Red Hat OpenShift 的具体详细信息。

注意：

在创建到 Red Hat OpenShift 的连接之前，您需要先完成 Red Hat OpenShift 的设置。请参阅Red Hat OpenShift 虚拟化环境

创建连接

您可以使用以下方式创建到 Red Hat OpenShift 群集的连接：

Web Studio
PowerShell

使用 Web Studio 创建连接

在 Web Studio 中，打开 托管 > 添加连接和资源。
在连接页面上，按照以下步骤配置连接：
1. 选择创建新连接。
2. 选择 Red Hat OpenShift 作为连接类型。
3. 在连接地址字段中，输入 OpenShift 服务器的 IP 地址、主机名或 FQDN。
4. 输入您的服务帐户令牌和易记的连接名称。
5. 在区域名称字段中选择一个区域。这些选项是您配置的所有资源位置。
6. 选择其他工具以创建虚拟机。
  
  注意：
  
  选择其他工具仅创建托管连接，而不创建托管单元。
单击下一步。
如果检测到自签名证书，将显示一个警告页面，其中包含证书指纹。要继续操作：
1. 将指纹与服务器的指纹进行比较，以验证证书的有效性。
2. 如果有效，请选择信任证书，然后单击确定以完成连接设置。
  
  该证书被标记为受信任，并且指纹将保存以供将来验证。
在范围页面上，为此主机选择一个或多个范围。
在摘要页面上，检查配置，然后单击完成。

使用 PowerShell 命令创建连接

使用 PowerShell 命令创建连接时，请提供以下信息：

托管连接名称
群集 API 地址
用户名
密码（服务帐户令牌）
SSLThumbprint：这是 CA 证书指纹，而不是 API 服务器指纹。如果您尝试创建托管连接时未指定指纹，则服务器会提供 CA 证书指纹。
ZoneUid

打开 PowerShell 窗口。
运行 `add-pssnapin citrix®*`。

运行以下命令以创建托管连接。

如果您尝试创建托管连接时未指定指纹，则服务器会提供 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
<!--NeedCopy-->

创建托管单元

托管单元表示创建虚拟机的环境。要创建托管单元，您需要 OpenShift 提供以下输入：

命名空间
StorageClasses
网络附加定义

托管单元是命名空间绑定的。这意味着一个托管单元只能访问一个命名空间，并管理该命名空间下的虚拟机。

您可以使用以下方式创建托管单元：

Web Studio
PowerShell

使用 Web Studio 创建托管单元

导航到托管 > 添加连接和资源。
在连接页面上：
- 要创建新的托管连接以及托管单元，请选择创建新连接，然后执行以下操作：
  1. 选择 Red Hat OpenShift 作为连接类型。
  2. 在连接地址字段中，输入 OpenShift 服务器的 IP 地址、主机名或 FQDN。
  3. 输入您的服务帐户令牌和易记的连接名称。
  4. 在区域名称字段中选择一个区域。这些选项是您配置的所有资源位置。
  5. 选择 Citrix 预配工具（Machine Creation Services™ 或 Citrix Provisioning）以创建虚拟机。
  6. 单击下一步。
  7. 在警告页面上，验证证书的有效性，然后选择信任证书。
- 要从现有主机连接创建托管单元，请选择使用现有连接，然后选择相关连接。
在命名空间选择页面上，为此连接选择一个命名空间。
在存储选择页面上，为每种支持的数据类型选择至少一个存储设备，然后才能继续向导中的下一页。有关存储选择的详细信息，请参阅主机存储。
在网络页面上，输入资源的名称。此名称将显示在 Studio 中，用于标识与连接关联的存储和网络组合。选择虚拟机使用的一个或多个网络。
在摘要页面上，检查详细信息，然后单击完成。

使用 PowerShell 创建托管单元

使用 PowerShell 命令创建托管单元时，请提供以下信息：

托管连接名称
托管单元名称
目标命名空间名称
存储类名称
网络附加定义名称

打开 PowerShell 窗口。
运行 `add-pssnapin citrix*`。

运行 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")
<!--NeedCopy-->

后续步骤

如果您处于初始部署过程中，请参阅创建计算机目录
有关 Red Hat OpenShift 的具体信息，请参阅创建 Red Hat OpenShift 目录