プライベート・カタログへのバージョンのインポート

ソフトウェアのバージョンをプライベート・カタログにインポートするには、以下の手順を実行します。 プライベート・カタログは、ソフトウェアを販売するためのセットアップの一環で作成されたものです。

1. IBM Cloud コンソールで、 ナビゲーションメニュー アイコン > パートナーセンター > マイプロダクトの順にクリックします。

2. オンボードする製品を選択します。

3. 「ソフトウェア」タブで、 バージョンのインポート をクリックします。

4. デプロイメント方式を選択します。

5. 製品をプライベート・リポジトリーまたはパブリック・リポジトリーのどちらから追加するかを選択します。 オペレーターの場合は、ソース・リポジトリーを選択してから、プライベート・リポジトリーまたはパブリック・リポジトリーを選択します。

6. ソース URL を入力します。

   ソフトウェア・タイプごとに、以下のサポートされるフォーマットのリストを確認できます。

   • Helm チャート: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
   • Node-RED オペレーター: https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
   • Red Hat OpenShift on IBM Cloud レジストリのオペレーターバンドル：例として、認定リポジトリの利用可能なオペレーターの一覧から「 Akka Cluster Operator 」を選択してください。
   • OVA イメージ: https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
   • Terraform テンプレート: https://github.com/IBM-Cloud/terraform-sample/archive/refs/tags/v1.1.0.tar.gz
   • Terraform を使用した仮想サーバー・イメージ: https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
   • VPC の仮想サーバー・イメージ: VPC にインポートされた使用可能なイメージのリストからイメージを選択するか、アカウントに新規イメージをインポートします。

   VPC の仮想サーバー・イメージは、一度に 1 つのプライベート・カタログ内の 1 つの製品にのみ追加できます。 インポートする仮想サーバー・イメージが既に別の製品にインポートされている場合は、仮想サーバー・イメージを新しい製品に追加する前に、その製品からイメージを削除するか、製品を削除する必要があります。

   プライベート・リポジトリーから製品を追加する場合は、パーソナル・アクセス・トークンを提供するか、シークレットを使用するかを選択できます。 ユーザーにパーソナル・アクセス・トークンを提供する代わりに、シークレットへのアクセス権限をユーザーに提供し、シークレットにトークンを追加して、シークレットによって許可されるすべてのトークンとアクセス権限を一元的に管理することができます。

   ソフトウェアが にある場合、 はプロジェクトアクセストークンを使用した GitLab リリースのダウンロード GitLab, をサポートしていないため、個人アクセストークンを使用する必要があります。 必要な「read_api パーミッションを持つ個人アクセストークンは、こちらの手順に従って作成することができます。

   • パーソナル・アクセス・トークンを使用する場合、 いいえ を選択して、シークレットを使用せずに自身のパーソナル・アクセス・トークンを提供することを示します。
   • シークレットを使用する場合、 はい を選択して Secrets Manager から選択してください をクリックします。 サービス・インスタンス、シークレット・グループ、およびシークレットを選択します。 対象のシークレットが表示されない場合は、正しいシークレット・グループとサービス・インスタンスを使用していることを確認してください。

   シークレットを作成していないか、シークレットを使用するための適切なアクセス権限がない場合は、作成されたサービス・インスタンスがあってもメッセージ「No service instance available」と表示される場合があります。

7. 必要に応じて、デプロイメント・ターゲットを設定し、ソフトウェアのバージョンを追加します。

8. バージョンを追加 をクリックします。

バージョン詳細の構成

1. バージョン・リストから、対象のソフトウェアの行をクリックします。
2. バージョンの詳細を確認し、 次へ をクリックします。
3. ソフトウェア・タイプによっては、デプロイメント値の設定など、追加のステップが必要になる場合があります。
4. 次へ をクリックします。

使用条件の追加

ユーザーがソフトウェアのインストール時に IBM Cloud サービス契約以外のライセンス契約に同意する必要がある場合は、各契約条件の URL を指定するか、既存のバージョンからライセンスをインポートします。

README ファイルの確認

ユーザーがソフトウェアをインストールすると、README リンクをクリックして製品情報を表示できます。 「Readme」リンクに記載されている情報は、ソースリポジトリにアップロードしたreadmeファイルから生成されたものです。

1. 「README の編集」タブで、 編集 アイコン をクリックします。
2. ユーザーがソフトウェアをインストールするときに README ファイルの情報がどのように表示されるのかをプレビューします。
3. 更新するには、「README」セクションのタイトルの横にある 編集 アイコンをクリックします。
4. 保存 をクリックします。
5. 次へ をクリックします。

VPC の仮想サーバー・イメージをインポートする場合、README ファイルは自動的に生成されません。 README ファイル・テンプレート の内容をコピーして貼り付け、必要に応じて更新します。

製品の検証

製品を検証する手順は、オンボードするソフトウェアのタイプによって異なります。

1. 「製品の検証」タブで、検証のターゲットを構成し、 次へ をクリックします。 この手順は、Helm チャートおよびオペレーターにのみ適用されます。
2. ワークスペースを構成し、 次へ をクリックします。 この手順は、Helm チャート、オペレーター、Terraform テンプレート、Terraform を使用した仮想サーバー・イメージだけに適用されます。
3. 検証 をクリックします。

検証プロセスの進行状況をモニターするには、 ログを表示 をクリックします。

API を使用したソフトウェアの検証

カタログ管理 APIを呼び出して、ソフトウェアを検証できます。

String authRefreshToken = "{authRefreshToken}";
String versionLocator = "{versionLocator}";
ValidationInstallOptions installOptions = new ValidationInstallOptions.Builder().xAuthRefreshToken(authRefreshToken).versionLocId(versionLocator).build();
Response<Void> response = service.validationInstall(installOptions).execute();
System.out.println(response.getResult());

versionLocator = "{versionLocator}";
authRefreshToken = "{authRefreshToken}";
response = await service.validationInstall({ 'versionLocatorId': versionLocator, 'xAuthRefreshToken': authRefreshToken });
console.log(response);

authRefreshToken="{authRefreshToken}"
versionLocator = "{versionLocator}"
response = self.service.validation_install(version_locator_id=versionLocator, x_auth_refresh_token=authRefreshToken)
print(response)

versionLocator := "{versionLocator}"
authRefreshToken := "{authRefreshToken}"
installOptions := service.NewValidationInstallOptions(versionLocator, authRefreshToken)
response, _ := service.ValidationInstall(installOptions)
fmt.Println(response)

セキュリティおよびコンプライアンス管理措置の管理

コントロールは、セキュリティーとコンプライアンスの要件を満たすために使用される安全機能です。 カタログには、によってサポート Workload Protection されているコントロールのみが表示されます。 詳しくは、 README ファイルのコントロールの書式設定 を参照してください。