IBM Cloud Pak for Integration の導入

## 1. IBM Cloud Pak for Integration とは

IBM Cloud Pak for Integrationは、システム連携に必要な機能が、Red Hat OpenShift上のコンテナとして提供される、クラウド時代における統合ソリューションです。
![img_icp_integration_01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/e6775a16-d044-3781-3485-255a4c6fc4d2.png)
詳細につきましては、[製品サイト IBM Cloud Pak for Integration - 概要 - 日本 | IBM](https://www.ibm.com/jp-ja/cloud/cloud-pak-for-integration)もご参照ください。


## 2. IBM Cloud Pak for Integration の導入方法

ここでは、バージョン「2021.2」の導入の概略を示します

### 2.1. OpenShift Container Platform の準備

前提となるOpenShit Container Platformの環境を用意します。
サポートされているバージョンは、4.6.8 以降 または 4.7.x となっています。

ベアメタル環境へのUPIによる導入は、下記記事等が参考になります。
[赤帽エンジニアブログ　OpenShift 4.2 UPIインストール（4.1からの変更点）](https://rheb.hatenablog.com/entry/openshift42-upi-update)

IBM CloudでもManaged Serviceとして提供されておりますので、そちらの環境を利用することも可能です。
詳細：[Red Hat OpenShift on IBM Cloud](https://www.ibm.com/jp-ja/cloud/openshift)

また、環境に応じて、ストレージ環境をご用意ください。


### 2.2. IBM Cloud Pak for Integration の導入

#### 2.2.1. OperatorHUBへの登録

以下の手順にて、Operator HUB にIBM Cloud Pak for Integration のカタログを登録します。

1) yamlファイルを作成します。

```yaml:catalog.yaml
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: ibm-operator-catalog
  namespace: openshift-marketplace
spec:
  displayName: IBM Operator Catalog
  image: 'icr.io/cpopen/ibm-operator-catalog:latest'
  publisher: IBM
  sourceType: grpc
  updateStrategy:
    registryPoll:
      interval: 45m
```

2) 作成したyamlファイルを適用します。

```bash
$ oc apply -f catlog.yaml
```

#### 2.2.2. Entilement Keyの登録

以下の手順にて、Entitlement Keyを登録します。

1)[IBM Container Library](https://myibm.ibm.com/products-services/containerlibrary)にアクセスし、Entitlement Keyを確認します。
![2021-07-16_16h47_08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/0b961592-36b6-43d7-d475-98144ee9b6b0.png)

2) 以下のコマンドを実行します。

```
$ oc create secret docker-registry ibm-entitlement-key \
    --docker-username=cp \
    --docker-password=<entitlement-key> \
    --docker-server=cp.icr.io \
    --namespace=<target-namespace>
```

※\<entitlement-key\>は上記手順で確認したキーの値、\<target-namespace\>は導入先のnamespace(プロジェクト名)に置き換えてください。


#### 2.2.3. Operatorの導入

以下の手順にて、IBM Cloud Pak for Integration のOperatorを導入します。

1)OpenshiftのWEBコンソールにログインし、「Operator」の中にある「OperatorHub」を選択します。
2)検索ボックスに「ibm cloud pak for integration」と入力し、検索します。
![2021-07-15_11h46_31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/20f9734d-dcdb-70ad-a861-0e588db72b54.png)
3)リストの中から「IBM Cloud Pak for Integration」を選択、クリックします。
![2021-07-15_11h39_15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/4228fcbe-516e-8269-384c-9904b958d658.png)
4)「インストール」をクリックします。
![2021-07-12_11h06_10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/5019b9ac-13a6-68ea-73cb-000d8008355f.png)
5)必要事項を入力し、「インストール」をクリックします。
![2021-07-15_11h53_16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/16b5cc79-1406-58f8-36d3-c17f36aa8274.png)
6) Operator の導入が開始されます。
![2021-07-15_11h53_36.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/21c89383-1872-6117-1438-59582a959b73.png)
7)インストールが終わると以下のような画面になります。
![2021-07-15_13h05_36.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/a3449ec4-4d7a-22ee-e96b-311c50be5349.png)


#### 2.2.4. Platform Navigator の導入
 
以下の手順にて、Platform Navigatorを導入します。
※Platform Navigator: IBM Cloud Pak Integration 管理の入り口となるダッシュボード

1)OpenshiftのWEBコンソールにログインし、「Operator」の中にある「インストールされたOperator」を選択します。
2)検索ボックスに「platform navigator」と入力し、検索します。
3)リストの中から「IBM Cloud Pak for Integration Platform Navigator」を選択、クリックします。
![2021-07-15_13h09_36.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/4869b5c3-7cd0-cf4a-28c7-d071c6f149e7.png)
4)「インスタンスの作成」をクリックします。
![2021-07-15_13h13_36.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/15dbe002-3e68-4154-b4c4-42f3d40b63e3.png)
5) License Acceptを「true」、Storage ClassにRWXをサポートするStorage Classを選択し、「作成」をクリックします。
![2021-07-15_13h15_53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/37e1816b-21dd-1194-ba4e-6ebfb2e13415.png)
6)Platform Navigatorが作成されます。ステータスがReadyになるまでしばらく時間（数十分）がかかります。
![2021-07-15_13h22_13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/f5af3da0-1cae-6918-01bd-821c2c7bc9e6.png)
7)ステータスがRedyになったら、名前のところをクリックし、詳細画面に遷移します。
![2021-07-15_15h26_57.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/a61f7cc9-bddb-b9b8-9577-1d66d11f4085.png)
8)Platform Navigator UIのリンクをクリックすると、Platform Navigatorの管理画面が表示されます。
![2021-07-15_15h28_38.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/12d10c08-8fd9-5825-7002-37578c41ce5f.png)
9)認証タイプの選択が出たら、「IBM提供の資格情報（管理者のみ）」をクリックします。
![2021-07-16_16h51_07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/f91ce77d-1667-7146-1fce-c24f2b40f248.png)
10)ユーザー名とパスワードを入力し、ログインします。
![2021-07-15_15h31_10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/2bad4585-41cf-eef1-e5fe-a7b31759d3b2.png)
※ユーザー名とパスワードは、シークレット「platform-auth-idp-credentials」から確認可能です。
![2021-07-15_15h35_45.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/5649d317-d996-e2f8-2487-cde681ff8717.png)


##### 2.2.5. API Connect の導入

以下の手順にて、API Connect を導入します。

1)Platform Navgiator にアクセスします。
2)メニューから「Integration capabilities」を選択します。
![2021-07-15_15h42_50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/3a8b8183-da0e-b3b9-7496-4b69cd62618e.png)
3)「Create capability」をクリックします。
![2021-07-15_15h45_41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/4429b4a9-1d01-e7fb-136d-57b606247cfe.png)
4)「API Management」を選択し、「Next」をクリックします。
![2021-07-15_15h48_04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/be33e98b-33d5-66d8-5a4f-9b66d8ee7450.png)
5)ここでは、最小限の環境の「One Node- Minimum」を選択し、「Next」をクリックします。
![2021-07-15_15h51_53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/7a07a64f-c9cc-b680-c318-b312a2d3c5b9.png)
6)LicenseやStorage class等必要な項目を入力し、「Create」をクリックします。
![2021-07-15_15h54_30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/a5471f90-fc32-4301-08b7-501a411ce58d.png)
7)Integration capabilityが作成されます。ステータスがReadyになるまでしばらく時間（1時間以上）がかかります。
![2021-07-16_16h56_33.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1740352/bc04c86f-39d1-e65a-8bf6-bf5f2d1adf67.png)
8) ステータスがRaedyなれば導入完了です。