Citrix DaaS

将工作负载迁移到公有云

Image Portability Service 简化了跨平台管理映像的过程。此功能对于管理本地资源位置与公有云中的资源位置之间的映像非常有用。Citrix Virtual Apps and Desktops REST API 可用于自动管理 Citrix Virtual Apps and Desktops 站点中的资源。

使用 Citrix Cloud 开始将映像从本地位置迁移到您的公有云订阅时,Image Portability 工作流便会启动。准备好映像后,Image Portability Service 可帮助您将映像转移到公有云订阅并准备运行。最后,Citrix Provisioning 或 Machine Creation Services 会在公有云订阅中预配映像。

组件

Image Portability Service 组件包括:

  • Citrix Cloud 服务
  • Citrix Credential Wallet
  • Citrix Connector 设备
  • Compositing Engine VM
  • PowerShell 示例脚本

Citrix Cloud 服务

Citrix Cloud 服务 API 是一项 REST API 服务,可与 Image Portability Service 进行交互。使用 REST API 服务,您可以创建和监视 Image Portability 作业。例如,您调用 API 来启动 Image Portability 作业(例如导出磁盘),然后调用以获取任务的状态。

Citrix Credential Wallet

Citrix Credentials Wallet 服务可以安全地管理系统凭据,从而允许 Image Portability Service 与您的资产进行交互。例如,将磁盘从 vSphere 导出到 SMB 共享时,Image Portability Service 服务需要凭据才能打开与 SMB 共享的连接以写入磁盘。如果凭据存储在 Credential Wallet 中,则 Image Portability Service 可以检索和使用这些凭据。

此服务使您能够完全管理您的凭据。云服务 API 充当接入点,使您能够创建、更新和删除凭据。

Compositing Engine

Compositing Engine 是 Image Portability Service 的主力。Compositing Engine (CE) 是在 Image Portability 导出或准备作业开始时创建的单个 VM。这些 VM 是在执行作业的同一环境中创建的。例如,从 vSphere 导出磁盘时,将在 vSphere 服务器上创建 CE。同样,在 Azure 或 Google Cloud 中运行准备作业时,CE 将分别在 Azure 或 Google 中创建。CE 会将您的磁盘装载到自身,然后对磁盘进行必要的操作。完成准备或导出作业后,CE VM 及其所有组件都将被删除。

连接器设备

运行提供程序软件以管理 IPS 资源的连接器设备在您的环境(本地和 Azure 或 Google Cloud 订阅中)中运行,并充当单个作业的控制器。它接收来自云服务的作业指令,并创建和管理 Compositing Engine VM。连接器设备 VM 充当云服务与您的环境之间的单个安全通信点。请在您的每个资源位置(本地、Azure 或 Google Cloud)中部署一个或多个连接器设备。为了安全起见,每个资源位置都部署了连接器设备。通过将连接器设备和 Compositing Engine 放置在同一位置,部署的安全状况将大大提高,因为所有组件和通信都保存在您的资源位置内。

PowerShell 模块

我们提供了一组在脚本中使用的 PowerShell 模块,作为开发您自己的自定义自动化的起点。提供的模块按原样受支持,但如果部署有需要,您可以对其进行修改。

PowerShell 自动化使用提供的配置参数编写对 Citrix Cloud API 服务的 REST 调用以启动作业,然后随着作业的进展为您提供定期更新。

如果您想开发自己的自动化解决方案,则可以使用首选的编程语言直接调用云服务。有关配置和使用 Image Portability Service REST 端点和 PowerShell 模块的详细信息,请参阅 API 门户。

工作流

Image Portability Service 使用多阶段工作流从本地资源位置为您的公有云订阅准备主目录映像。该服务将从本地虚拟机管理程序平台导出映像,然后将其上载到公有云订阅(我们提供的 PowerShell 上载实用程序可以帮助实现此操作的自动化)。然后,Image Portability 会准备映像,使其与您的公有云平台兼容。最后,映像将发布并准备作为您的云资源位置中的新计算机目录进行部署。

Image Portability 工作流

这些高级工作流基于映像的源和目标预配配置(计算机创建或 Citrix Provisioning)。所选工作流决定了需要执行哪些 Image Portability 作业步骤。

请参见下表,了解每个受支持的 IPS 工作流都需要哪些作业。

工作流(从源到目标) 导出 上载 准备 发布
MCS 到 MCS Y Y Y N
PVS 到 MCS* N Y Y N
PVS 到 Azure 上的 PVS* N Y Y Y
MCS 到 Azure 上的 PVS Y Y Y Y

*假设您拥有作为 Citrix Provisioning 虚拟磁盘的原始映像,并且不需要将其直接导出源平台虚拟机管理程序。

要求

要开始使用 Image Portability,您必须满足以下要求。

Citrix 计算机目录映像

IPS 要求使用具有下列经过测试的配置之一的映像:

  • Windows Server 2016、2019 或 2022

  • Windows 10 或 Windows 11

  • 使用 Machine Creation Services 或 Citrix Provisioning

  • 部署了与以下任一对象的本地托管连接:
    • VMware vSphere 6.7 或 7.0(适用于 MCS 版本 1912 或更高版本)
    • Citrix Provisioning 2106 或更高版本通过流技术推送到 vSphere 6.7 或 7.0
  • Citrix Virtual Apps and Desktops VDA 版本 1912 或更高版本。

  • 在 Azure 中为控制台访问启用了远程桌面服务

Citrix Connector 设备

您需要在计划使用 Image Portability 的每个资源位置安装和配置 Citrix Connector 设备。例如,如果使用 Image Portability 将映像从 vSphere 移动到 Azure 和 Google Cloud,则至少需要三台 Citrix Connector 设备:

  • 位于本地的一台或多台设备,用于与您的 vSphere 部署进行交互。
  • Azure 订阅中的一台或多台设备。
  • 您的 Google Cloud 订阅中的一台或多台设备。

有关详细说明,请参阅部署 Connector 设备

SMB (Windows) 文件共享

在使用 Image Portability Service 的本地资源位置托管的导出作业期间,您需要一个 Windows SMB 文件共享来临时存储数据。请确保共享上的可用空间至少是映像的文件系统所配置的大小的两倍。

一台用于运行 PowerShell 脚本的计算机

请确保运行 PowerShell 脚本的计算机具有以下对象:

  • PowerShell 版本 5.1。

  • 与 SMB 文件共享的快速网络连接。它可以是托管文件共享的同一台计算机。

  • 与计划使用 Image Portability 功能的公有云平台(例如 MS Azure 或 Google Cloud)的快速网络连接。

    有关如何从 PowerShell 库下载和配置 Image Portability 模块的详细信息,请参阅为 PowerShell 准备计算机部分。

您的 Citrix Cloud 客户 ID

确保您拥有有效的 Citrix DaaS 订阅

要继续,您需要访问 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops 服务)。如果您没有访问权限,请联系您的 Citrix 代表。

请参阅 API Getting Started(API 入门)文档,了解如何创建和配置用于 Image Portability 的 API 客户端。

Azure 所需的权限和配置

要使 Image Portability Service 在 Azure 订阅中执行操作,您需要向 Image Portability Service 使用的 Azure 服务主体授予对某些 Azure 功能的权限。有关详细列表,请参阅 Microsoft Azure 所需的权限

可以将贡献者角色分配给关联订阅中的服务主体。或者,要分配所需的最低权限,您可以使用列出的权限创建自定义角色,然后将其分配给具有正确订阅作用域的服务主体。

注意:

我们建议使用专门用于 Image Portability Service 和其他 Citrix 操作的一个或多个订阅。将所有角色分配的范围限定为这些订阅。

有关 configuring security roles for your Azure service principal(为 Azure 服务主体配置安全角色)和 creating custom roles(创建自定义角色)的信息,请参阅 Azure 文档。

Google Cloud 需要权限和配置

要使 Image Portability Service 在您的 Google Cloud 订阅中执行操作,您需要向 Image Portability Service 使用的 Google Cloud 服务主体授予某些功能的权限。

有关详细列表,请参阅 Google Cloud 所需的权限

可以使用以下角色分配这些权限:

  • 云构建编辑者
  • 计算管理员
  • 存储管理员
  • 服务帐户用户

有关配置服务帐号权限的详细信息,请参阅 Google Cloud documentation(Google Cloud 文档)。

设置 Image Portability Service

要设置 Image Portability Service,您可以:

部署连接器设备

Image Portability 要求 Citrix Connector 设备创建 Image Portability 作业。连接器设备可帮助保护与您的本地和公有云环境的交互。连接器设备的通信回传到 Image Portability Service 以报告作业状态和整体服务运行状况。

要在您的环境中部署和配置连接器设备,请按照 Connector Appliance for Cloud Services(适用于云服务的连接器设备)中的步骤进行操作。

规划部署时,请注意设备所需的 hardware configuration(硬件配置)和 network port access(网络端口访问权限)。

部署和注册设备后,将自动安装启用 Image Portability 所需的组件。

为 PowerShell 准备计算机

为了帮助您启动和运行 Image Portability,我们创建了 PowerShell 模块,您可以自定义这些模块并与该服务一起使用。

以下各部分内容介绍了如何准备计算机以运行 PowerShell 脚本。这些脚本只是几个示例。请修改或增强这些脚本以满足您的需求。

注意:

  • 我们不支持与 Image Portability Service 一起使用的任何自定义脚本。
  • 初始安装后,请使用 Update-Module 更新 PowerShell 模块。

PowerShell 要求

要使用 PowerShell 脚本,您需要满足以下条件:

  • 一台 Windows 计算机,用于运行驱动 Image Portability 作业的 PowerShell 脚本。计算机:

    • 正在运行 PowerShell 5.1 版。

    • 与本地 SMB 文件共享的网络连接速度为 10 Gb 或更高,并且可以快速连接到公有云(例如 Microsoft Azure 或 Google Cloud)。

    • 可以是托管文件共享的同一台计算机。

    • 是运行 Windows 10、Windows Server 2019 或 Windows Server 2022 的计算机,并带有最新的 Microsoft 修补程序。

    • 可以连接到 Microsoft PowerShell 库以下载所需的 PowerShell 库。

可能需要禁用 TLS 1.0/1.1 支持,具体取决于您的 Windows 版本。有关详细信息,请参阅 Microsoft PowerShell Gallery TLS 支持文档

默认情况下,PowerShell 不会通过代理服务器自动进行身份验证。请确保您已按照 Microsoft 和代理供应商最佳实践将 PowerShell 会话配置为使用代理服务器。

如果在运行涉及 PowerShellGet 缺失或旧版本的 PowerShellGet 的 PowerShell 脚本时看到错误,则需要按如下所示安装最新版本:

```
Install-Module -Name PowerShellGet -Force -Scope CurrentUser -AllowClobber
<!--NeedCopy--> ```

安装库和模块

Image Portability Service 利用 Microsoft PowerShell 库中的库来推动可移植性操作。

重要:

初始安装后,请使用 Update-Module 安装新版本。

  1. 运行以下 PowerShell 命令以下载最新模块:

    Install-Module -Name "Citrix.Workloads.Portability","Citrix.Image.Uploader" -Scope CurrentUser
    <!--NeedCopy-->
    
    • 要更改 PATH 环境变量,请执行以下操作:

      YEnter 键接受。

    • 要安装 NuGet 提供程序,请执行以下操作:

      YEnter 键接受。

    • 如果被告知库不受信任:

      A (全部)并按 Enter 键继续。

  2. 通过运行以下命令确认所有必需的模块都已下载:

    Get-InstalledModule -Name Citrix.*
    <!--NeedCopy-->
    

    此命令返回类似于以下内容的输出:

    名称 存储库 说明
    Citrix.Image.Uploader PSGallery 用于将 VHD(x) 上载到 Azure 存储帐户或 GCP 以及获取有关 VHD(x) 信息的命令
    Citrix.Workloads.Portability PSGallery 用于 Citrix Image Portability Service 的映像作业的独立 Cmdlet

将模块更新到最新版本

运行以下命令将脚本更新到最新版本。

Update-Module -Name "Citrix.Workloads.Portability","Citrix.Image.Uploader" -Force
<!--NeedCopy-->

安装 Citrix Virtual Apps and Desktops 远程 PowerShell SDK

Image Portability Service 要求 Citrix Virtual Apps and Desktops 远程 PowerShell SDK 在 Citrix Cloud 中创建和管理可移植性作业。

在您的计算机上下载并安装远程 PowerShell SDK

安装平台特定的第三方组件

VMware

如果要创建与 VMware 环境通信的 Image Portability 作业,请运行以下命令以安装所需的 VMware PowerShell 模块。

Install-Module -Name VMWare.PowerCLI -Scope CurrentUser -AllowClobber -Force -SkipPublisherCheck
<!--NeedCopy-->
Azure

如果要在 Azure 中创建 Image Portability 作业,请下载并安装 Azure 命令行实用程序,然后运行以下命令以安装所需的 Azure PowerShell 模块:

Install-Module -Name Az.Accounts -Scope CurrentUser -AllowClobber -Force
Install-Module -Name Az.Compute -Scope CurrentUser -AllowClobber -Force
<!--NeedCopy-->
Google Cloud

如果您要在 Google Cloud 中创建 Image Portability 作业,请在计算机上下载并安装 Google Cloud SDK

卸载脚本和模块

运行以下命令卸载 Image Portability 软件使用的模块。

注意:

卸载 IPS 模块时,不会自动删除第三方脚本和组件。

要卸载模块,请执行以下操作:

Get-InstalledModule -Name "Citrix.Workloads.Portability","Citrix.Images.Uploader" | Uninstall-Module
<!--NeedCopy-->

向 Credential Wallet 中添加凭据

对于端到端自动化场景,您可以将 Image Portability Service 配置为与 Citrix Cloud、您的公有云和本地资源进行非交互式身份验证。此外,只要我们的 API 直接使用您的本地和公有云资源进行身份验证,Image Portability Service 就会使用存储在 Citrix Credential Wallet 中的凭据。按照本部分内容所述设置凭据是运行导出、准备和发布作业的必需步骤。

运行作业时,Image Portability Service 需要访问您可以控制的资源。例如,要使 Image Portability Service 将磁盘从 vSphere 服务器导出到 SMB 共享,该服务需要对这两个系统的登录访问权限。为了保护此帐户信息的安全,Image Portability Service 使用 Citrix Credential Wallet 服务。此服务使用用户定义的名称将您的凭据存储在钱包中。要运行作业时,请提供要使用的凭据的名称。此外,这些凭据可以随时更新或从钱包中删除。

通常会为以下平台存储凭据:

  • Google Cloud
  • Microsoft Azure
  • SMB 共享
  • VMware vSphere

要管理凭据,请参阅 Developer API Portal(开发人员 API 门户)的 Image Portability Service APIs(Image Portability Service API)和“凭据管理”部分。

使用 Image Portability Service

将本地资源位置中的映像准备到您的公有云订阅需要在 Citrix Cloud 中创建 Image Portability 作业。可以创建一个作业,以在脚本或程序中对服务进行直接 API 调用,或者使用我们为自动调用 API 而开发的示例 PowerShell 模块。有关使用 REST API 和 PowerShell 模块创建 IPS 作业的信息,请参阅 Image Portability Service Developer API Portal(Image Portability Service 开发人员 API 门户)。

发布到 Machine Creation Services

Image Portability Service 与 Azure 或 Google Cloud 中的 Machine Creation Services 配合使用。可以将本指南中介绍的 PowerShell 和 REST 解决方案与 Citrix DaaS SDK 结合使用,以创建无缝且自动化的端到端工作流,用于基于准备的本地映像创建计算机目录并使用 Machine Creation Services 预配映像。

有关 Citrix DaaS REST APIs(Citrix DaaS REST API)的详细信息,请参阅“开发人员 API 门户”。

有关使用 远程 PowerShell SDK 的信息,请参阅 Citrix DaaS 文档

面向 APS 和欧盟客户的部署

默认情况下,IPS PowerShell 模块会连接到在美国区域部署的 Image Portability Service。APS 或欧盟的客户在创建作业时可以使用配置参数将 IPS 定向到其特定区域。请对此配置参数使用以下格式:

Deployment = '<your-deployment>'
<!--NeedCopy-->

有效的部署值如下,具体取决于您所在的区域:

地理区域 部署值
APS api.aps.layering.cloud.com
欧盟 api.eu.layering.cloud.com

请在您执行以下操作时随时为 IPS 作业指定部署配置参数:

  • 向 Credential Wallet 中添加凭据
  • 创建导出作业
  • 创建准备作业
  • 创建发布作业

自动执行 VDA 配置

准备源自本地的 Citrix 管理的映像时,您可以在映像中重新配置 VDA,以支持正在准备的映像的目标环境。Image Portability Service 可以在工作流的准备阶段动态应用 VDA 配置更改。有三个配置参数定义 VDA 在迁移的映像中的运行方式:InstallMisaInstallPvsXdReconfigure。请在创建 IPS 作业时按如下所示定义这些参数:

InstallMisa = 'true'
<!--NeedCopy-->

InstallMisa 配置为 true 可使 Image Portability Service 安装任何缺失的 VDA 组件,这些组件是使用 MCS 预配映像所必需的。

InstallMisa 配置为 true 还需要将 CloudProvisioningType 配置为 Mcs

InstallPvs = 'version of Pvs e.g. 7.31.0'
<!--NeedCopy-->

配置 InstallPvs,将其设置为部署映像时使用的 PVS 版本。设置了 InstallPvs 后,Image Portability Service 会在准备作业期间自动在映像中安装指定版本的 PVS 目标设备软件。

配置 InstallPvs 还需要将 CloudProvisioningType 配置为 Pvs

对于 InstallMisaInstallPvs,请注意以下事项:

  • 只有 VDA 的最新 LTSR 和 CR 版本支持此功能。

  • 如果已安装的 VDA 的必要组件已存在,则即使配置了这些参数,也不会进行任何更改。

  • 对于受支持的 VDA 版本,即使必要的 VDA 组件不存在,Image Portability 也会安装所需组件的适当版本。

  • 对于不受支持的 VDA 版本,重新配置将失败,如果必要的 VDA 组件不存在,则会记录一条消息。即使 VDA 重新配置未完成,准备作业也会完成。

XdReconfigure 需要以下值之一:controllerssite_guid。下面是使用每个值的配置参数示例:

使用 controllers

XdReconfigure = @(
    [pscustomobject]@{
        ParameterName = 'controllers'
        ParameterValue = 'comma-separated-list-of-your-cloud-connectors-fqdns'
    }
)
<!--NeedCopy-->

其中 ParameterValue 是要指向 VDA 的新 DDC 的 FQDN 列表。可以用逗号分隔的格式指定多个 DDC。

使用 site_guid

XdReconfigure = @(
    [pscustomobject]@{
        ParameterName = 'site_guid'
        ParameterValue = 'active-directory-site-guid'
    }
)
<!--NeedCopy-->

XdReconfigure 还接受使用 /reconfigure 安装开关运行 VDA 命令行安装程序时支持的值,例如 XenDesktopVdaSetup.exe /reconfigure)。这些值的一些示例包括 wem_agent_portwem_cached_data_sync_portwem_cloud_connectorswem_server。有关 VDA 重新配置命令行选项的完整列表,请参阅 Citrix DaaS VDA 文档

参考

本部分内容根据您的需要详细介绍了技术参考信息。

Image Portability Service 所需的权限

本部分内容详细介绍了 Image Portability Service 在每个受支持的本地和云平台上所需的权限。

VMware vCenter 所需的权限

要在 VMware 环境中运行 IPS 导出磁盘作业,必须具有以下 vCenter 权限。这些权限可在 vCenter 管理面板的 Access Control(访问控制)部分的 Roles(角色)下找到。

-  Cryptographic operations
    -  Direct Access

-  Datastore
    -  Allocate space
    -  Browse datastore
    -  Low level file operations
    -  Remove file

-  Folder
    -  Create folder
    -  Delete folder

-  Network
    -  Assign network

-  Resource
    -  Assign virtual machine to resource pool

-  Virtual machine
    -  Change Configuration
        -  Add existing disk
        -  Add new disk
        -  Remove disk

    -  Edit Inventory
        -  Create from existing
        -  Create new
        -  Remove

    -  Interaction
        -  Power off
        -  Power on
<!--NeedCopy-->

Microsoft Azure 所需的权限

Image Portability 要求您的 Azure 服务帐户具有以下权限:

Microsoft.Compute/disks/beginGetAccess/action
Microsoft.Compute/disks/read
Microsoft.Compute/disks/write
Microsoft.Compute/virtualMachines/extensions/delete
Microsoft.Compute/virtualMachines/extensions/read
Microsoft.Compute/virtualMachines/extensions/write
Microsoft.Compute/virtualMachines/read
Microsoft.Compute/virtualMachines/restart/action
Microsoft.Compute/virtualMachines/write
Microsoft.Network/networkInterfaces/join/action
Microsoft.Network/networkInterfaces/read
Microsoft.Network/networkInterfaces/write
Microsoft.Network/publicIPAddresses/join/action
Microsoft.Network/publicIPAddresses/read
Microsoft.Network/publicIPAddresses/write
Microsoft.Network/virtualNetworks/read
Microsoft.Network/virtualNetworks/subnets/join/action
Microsoft.Network/virtualNetworks/write
Microsoft.Resources/deployments/operationStatuses/read
Microsoft.Resources/deployments/read
Microsoft.Resources/deployments/write
Microsoft.Resources/subscriptions/resourcegroups/delete
Microsoft.Resources/subscriptions/resourceGroups/write
Microsoft.Storage/storageAccounts/listKeys/action
Microsoft.Storage/storageAccounts/write
<!--NeedCopy-->

Google Cloud 所需的权限

Image Portability 要求您的 Google Cloud 服务帐号具有以下权限:

cloudbuild.builds.create
cloudbuild.builds.get
cloudbuild.builds.list
compute.disks.create
compute.disks.delete
compute.disks.get
compute.disks.list
compute.disks.setLabels
compute.disks.use
compute.globalOperations.get
compute.images.create
compute.images.delete
compute.images.get
compute.images.list
compute.images.setLabels
compute.images.useReadOnly
compute.instances.create
compute.instances.delete
compute.instances.get
compute.instances.setLabels
compute.instances.setMetadata
compute.instances.setServiceAccount
compute.instances.setTags
compute.instances.stop
compute.instances.updateDisplayDevice
compute.networks.get
compute.subnetworks.use
compute.subnetworks.useExternalIp
compute.zoneOperations.get
compute.zones.list
iam.serviceAccounts.actAs
iam.serviceAccounts.get
iam.serviceAccounts.list
resourcemanager.projects.get
storage.buckets.create
storage.buckets.delete
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list
<!--NeedCopy-->

相关文档

将工作负载迁移到公有云