Nutanix AHV (Acropolis)

Nutanix AHV 连接器配置包含设备连接到 Nutanix Acropolis 所需的凭据和存储容器。

在以下情况下，您可以使用此连接器配置访问 Nutanix 环境中的特定位置：

• 导入干净的操作系统映像以创建操作系统层。
• 将层打包为创建平台或应用程序层的一部分，或者作为向层添加版本的一部分。
• 将分层图像发布到 Nutanix.

开始之前的准备工作

您可以使用Nutanix卫城环境创建层和发布分层图像。每个连接器配置都会访问 Nutanix Acropolis 环境中的特定存储容器，您可以在其中创建层或发布分层图像。

您可能需要多个 Nutanix Acropolis 连接器配置来访问适合每个用途的正确容器。此外，务必将每个分层映像发布到一个容器，方便您使用已发布映像 Provisioning 的系统。有关连接器和连接器配置的详细信息，请参阅连接器配置。

指定 Nutanix Prism Elements 控制台

App Layering 使用 Prism Elements Web 控制台，不支持 Prism Central 控制台。

重要提示：

使用 Nutanix 连接器时，App Layering 需要直接对主机进行 NFS 访问才能正常工作。在旧版本的 Nutanix AHV（5.6 和 5.7）中，如果 Prism Element 主机或群集在 Prism Central 注册，则不允许这种直接 NFS 访问主机。确保 Nutanix 设置允许此访问权限。有关各种 Nutanix 版本中此问题的详细信息，请参阅使用 Nutanix 添加层版本失败并显示错误：无法执行脚本

配置 Nutanix 连接器时，请务必输入 Prism 元素控制台的URL。

如果连接器中指定了棱镜中央，则收到错误

如果在连接器配置中使用棱镜中央，您会收到错误， “内部错误 500。 “

将 Citrix App Layering 设备添加到 Nutanix 允许列表

确保已将设备添加到 Nutanix 允许列表中，以便它可以根据需要访问相应的存储容器。这可以通过配置文件系统和容器级允许列表设置来实现。有关在 Nutanix 中添加允许列表的详细信息，请参阅 Nutanix 文档。

Acropolis 连接器配置设置的必填信息

Nutanix 连接器配置允许您定义用于新配置的凭据和容器。

重要提示：

这些字段区分大小写，因此您手动输入的任何值都必须与 Nutanix 中对象的大小写匹配，否则验证失败。

• 连接器配置名称-有助于识别此连接器配置的有用名称。
• Web 控制台（Prism）地址-Prism Web 控制台的主机名（可通过 DNS 解析）或 IP 地址。此地址与您用于访问 Nutanix 棱镜 Web 控制台的地址相同。
• 用户名/密码-与 Nutanix 系统交互时使用的凭据。指定用户必须具有足够的权限才能执行以下操作：
  • VM 操作：
    • 克隆
    • delete
    • 开机/关机
    • 连接虚拟磁盘
  • 映像操作：
    • create
    • 更新（亦称为上载）
    • delete
  • 虚拟磁盘：
    • 创建
    • 连接到 VM

• 忽略证书错误-允许您对连接器与 Nutanix Acropolis之间的 API 连接流量使用 SSL 加密。默认情况下，此字段处于清除状态。

• 虚拟机模板（推荐）-可用于使用 Nutanix 硬件设置（包括内存、CPU 和视频设置）克隆虚拟机的虚拟机模板。您可以指定用于配置生成的 VM 的主机、数据存储和网络。由于 Nutanix 中没有 “模板”的概念，这些 “模板”是实际的虚拟机。选定的 “模板” 使用的操作系统版本必须与您用于构建层或发布分层图像的操作系统版本匹配。模板不得连接有任何磁盘，且必须至少连接了一个网卡。如果没有，则在尝试验证或保存配置时看到错误。

• 存储容器-允许您为上传的映像（虚拟磁盘、vHD）选择存储容器，以及从这些映像创建的生成的虚拟磁盘。创建应用程序层和操作系统层版本时，将存储容器装载为 NFS 挂载点。

  使用 Nutanix Web 控制台或 Nutanix CLI 工具配置允许列表。将允许列表设置为群集以及群集上的每个存储容器，甚至是您未使用的存储容器。

  注意：如果选定存储容器不允许列出设备，则验证阶段将失败，并在选择存储容器时显示错误。

• 以GB 为单位的层磁盘缓存大小（可选）-指定每个层允许的缓存大小。

虚拟机的组织方式

Nutanix 不提供用于组织虚拟机的机制。因此，当虚拟机总数很大时，可能很难找到设备创建的虚拟机。为帮助您找到这些 VM，请使用以下命名约定：

• 打包计算机（在创建应用程序层或操作系统层的过程中创建的虚拟机）
  • 虚拟机名称以所创建/修改的层名称
  • 虚拟机名称以下文本结尾：（打包计算机）
• 分层映像虚拟机（因发布分层映像而创建的虚拟机）
  • 虚拟机名称以发布的映像名称开头
  • 虚拟机名称以下文本结尾：（已发布图像）

通过 Nutanix Web 控制台查看虚拟机时，可以通过对以下产品进行过滤来搜索虚拟机：

• “Citrix应用程序分层”,以查找由应用程序分层服务创建的所有虚拟机。
• “Citrix App Layering 打包计算机”，以查找为层管理作业创建的所有虚拟机。
• “Citrix App Layering 已发布的映像”，以查找用于发布分层映像所创建的所有虚拟机。
• 用于查找在发布作业或创建应用程序或操作系统时与特定分层映像有关的虚拟机的映像名称或层名称。

虚拟机网络连接

通过 Nutanix Acropolis Hypervisor (AHV) 连接器创建任何 VM 时，将继续使用在 Nutanix AHV 连接器配置中指定的源模板的虚拟网络设置。连接器配置 UI 中没有用于覆盖网络设置的选项。

创建连接器配置

要输入值，请执行以下操作：

• 必须手动输入前三个连接器字段。验证这些字段中的凭据后，您可以从下拉菜单中为其余字段选择值。
• 要手动输入值，请单击将光标放在字段中并键入值，确保大小写与 Acropolis 中的值匹配。
• 要从下拉列表中选择一个值，请单击一次以将光标放入字段中，然后再单击一次以显示可能的值的列表。

添加连接器配置

1. 以管理员身份登录到管理控制台。
2. 选择“连接器”>“添加连接器”配置。
3. 从连接器类型下拉菜单中选择Nutanix，然后单击新建。这将打开连接器配置。
4. 输入配置名称、雅典卫城地址、用户名和密码。有关指导，请参阅上述字段定义。
5. 单击 Acropolis 配置字段下方的检查凭据按钮。然后启用“Virtual Machine Clone Settings”（虚拟机克隆设置）字段。
6. 选择“虚拟机模板”。
7. 选择存储库，然后单击测试按钮以验证设备是否可以使用提供的凭据访问指定的容器。
8. 单击保存。验证连接器页面上是否列出了新的连接器配置。

脚本配置（高级功能，可选）

创建新的连接器配置时，可以配置可选的 Powershell 脚本，以便在运行 App Layering 代理的任何 Windows 计算机上运行。这些脚本必须存储在安装代理的同一台计算机上，并且只有在成功部署分层映像后才能运行。

通过某些预设变量，可以使用不同的模板映像和不同的连接器配置来重复使用脚本。这些变量还将包含识别作为 Acropolis 已发布的分层映像的一部分而创建的虚拟机所需的信息。

执行这些脚本将不影响发布作业的结果，并且在脚本中执行的命令的进度将不可见。Acropolis 连接器日志将包含已执行脚本的输出。

配置脚本（可选）

如果要在每次发布分层映像时运行脚本，请使用后续部分中所述的值来完成以下步骤。

1. 按照如上所述完成并保存连接器配置。

   注意：

   在选择 “脚本配置” 页面之前，必须保存（或放弃）对连接器配置设置的所有编辑，

2. 如果左侧的导航菜单未打开，请选择该菜单，然后单击 “ 脚本配置 ”以打开 “脚本路径”页面。
3. 使用此处详细说明的值填写必填字段，然后单击保存。

脚本配置字段

• 启用脚本- 选中此复选框可启用剩余字段。使用此选项，您可以输入在每次发布分层映像时将执行的脚本。
• 脚本代理-将在其中找到和执行脚本的代理计算机。
• 用户名（可选）-运行脚本时要模拟的用户名。这样可用于确保脚本在用户具有在脚本中执行相关操作所需的权限的上下文中运行。
• 密码(可选)- 指定用户名的密码。
• 脚本路径-脚本文件所在的代理计算机上的完整路径和文件名。

其他脚本配置值

执行脚本后，将设置以下变量且可以在 powershell 脚本使用这些变量：

值	应用于连接类型：	决定值的节点：	说明
connectorCfgName	通用	通用	这是脚本配置与其关联的连接器配置的名称。
imageName	通用	通用	这是用于构建/发布分层映像的分层映射模板的名称。
osType	通用	通用	这是已发布的分层映像的操作系统类型。它可以是以下值之一： Windows 10；Windows1064；Windows7；Windows7 64 位；Windows 2016 64 位；Windows2012 64 位；Windows 2008 64 位
virtualInfrastructureServer	通用	Nutanix AHV	在连接器配置中指定的 Nutanix AHV（Prism 服务器）。
vmId	通用	Nutanix AHV	虚拟机 UUID（与 vmUuid 相同）。
vmName	通用	Nutanix AHV	已创建的虚拟机的名称。
vmNetwork	通用	Nutanix AHV	虚拟机的主要 NIC 连接到的虚拟网络的名称。
vmNetworkId	通用	Nutanix AHV	虚拟机的主要 NIC 连接到的虚拟网络的 UUID。
vmNetworkMAC	通用	Nutanix AHV	连接到在 vmNetwork 和 vmNetworkId 中指定的虚拟网络的主要 NIC 的 MAC 地址。
vmUuid	通用	Nutanix AHV	虚拟机 UUID（与 vmId 相同）。

虚拟机 UUID（与 vmId 相同）。

定义作用域- 定义是否为所有连接器类型设置了脚本变量或脚本变量是否特定于特定的连接器类型。

值源- 定义变量值是否由常见代码或由特定于连接器的代码决定。