IBM StreamSetsのインストール

インスタンス管理者は、IBM Software Hub バージョン 5.3 に IBM StreamSets をインストールできます。

このタスクを実行する必要があるのは誰か?

インスタンス管理者 IBM StreamSets をインストールするには、インスタンス管理者でなければなりません。 インスタンス管理者は、以下のプロジェクトにソフトウェアをインストールする権限を持っています。

インスタンスの オペレーター・プロジェクト

IBM StreamSets のこのインスタンスのオペレーターは、オペレーター・プロジェクトにインストールされます。

インストール・コマンドで、${PROJECT_CPD_INST_OPERATORS} 環境変数はオペレーター・プロジェクトを参照します。

インスタンスの オペランド・プロジェクト

control plane および IBM StreamSets のカスタム・リソースは、オペランド・プロジェクトにインストールされます。

インストール・コマンドで、${PROJECT_CPD_INST_OPERANDS} 環境変数はオペランド・プロジェクトを参照します。

このタスクをいつ完了する必要がありますか?

以下のオプションを確認して、このタスクを実行する必要があるかどうかを判別します。

  • 複数のサービスを同時にインストールする場合は、代わりに ソリューションおよびサービスのバッチ・インストールの実行 のプロセスに従ってください。
  • バッチ・インストールの一部として IBM StreamSets をインストールしなかった場合は、このタスクを実行して、IBM StreamSets をご使用の環境に追加します。

    必要に応じて繰り返します 複数のインスタンスの IBM Software Hubを担当している場合は、このタスクを繰り返して、クラスターに IBM StreamSets のインスタンスをさらにインストールできます。

このタスクを完了するために必要な情報

IBM StreamSetsをインストールする前に、以下の情報を確認してください。

バージョンの要件

IBM Software Hubのインスタンスに関連付けられているすべてのコンポーネントは、同じリリースでインストールする必要があります。 例えば、IBM Software Hub control planeがバージョン 5.3.1 でインストールされている場合、IBM StreamSets をバージョン 5.3.1 でインストールする必要があります。

環境変数

このタスクのコマンドでは環境変数を使用するため、記載されているとおりにコマンドを実行できます。

  • 環境変数を定義するスクリプトがない場合は、インストール環境変数の設定を参照してください。
  • スクリプトから環境変数を使用するには、このタスクでコマンドを実行する前に環境変数をsourceする必要があります。 例えば、以下のコマンドを実行します。
    source ./cpd_vars.sh
セキュリティー・コンテキスト制約

IBM StreamSets works with the default Red Hat® OpenShift® Container Platform security context constraint, restricted-v2.

ストレージ要件
IBM StreamSets をインストールするときに、ストレージ・クラスを指定する必要があります。 以下のストレージ・クラスが推奨されます。 ただし、クラスターでこれらのストレージ・クラスを使用しない場合は、同等の定義を持つストレージ・クラスを指定してください。
ストレージ ノート ストレージ・クラス
OpenShift Data Foundation サービスをインストールするときに、ファイル・ストレージを指定します。
  • ファイル・ストレージ: ocs-storagecluster-cephfs
IBM Fusion Data Foundation サポートされていません。 該当なし。
IBM Fusion Global Data Platform サポートされていません。 該当なし。
IBM Storage Scale Container Native サポートされていません。 該当なし。
Portworx サービスをインストールするときに、ファイル・ストレージを指定します。 ファイル・ストレージ: portworx-shared-gp3
NFS サポートされていません。 該当なし。
Amazon Elasticストレージ サービスをインストールするときに、ファイル・ストレージを指定します。

ファイル・ストレージは Amazon Elastic File Systemによって提供されます。

 ファイル・ストレージ: efs-nfs-client
NetApp Trident サポートされていません。 該当なし。
Nutanix サポートされていません。 該当なし。

始める前に

このタスクでは、以下の前提条件が満たされていることを前提としています。

システム要件
このタスクでは、クラスターが IBM StreamSetsの最小要件を満たしていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、『システム要件』を参照してください。
ワークステーション
このタスクでは、インストールを実行するワークステーションがクライアント・ワークステーションとしてセットアップされており、以下のコマンド行インターフェースがあることを前提としています。
  • IBM Software Hub CLI: cpd-cli
  • OpenShift CLI: oc
  • Helm CLI: helm
詳細情報の参照先
このタスクが完了していない場合は、『クライアント・ワークステーションのセットアップ』を参照してください。 Setting up a client workstation
制御プレーン
このタスクでは、IBM Software Hub control planeがインストールされていることを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、IBM Software Hub のインスタンスのインストールを参照してください。
プライベート・コンテナー・レジストリー
ご使用の環境でプライベート・コンテナー・レジストリーを使用している場合 (例えば、クラスターがエアー・ギャップである場合)、このタスクでは以下のタスクが完了していることを前提としています。
  1. IBM StreamSets ソフトウェア・イメージがプライベート・コンテナー・レジストリーにミラーリングされます。
    詳細情報の参照先
    このタスクが完了していない場合は、プライベート・コンテナー・レジストリーへのイメージのミラーリングを参照してください。
  2. cpd-cliは、プライベート・コンテナー・レジストリーから olm-utils-v4イメージをプルするように構成されています。
    詳細情報の参照先
    このタスクが完了していない場合は、プライベート・コンテナー・レジストリーからの olm-utils-v4 イメージのプルを参照してください。
クラスター・スコープ・リソース
このタスクでは、カスタム・リソース定義、クラスター役割、クラスター役割バインディングなどのクラスター・スコープ・リソースが存在することを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、クラスター・スコープ・リソースの作成 (クラスター・スコープ・リソースの作成) (IBM Software Hub プラットフォームおよびサービス用)を参照してください。
イメージ・プル・シークレット
このタスクでは、インスタンスのイメージ・プル資格情報を含むシークレットが存在することを前提としています。
詳細情報の参照先
このタスクが完了していない場合は、IBM Software Hub のインスタンスのイメージ・プル・シークレットの作成を参照してください。

手順

IBM StreamSets をインストールするには、以下のタスクを実行します。

  1. サービスのインストール
  2. インストールの検証
  3. 次に行うこと

サービスのインストール

IBM StreamSets をインストールするには、次のようにします。

  1. cpd-cliをRed Hat OpenShift Container Platform・クラスターにログインします。
    ${CPDM_OC_LOGIN}
    注意: CPDM_OC_LOGIN は、cpd-cli manage login-to-ocp コマンドの別名です。
  2. IBM StreamSetsのオペレーターとカスタム・リソースをインストールします。

    実行するコマンドは、クラスター上のストレージによって異なります。

    Red Hat OpenShift Data Foundation ストレージ 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=streamsets \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    Portworx ストレージ 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=streamsets \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--storage_vendor=portworx \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    AWSとEFSおよびEBSストレージ 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=streamsets \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}

インストールの検証

IBM StreamSets is installed when the install-components command returns:
[SUCCESS]... The install-components command ran successfully

カスタム・リソースの状況が Completedであることを確認する場合は、cpd-cli manage get-cr-status コマンドを実行できます。

cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=streamsets

次のタスク

ユーザーが IBM StreamSetsにアクセスできるようにするには、その前に IBM StreamSets のインストール後のセットアップを完了する必要があります。