Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Marketplace デプロイのライフサイクル

このドキュメントでは、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 で、インストールするプロダクトのリスティングページにアクセスします。このページでは、プロダクトの詳細を確認したり、ドキュメント、料金、利用規約へのリンクをたどったりできます。
このプロダクトを初めてインストールする場合は、[インストール] をクリックします。それ以外の場合は、[管理] タブに移動して [新しいインスタンス] をクリックします。
ダイアログで、ソフトウェアパッケージをインストールするユーザークラスタを選択します。構成をカスタマイズする場合は、[次へ] をクリックします。デフォルトの構成を使用する場合は、[インストール] をクリックします。
[次へ] をクリックすると、デフォルトの構成を確認できます。[カスタム構成] をクリックし、ベンダーのドキュメントに沿って独自のパラメータを入力します。完了したら、[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 にステータスが "True" の Ready タイプの条件が含まれていること、status.installedVersion にインストールされているバージョンが表示されていることを確認します。

Distributed Cloud Marketplace ソフトウェアパッケージのインスタンスを再構成する

一部の Distributed Cloud Marketplace ソフトウェアパッケージは、すでに実行されているときに再構成できます。Kubernetes ベースのサービスの場合、これはベンダーの Helm チャートに新しい値を適用することに相当します。

Distributed Cloud Marketplace ソフトウェアパッケージの実行中のインスタンスを再構成する手順は次のとおりです。

GDC コンソールのプロジェクトセレクタで、ソフトウェアパッケージをアップグレードするプロジェクトを選択します。
Distributed Cloud Marketplace ページで、アップグレードするプロダクトのリスティングページにアクセスします。
[管理] タブをクリックします。
再構成するインスタンスの [構成ファイル] をクリックします。
表示されたパネルで、ベンダーのドキュメントに沿ってカスタムパラメータを入力します。
[保存] をクリックして、新しいパラメータを適用します。再構成は数分で完了します。

Distributed Cloud Marketplace ソフトウェアパッケージをアップグレードする

警告: Distributed Cloud Marketplace を使用してソフトウェアパッケージのアップグレードをトリガーできますが、アップグレードプロセスはプロダクトを公開したベンダーによって実装されます。そのため、アップグレードプロセスはソフトウェアパッケージごとに異なります。アップグレードを行う前に、関連するベンダーのリリースノートとアップグレードドキュメントをよく確認することをおすすめします。ベンダーがアップグレードプロセスをどのように実装したかによっては、提供されるサービスでダウンタイムが発生したり、古いバージョンと新しいバージョンの間で互換性の問題が発生したりする可能性があります。

一部の Distributed Cloud Marketplace ソフトウェアパッケージは、インフラストラクチャオペレーターが新しいバージョンを利用可能にした後、Google Distributed Cloud Marketplace を通じて新しいバージョンにアップグレードできます。

Distributed Cloud Marketplace ソフトウェアパッケージをアップグレードする手順は次のとおりです。

GDC コンソールのプロジェクトセレクタで、ソフトウェアパッケージをアップグレードするプロジェクトを選択します。
Distributed Cloud Marketplace ページで、アップグレードするプロダクトのリスティングページにアクセスします。
[管理] タブをクリックします。
アップグレードするインスタンスで [アップグレード] をクリックします。アップグレードは数分で完了します。

Distributed Cloud Marketplace ソフトウェアパッケージをアンインストールする

Distributed Cloud Marketplace ソフトウェアパッケージをアンインストールする手順は次のとおりです。

GDC コンソールのプロジェクトセレクタで、ソフトウェアパッケージをアンインストールするプロジェクトを選択します。
Distributed Cloud Marketplace ページで、アンインストールするプロダクトのリスティングページにアクセスします。
[管理] タブをクリックします。
アンインストールするインスタンスの [アンインストール] をクリックします。ソフトウェアパッケージは数分でアンインストールされます。