谷歌云平台环境
Citrix 虚拟应用和桌面™ 允许您在谷歌云上预配和管理计算机。
必备条件
- Citrix Cloud™ 帐户。本文中描述的功能仅在 Citrix Cloud 中可用。
- 一个 Google Cloud 项目。该项目存储与计算机目录关联的所有计算资源。它可以是现有项目,也可以是新项目。
- 在您的 Google Cloud 项目中启用四个 API。有关详细信息,请参阅启用 Google Cloud API。
- Google Cloud 服务帐户。该服务帐户向 Google Cloud 进行身份验证,以启用对项目的访问。有关详细信息,请参阅配置和更新服务帐户。
- 启用 Google 私有访问。有关详细信息,请参阅启用 Google 私有访问。
启用谷歌云 API
要通过 Web Studio 使用 Google Cloud 功能,请在您的 Google Cloud 项目中启用以下应用程序编程接口:
- 计算引擎 API
- 云资源管理器 API
- 身份和访问管理 (IAM) API
- 云构建 API
- 云密钥管理服务 (KMS)
在 Google Cloud 控制台中,完成以下步骤:
-
在左上角菜单中,选择 API 和服务 > 控制面板。

-
在控制面板屏幕上,确保已启用 Compute Engine API。如果 未启用,请按照以下步骤操作:
-
导航到 API 和服务 > 库。

-
在搜索框中,键入 计算引擎。
-
从搜索结果中,选择 计算引擎 API。
-
在 计算引擎 API 页面上,选择 启用。
-
-
启用 云资源管理器 API。
-
导航到 API 和服务 > 库。
-
在搜索框中,键入 云资源管理器。
-
从搜索结果中,选择 云资源管理器 API。
-
在 Cloud Resource Manager API 页面上,选择 启用。此应用程序接口的状态将显示。
-
-
同样,启用身份和访问管理 (IAM) API 和 云构建 API。
您也可以使用 Google Cloud Shell 启用 API。为此,请执行以下操作:
- 打开谷歌控制台并加载 Cloud Shell。
-
在 Cloud Shell 中运行以下四个命令:
- gcloud services enable compute.googleapis.com
- gcloud services enable cloudresourcemanager.googleapis.com
- gcloud services enable iam.googleapis.com
- gcloud services enable cloudbuild.googleapis.com
- 如果 Cloud Shell 提示,请单击授权。
对服务帐户进行配置和更新
注意:
GCP 将在 2024 年 4 月 29 日之后对 Cloud Build Service 的默认行为和服务帐户的使用引入更改。有关详细信息,请参阅 Cloud Build 服务帐户更改。您在 2024 年 4 月 29 日之前启用了 Cloud Build API 的现有 Google 项目不受此更改的影响。但是,如果您希望在 4 月 29 日之后保留现有的 Cloud Build Service 行为,则可以在启用 Cloud Build API 之前创建或应用组织策略以禁用约束强制执行。因此,以下内容分为两部分:2024 年 4 月 29 日之前 和 2024 年 4 月 29 日之后。如果您设置了新的组织策略,请遵循 2024 年 4 月 29 日之前 部分。
2024 年 4 月 29 日之前
Citrix Cloud 在 Google Cloud 项目中使用三个独立的服务帐户:
-
Citrix Cloud 服务帐户:此服务帐户使 Citrix Cloud 能够访问 Google 项目、预配和管理计算机。此服务帐户使用 Google Cloud 生成的 密钥 对 Google Cloud 进行身份验证。
您必须按照此处所述手动创建此服务帐户。有关详细信息,请参阅 创建 Citrix Cloud 服务帐户。
您可以通过电子邮件地址识别此服务帐户。例如,
<my-service-account>@<project-id>.iam.gserviceaccount.com。 -
Cloud Build 服务帐户:在您启用 启用 Google Cloud API 中提及的所有 API 后,此服务帐户会自动预配。要查看所有自动创建的服务帐户,请在 Google Cloud 控制台中导航到 IAM & Admin > IAM,然后选择 Include Google-provided role grants 复选框。
您可以通过以 Project ID 和单词 cloudbuild 开头的电子邮件地址识别此服务帐户。例如,
<project-id>@cloudbuild.gserviceaccount.com验证是否已向服务帐户授予以下角色。如果必须添加角色,请按照 向 Cloud Build 服务帐户添加角色 中概述的步骤操作。
- 云构建服务帐户
- Compute 实例管理员
- 服务帐户用户
-
Cloud Compute 服务帐户:一旦 Compute API 激活,Google Cloud 就会将此服务帐户添加到在 Google Cloud 中创建的实例。此帐户具有 IAM 基本编辑者角色以执行操作。但是,如果您删除默认权限以获得更精细的控制,则必须添加一个需要以下权限的 Storage Admin 角色:
- resourcemanager.projects.get
- 存储.对象.创建
- 存储.对象.获取
- storage.objects.list
您可以通过以 Project ID 和单词 compute 开头的电子邮件地址识别此服务帐户。例如,<project-id>-compute@developer.gserviceaccount.com。
创建 思杰云 服务帐户
要创建 Citrix Cloud 服务帐户,请按照以下步骤操作:
- 在 Google Cloud 控制台中,导航到 IAM 和管理 > 服务帐号。
- 在 服务帐号 页面上,选择 创建服务帐号。
- 在 创建服务帐号 页面上,输入所需信息,然后选择 创建并继续。
-
在 授予此服务帐号项目访问权限 页面上,单击 选择角色 下拉菜单并选择所需角色。如果要添加更多角色,请单击 +添加其他角色。
每个帐号(个人或服务)都有定义项目管理的各种角色。向此服务帐号授予以下角色:
- 计算管理员
- 存储管理员
- 云构建编辑者
- 服务帐号用户
- 云数据存储用户
- 云 KMS 加密操作员
Cloud KMS 加密操作员需要以下权限:
- cloudkms.cryptoKeys.get
- cloudkms.cryptoKeys.list
- cloudkms.keyRings.get
- cloudkms.keyRings.list
- cloudkms.加密密钥版本.用于解密
- cloudkms.加密密钥版本.用于加密
注意:
启用所有 API 以获取创建新服务帐户时可用的完整角色列表。
- 单击“继续”
- 在“授予用户对此服务帐户的访问权限”页面上,添加用户或组以授予他们在此服务帐户中执行操作的权限。
- 单击“完成”。
- 导航到 IAM 主控制台。
- 识别已创建的服务帐户。
- 验证角色是否已成功分配。
注意事项:
创建服务帐户时,请考虑以下事项:
- “授予此服务帐户对项目的访问权限”和“授予用户对此服务帐户的访问权限”步骤是可选的。如果您选择跳过这些可选配置步骤,则新创建的服务帐户不会显示在“IAM 和管理 > IAM”页面中。
- 要显示与服务帐户关联的角色,请添加角色而不跳过可选步骤。此过程可确保为配置的服务帐户显示角色。
思杰云服务帐户密钥
Citrix Cloud 服务帐户密钥是创建 Citrix DaaS 连接所必需的。该密钥包含在凭据文件 (.json) 中。创建密钥后,文件将自动下载并保存到“下载”文件夹。创建密钥时,请务必将密钥类型设置为 JSON。否则,Web Studio 无法解析它。
要创建服务帐户密钥,请导航到“IAM 和管理 > 服务帐户”,然后单击 Citrix Cloud 服务帐户的电子邮件地址。切换到“密钥”选项卡,然后选择“添加密钥 > 创建新密钥”。请务必选择 JSON 作为密钥类型。
提示:
使用 Google Cloud 控制台中的“服务帐户”页面创建密钥。我们建议您定期更改密钥以确保安全。您可以通过编辑现有的 Google Cloud 连接,向 Citrix Virtual Apps and Desktops 应用程序提供新密钥。
向 Citrix Cloud 服务帐户添加角色
要向 Citrix Cloud 服务帐户添加角色,请执行以下操作:
- 在 谷歌云 控制台中,导航到 IAM 和管理 > IAM。
-
在“IAM > 权限”页面上,找到您创建的服务帐户,该帐户可通过电子邮件地址进行识别。
例如,
<my-service-account>@<project-id>.iam.gserviceaccount.com - 选择铅笔图标以编辑服务帐户主体的访问权限。
- 在所选主体选项的“编辑对‘project-id’的访问权限”页面上,选择“添加其他角色”以逐个将所需角色添加到您的服务帐户,然后选择“保存”。
向 Cloud Build 服务帐户添加角色
要向 Cloud Build 服务帐户添加角色,请执行以下操作:
- 在 谷歌云 控制台中,导航到 IAM 和管理 > IAM。
-
在 IAM 页面上,找到 Cloud Build 服务帐号,该帐号可通过以 Project ID 和单词 cloudbuild 开头的电子邮件地址进行识别。
例如,
<project-id>@cloudbuild.gserviceaccount.com - 选择铅笔图标以编辑 Cloud Build 帐号角色。
-
在所选主体选项的“编辑对“project-id”的访问权限”页面上,选择“添加其他角色”以逐个将所需角色添加到您的 Cloud Build 服务帐号,然后选择“保存”。
注意:
启用所有 API 以获取完整的角色列表。
2024 年 4 月 29 日之后
Citrix Cloud 在 Google Cloud 项目中使用两个独立的服务帐号:
-
Citrix Cloud 服务帐号:此服务帐号使 Citrix Cloud 能够访问 Google 项目、预配和管理计算机。此服务帐号使用 Google Cloud 生成的 密钥 对 Google Cloud 进行身份验证。
您必须手动创建此服务帐号。
您可以通过电子邮件地址识别此服务帐号。例如,
<my-service-account>@<project-id>.iam.gserviceaccount.com。 -
Cloud Compute 服务帐号:在您启用 启用 Google Cloud API 中提及的所有 API 后,此服务帐号会自动预配。要查看所有自动创建的服务帐号,请在 Google Cloud 控制台中导航到 IAM & Admin > IAM,然后选择“包括 Google 提供的角色授予”复选框。此帐号具有 IAM 基本编辑者角色来执行操作。但是,如果您删除默认权限以获得更精细的控制,则必须添加 Storage Admin 角色,该角色需要以下权限:
- 资源管理器.项目.获取
- 存储.对象.创建
- 存储.对象.获取
- 列出存储对象
您可以通过以 项目 ID 和单词 compute 开头的电子邮件地址来识别此服务帐户。例如,
<project-id>-compute@developer.gserviceaccount.com.验证此服务帐户是否已获得以下角色。
- 云构建服务帐户
- Compute 实例管理员
- 服务帐户用户
创建思杰云的服务账户
要创建 Citrix Cloud 服务帐户,请按照以下步骤操作:
- 在 Google Cloud 控制台中,导航到 IAM 和管理 > 服务帐户。
- 在 服务帐户 页面上,选择 创建服务帐户。
- 在 创建服务帐户 页面上,输入所需信息,然后选择 创建并继续。
-
在 授予此服务帐户项目访问权限 页面上,单击 选择角色 下拉菜单并选择所需角色。如果要添加更多角色,请单击 +添加其他角色。
每个帐户(个人或服务)都有定义项目管理的各种角色。向此服务帐户授予以下角色:
- 计算管理员
- 存储管理员
- 云构建编辑者
- 服务帐号用户
- 云数据存储用户
- 云 KMS 加密操作员
Cloud KMS 加密操作员需要以下权限:
- 获取云密钥管理服务加密密钥
- cloudkms.加密密钥.列出
- cloudkms.keyRings.get
- cloudkms.keyRings.list
注意:
启用所有 API 以获取创建新服务帐号时可用的完整角色列表。
- 单击“继续”
- 在“向此服务帐号授予用户访问权限”页面上,添加用户或组以授予他们在此服务帐号中执行操作的权限。
- 单击“完成”。
- 导航到 IAM 主控制台。
- 识别已创建的服务帐户。
- 验证角色是否已成功分配。
注意事项:
创建服务帐户时,请考虑以下事项:
- “授予此服务帐户对项目的访问权限”和“授予用户对此服务帐户的访问权限”步骤是可选的。如果您选择跳过这些可选配置步骤,则新创建的服务帐户不会显示在“IAM 和管理 > IAM”页面中。
- 要显示与服务帐户关联的角色,请添加角色而不跳过可选步骤。此过程可确保角色显示在已配置的服务帐户中。
Citrix 云服务账号密钥
在 Citrix DaaS 中创建连接需要 Citrix Cloud 服务帐户密钥。该密钥包含在凭据文件 (.json) 中。创建密钥后,该文件会自动下载并保存到“下载”文件夹中。创建密钥时,请务必将密钥类型设置为 JSON。否则,Web Studio 无法对其进行解析。
要创建服务帐户密钥,请导航到“IAM 和管理 > 服务帐户”,然后单击 Citrix Cloud 服务帐户的电子邮件地址。切换到“密钥”选项卡,然后选择“添加密钥 > 创建新密钥”。请务必选择 JSON 作为密钥类型。
提示:
使用 Google Cloud 控制台中的“服务帐户”页面创建密钥。我们建议您定期更改密钥以确保安全。您可以通过编辑现有 Google Cloud 连接来向 Citrix Virtual Apps and Desktops 应用程序提供新密钥。
向 Citrix Cloud 服务帐户添加角色
要向 Citrix Cloud 服务帐户添加角色,请执行以下操作:
- 在谷歌云控制台中,导航到 IAM 和管理 > IAM。
-
在“IAM > 权限”页面上,找到您创建的服务帐户,该帐户可通过电子邮件地址进行识别。
例如,
<my-service-account>@<project-id>.iam.gserviceaccount.com - 选择铅笔图标以编辑服务帐号主体的访问权限。
- 在所选主体选项的“编辑对“project-id”的访问权限”页面上,选择“添加其他角色”以逐个将所需角色添加到您的服务帐号,然后选择“保存”。
将角色添加到 Cloud Compute 服务帐号
要将角色添加到 Cloud Compute 服务帐号:
- 在谷歌云控制台中,导航到 IAM 和管理 > IAM。
-
在“IAM”页面上,找到 Cloud Compute 服务帐号,该帐号可通过以“项目 ID”和单词“compute”开头的电子邮件地址进行识别。
例如,
<project-id>-compute@developer.gserviceaccount.com - 选择铅笔图标以编辑 Cloud Build 帐号角色。
-
在所选主体选项的“编辑对“project-id”的访问权限页面”上,选择“添加其他角色”以逐个将所需角色添加到您的 Cloud Build 服务帐号,然后选择“保存”。
注意:
启用所有 API 以获取完整的角色列表。
存储权限和存储桶的管理
Citrix Virtual Apps and Desktops 改进了 Google Cloud 服务 的云构建失败报告过程。此服务在 Google Cloud 上运行构建。Citrix Virtual Apps and Desktops 创建了一个名为 citrix-mcs-cloud-build-logs-{region}-{5 random characters} 的存储桶,Google Cloud 服务在该存储桶中捕获构建日志信息。此存储桶上设置了一个选项,可在 30 天后删除内容。此过程要求用于连接的服务帐号具有设置为 storage.buckets.update 的 Google Cloud 权限。如果服务帐号没有此权限,Citrix Virtual Apps and Desktops 将忽略错误并继续执行目录创建过程。如果没有此权限,构建日志的大小会增加,并且需要手动清理。
启用私有 Google 访问权限
当虚拟机缺少分配给其网络接口的外部 IP 地址时,数据包仅发送到其他内部 IP 地址目标。启用私有访问时,虚拟机连接到 Google API 和相关服务使用的外部 IP 地址集。
注意:
无论是否启用私有 Google 访问,所有具有和不具有公共 IP 地址的虚拟机都必须能够访问 Google 公共 API,特别是如果环境中安装了第三方网络设备。
为确保子网中的虚拟机无需公共 IP 地址即可访问 Google API 以进行 MCS 预配:
- 在谷歌云中,访问VPC 网络配置。
- 在子网详细信息屏幕中,启用私有 Google 访问。

有关详细信息,请参阅配置私有 Google 访问。
重要提示:
如果您的网络配置为阻止虚拟机访问 Internet,请确保您的组织承担启用虚拟机所连接子网的私有 Google 访问所带来的风险。
下一步操作
- 安装核心组件
- 安装虚拟投递代理
- 创建站点
- 有关在 Google Cloud 环境中创建和管理连接的信息,请参阅连接到 Google Cloud 环境
更多信息
- 创建和管理连接与资源(/zh-cn/citrix-virtual-apps-desktops/2503/install-configure/connections.html)
- 创建计算机目录(/zh-cn/citrix-virtual-apps-desktops/2503/install-configure/machine-catalogs-create.html)