Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

市集部署作業的生命週期

本文說明如何使用 GDC 控制台，安裝、升級及解除安裝 Google Distributed Cloud (GDC) 實體隔離方案 Marketplace 軟體套件。您也可以使用 gdcloud marketplace CLI 或 Marketplace API 安裝軟體套件。

本文適用於應用程式操作員群組中，負責管理 GDC 專案內 Marketplace 部署項目生命週期的對象。詳情請參閱「GDC 實體隔離方案說明文件的目標對象」。

事前準備

您必須具備必要權限並準備好環境，才能安裝、升級或解除安裝 Marketplace 軟體套件。

要求 IAM 角色

請與 IAM 機構組織管理員或 IAM 專案管理員聯絡，根據您要在專案中執行的工作，要求下列角色：

Marketplace 編輯者 (marketplace-editor)：安裝、升級及解除安裝 Marketplace 軟體套件。
專案檢視者 (project-viewer)：查看現有專案及其資源。

IAM 機構組織管理員可以為組織中的任何專案授予這些角色。IAM 專案管理員可以在特定專案範圍內授予這些角色。

準備環境

本頁的工作主要使用 GDC 控制台。如要使用指令列替代方案，請完成下列步驟：

如果您尚未下載並安裝 gdcloud CLI，請先完成此步驟。
如要搭配 kubectl 使用 API，必須完成其他設定：
- 安裝 kubectl CLI。
- 產生 kubeconfig 檔案。

安裝 Distributed Cloud Marketplace 軟體套件

如要從 Distributed Cloud Marketplace 安裝軟體套件，請完成下列步驟：

控制台

在 GDC 控制台的專案選取器中，選取要安裝軟體套件的專案。
在 Distributed Cloud Marketplace，前往要安裝的產品資訊頁面。您可以在這個頁面查看產品詳細資料，並透過連結前往說明文件、定價和服務條款。
如果是第一次安裝這項產品，請按一下「安裝」。如果沒有，請前往「管理」分頁，然後點選「建立執行個體」。
在對話方塊中，選取要安裝軟體套件的使用者叢集。如要自訂設定，請點選「Next」(下一步)。如要使用預設設定，請按一下「安裝」。
如果點選「下一步」，現在可以查看預設設定。按一下「自訂設定」，然後按照供應商的文件輸入參數。完成後，按一下「Install」繼續安裝。如果是 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 包含 Ready 類型的條件，狀態為 "True"，且 status.installedVersion 顯示已安裝的版本。

重新設定 Distributed Cloud Marketplace 軟體套件的執行個體

部分 Distributed Cloud Marketplace 軟體套件在執行時可以重新設定。如果是 Kubernetes 服務，這相當於將新值套用至供應商的 Helm 圖表。

如要重新設定 Distributed Cloud Marketplace 軟體套件的執行中執行個體，請按照下列步驟操作：

在 GDC 控制台的專案選取器中，選取要升級軟體套件的專案。
在 Distributed Cloud Marketplace 頁面，前往要升級的產品資訊頁面。
點選「管理」分頁標籤。
按一下要重新設定的執行個體的「設定檔」。
在開啟的面板中，按照供應商的文件輸入自訂參數。
按一下「儲存」套用新參數。重新設定作業會在幾分鐘內完成。

升級 Distributed Cloud Marketplace 軟體套件

基礎架構運營商提供新版本後，部分 Distributed Cloud Marketplace 軟體套件可透過 Google Distributed Cloud Marketplace 升級至新版本。

如要升級 Distributed Cloud Marketplace 軟體套件，請按照下列步驟操作：

在 GDC 控制台的專案選取器中，選取要升級軟體套件的專案。
在 Distributed Cloud Marketplace 頁面，前往要升級的產品資訊頁面。
點選「管理」分頁標籤。
在要升級的執行個體上，按一下「Upgrade」(升級)。升級作業會在幾分鐘內完成。

解除安裝 Distributed Cloud Marketplace 軟體套件

如要解除安裝 Distributed Cloud Marketplace 軟體套件，請完成下列步驟：

在 GDC 控制台的專案選取器中，選取要解除安裝軟體套件的專案。
在 Distributed Cloud Marketplace 頁面，前往要解除安裝的產品資訊頁面。
點選「管理」分頁標籤。
找到要解除安裝的執行個體，然後按一下「Uninstall」(解除安裝)。軟體套件會在幾分鐘內解除安裝。