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