Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Marketplace 部署的生命周期

本文档介绍了如何使用 GDC 控制台安装、升级和卸载 Google Distributed Cloud (GDC) 网闸隔离配置 Marketplace 软件包。您还可以使用 gdcloud marketplace CLI 或 Marketplace API 安装软件包。

本文档面向应用运维人员群组中负责管理 GDC 项目内 Marketplace 部署生命周期的受众群体。如需了解详情，请参阅适用于 GDC 网闸隔离配置文档的受众群体。

准备工作

在安装、升级或卸载 Marketplace 软件包之前，您必须拥有必要的权限并准备好环境。

申请 IAM 角色

请与您的 IAM 组织管理员或 IAM 项目管理员联系，根据您需要在项目中执行的任务请求以下角色：

Marketplace Editor (marketplace-editor)：安装、升级和卸载 Marketplace 软件包。
Project Viewer (project-viewer)：查看现有项目及其资源。

IAM 组织管理员可以为组织内的任何项目授予这些角色。IAM Project Admin 可以在其特定项目的范围内授予这些角色。

准备环境

本页面上的任务主要使用 GDC 控制台。如果您打算使用命令行替代方案，请完成以下操作：

下载并安装 gdcloud CLI（如果您尚未安装）。
如需将该 API 与 kubectl 搭配使用，还需要进行额外的设置：
- 安装 kubectl CLI。
- 生成 kubeconfig 文件。

安装 Distributed Cloud Marketplace 软件包

如需从 Distributed Cloud Marketplace 安装软件包，请完成以下步骤：

控制台

在 GDC 控制台的项目选择器中，选择要安装软件包的项目。
在 Distributed Cloud Marketplace 中，访问要安装的产品详情页面。在此页面中，您可以查看产品的详细信息，并点击链接查看其文档、价格和服务条款。
如果您是首次安装此产品，请点击安装。否则，请前往“管理”标签页，然后点击新建实例。
在对话框中，选择要在哪个用户集群中安装软件包。如果您想自定义其配置，请点击下一步。如果您想使用默认配置，请点击安装。
如果您点击了下一步，现在可以检查默认配置。点击自定义配置，按照供应商的文档输入您自己的参数。完成后，点击安装以继续安装。对于 Kubernetes 软件包，您在此处配置的参数会覆盖供应商在其 Helm 值文件中提供的默认值。
等待几分钟，直到新实例在页面的管理标签页中标记为就绪。
请参阅相关软件供应商的文档，了解如何在安装后使用其解决方案。

gdcloud

选择要在其中安装软件包的项目：
```
gdcloud config set project PROJECT_NAME
```
将 PROJECT_NAME 替换为您要在其中安装软件包的项目名称。
列出可用的 Marketplace 应用：
```
gdcloud marketplace services list
```
从列表中安装所选应用，并指定目标集群：
```
gdcloud marketplace services install SERVICE_NAME \
  --cluster=CLUSTER_NAME
```
如需在安装期间提供自定义配置替换，请使用 --parameters-file 标志：
```
gdcloud marketplace services install SERVICE_NAME \
  --cluster=CLUSTER_NAME \
  --parameters-file=PATH_TO_PARAMETERS_FILE
```
替换以下内容：
- SERVICE_NAME：要安装的 Marketplace 服务的名称（例如 dataproc）
- CLUSTER_NAME：您要在其中安装应用的目标用户集群的名称
- PATH_TO_PARAMETERS_FILE：包含服务实例配置替换参数的 YAML 文件的路径
验证安装：
```
gdcloud marketplace services list
```
确认新安装的应用显示在列表中，且状态为 READY 或 INSTALLED。

API

列出可用的 ServiceVersion 资源，以找到您要安装的特定服务和版本：
```
kubectl get serviceversions -n mkt-system
```
为 ServiceInstance 资源创建 YAML 清单（例如 service-instance.yaml）：
```
apiVersion: marketplace.gdc.goog/v1
kind: ServiceInstance
metadata:
  name: INSTANCE_NAME
spec:
  clusterRef:
    name: CLUSTER_NAME
    namespace: CLUSTER_NAMESPACE
  serviceVersionRef:
    name: SERVICE_VERSION_NAME
    namespace: mkt-system
  parameters:
    KEY: VALUE
```
替换以下内容：
- INSTANCE_NAME：新应用实例的名称
- CLUSTER_NAME：您要在其中安装应用的目标用户集群的名称
- CLUSTER_NAMESPACE：集群的命名空间（例如 production-cluster）
- SERVICE_VERSION_NAME：要安装的 ServiceVersion 的名称（例如 dataproc-1.0.0）
- KEY：配置替换参数名称，遵循供应商的 Helm 值架构
- VALUE：配置替换参数的值
如需了解详情和查看清单示例，请参阅 Marketplace API 概览。
将清单应用于项目：
```
kubectl apply -f service-instance.yaml -n PROJECT_NAME
```
将 PROJECT_NAME 替换为您要在其中安装软件包的项目名称。
通过检查 ServiceInstance 对象的状态来验证安装：
```
kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
```
确认 status.conditions 包含状态为 "True" 的 Ready 类型条件，并且 status.installedVersion 显示已安装的版本。

重新配置 Distributed Cloud Marketplace 软件包的实例

某些 Distributed Cloud Marketplace 软件包在运行时可以重新配置。对于基于 Kubernetes 的服务，这相当于将新值应用于供应商的 Helm 图表。

如需重新配置正在运行的 Distributed Cloud Marketplace 软件包实例，请完成以下步骤：

在 GDC 控制台的项目选择器中，选择要升级软件包的项目。
在 Distributed Cloud Marketplace 页面上，访问要升级的产品详情页面。
点击管理标签页。
点击要重新配置的实例对应的配置文件。
在打开的面板中，按照供应商的文档输入自定义参数。
点击保存以应用新参数。重新配置会在几分钟内完成。

升级 Distributed Cloud Marketplace 软件包

在基础架构运营商向您提供新版本后，您可以通过 Google Distributed Cloud Marketplace 将某些 Distributed Cloud Marketplace 软件包升级到新版本。

如需升级 Distributed Cloud Marketplace 软件包，请执行以下步骤：

在 GDC 控制台的项目选择器中，选择要升级软件包的项目。
在 Distributed Cloud Marketplace 页面上，访问要升级的产品详情页面。
点击“管理”标签页。
在要升级的实例上点击升级。升级会在几分钟内完成。

卸载 Distributed Cloud Marketplace 软件包

如需卸载 Distributed Cloud Marketplace 软件包，请完成以下步骤：

在 GDC 控制台的项目选择器中，选择要从中卸载软件包的项目。
在 Distributed Cloud Marketplace 页面上，访问要卸载的产品详情页面。
点击管理标签页。
点击要卸载的实例对应的卸载。软件包会在几分钟内卸载。