コマンド・ライン・インターフェース (CLI) を使用したオペレーターのインストール

oc または kubectlのいずれかのコマンド・ライン・インターフェース・ツールを使用して、オペレーターをインストールします。

手順

注: 以下の手順では、 oc コマンドを使用します。 oc コマンドは、 kubectlと交換可能です。 Kubernetes クラスターに接続している場合は、 oc コマンドを対応する kubectl コマンドに置き換えてください。

Red Hat® OpenShift® Container Platform または Kubernetes クラスターにログインします。 oc cluster-info サブコマンドを実行して、正しいクラスター情報が表示されていることを確認してください。

Kubernetes クラスターを使用している場合は、以下の手順を実行して、必要な有効範囲 (クラスターまたは 1 つ以上の名前空間) の OperatorGroup を作成します。 Red Hat OpenShift Container Platform クラスターの場合、 OperatorGroup は不要です。

OperatorGroup は、オペレーターの有効範囲を管理し、オペレーターがリソースを監視および管理する必要がある名前空間を制御するのに役立つリソースです。

以下のサンプル・スニペットに示すように、必要なスコープのオペレーター・グループ YAML ファイルを作成します。

# Install the Operator group with cluster scope, so that it monitors the change in resources like catalog source, subscription across all the namespaces in the cluster.
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: sip-operator-global
  namespace: <any_namespace> 
spec: {}

# Install the Operator group with namespace scope, so that it monitors the change in resources like subscription in only those namespaces that are mentioned in the cluster.
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: sip-operator-local
  namespace: <any_namespace>
spec:
  # Provide one namespace or none for cluster wide) which will be monitored by the operator.
  targetNamespaces:
  - <target_namespace1>

以下のコマンドを実行して、オペレーター・グループを作成します。
```
oc create -f <operator_group>.yaml -n <sip_installation_namespace>
```

サブスクリプション YAML を作成します。
CatalogSourceから特定のオペレーターにサブスクライブするためにサブスクリプションが作成されます。そのためには、オペレーターの名前、ソース (CatalogSource)、サブスクライブ先のチャネル、ターゲット名前空間などの詳細を指定します。
1. 以下のサンプル・スニペットに示すように、YAML を構成します。
  OMS ゲートウェイ・オペレーターの場合:
```
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: <subscription_name>
  namespace: <sip_installation_namespace>
spec:
  channel: v1.0
  installPlanApproval: <plan_approval>
  name: ibm-oms-gateway
  source: ibm-oms-gateway-catalog
  sourceNamespace: <catalog_source_namespace>
  startingCSV: ibm-oms-gateway.<version>
```
  IBM® Sterling Intelligent Promising オペレーターの場合:
```
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: <subscription_name>
  namespace: <sip_installation_namespace>
spec:
  channel: v1.0
  installPlanApproval: <plan_approval>
  name: ibm-sip
  source: ibm-sip-catalog
  sourceNamespace: <catalog_source_namespace>
  startingCSV: ibm-sip.<version>
```
  - IBM Operator Catalog を使用する場合は、ソース名が、カタログ・ソースに指定されたメタデータ名 (上記の例では ibm-sip-catalog ) と一致することを確認してください。
  - < plan_approval> を Manual または Automaticに設定します。承認戦略が Automaticの場合、選択したチャネルで新しいオペレーター・バージョンが使用可能になるとすぐに、アップグレード・プロセスが開始されます。承認戦略が Manualの場合、保留中のアップグレードを手動で承認する必要があります。
  - < catalog_source_namespace> を、カタログ・ソースが存在する名前空間に設定します。
  - < package> を enterpriseに設定します。
  - インストールしたいOperatorの<version>を設定します。例えば、v1.0.10です。
    注意 10.0.2506.1 リリースより、 Sterling™ Order Management システムチャンネルが次のように変更されました。 v1.0 から v1. IBM Sterling Intelligent Promising Operatorおよび IBM OMS Gateway Operator のバージョニングは、次のように始まります。 v1.1.0 1桁目はチャネル番号、2桁目は月ごとのリリース番号、3桁目はOperatorに適用されるホットフィックスまたはフィックスパックを示します。
2. 以下のコマンドを実行して、サブスクリプションを作成します。
```
oc create -f Subscription.yaml -n <sip_installation_namespace>
```
次のコマンドを実行して、オペレーターのインストール状況を表示します。
```
oc describe sub <subscription_name> -n <sip_installation_namespace>
```
Operator のインストールが正常に完了したら、選択したのと同じ名前空間で ibm-sip-controller-manager ポッドと ibm-oms-gateway-controller-manager ポッドが実行されていることを確認します。
以下のコマンドを実行して、インストールされている OMS Gateway Operator のバージョンを表示します。
```
oc get sub <subscription_name> -o jsonpath=“{.status.installedCSV}” -n <sip_installation_namespace>
```