IBM Blue Demoで最新のAPI Connect v2018.4.1(LTS)をインストール&動かしてみた

# はじめに
最新のAPI Connect v2018.4.1を簡単に動かせる環境についてご紹介します。

API Connect v2018はKubernetes対応しましたが、dockerやKubernetesに馴染みのない人には、なかなかインストールして動かすのが大変です。(これまで通り、VMイメージの提供もありますが、VMイメージ内もKubernetes環境で稼働しています。)
そこで、利用できる期間は限られますが無料で簡単にインストールを体験でき動かせる環境をご紹介します。（2019年4月現在、最新の[v2018.4.1.4](https://www-01.ibm.com/support/docview.wss?uid=ibm10878320)の環境を触ることが可能です。）

# IBM Blue Demoって
[IBM Blue Demo](https://bluedemos.com/)とは、技術営業向けにIBM製品のデモ資産の統合カタログを提供するサイトです。統合カタログということから、様々なIBM製品のビデオ、ドキュメント、シミュレーション、VM(仮想マシン)、IBM Cloudなどのホストされたデモ環境をまとめたものとなっています。

このサイトには、IBM IDを持っているビジネスパートナーやお客様も含めて基本アクセスすることが可能です。ただし、デモ資産によっては利用できないものもあるようです。

仮想マシンの環境は、事前設定されたSkytapというホスティング環境で用意されます。Skytapは動的なホスティング環境を提供するIBMのパートナーです。 Blue Demos Skytap環境は、IBM Cloudデータセンターで稼働しているようです。デモの多くは複数のデータセンターでホストされているため、最も近いデータセンターを選択できます。センターとしては、US Central（ダラス）、EMEA（ロンドン）、およびAPAC（シンガポール）のいずれかにアクセスできます。

Skytapに関しては、使用条件等(お客様データは利用できない、VMイメージはダウンロードできないなど)もありますので詳しくは[こちら](https://bluedemos.com/help)を確認ください。


# API Connect v2018.4.1をインストールしてみた
このBlue Demoで、最新のAPI Connect v2018.4.1のVM環境「[IBM API Connect 2018.4.1.x (LTS) Automated Installation and Configuration through REST Interface](https://bluedemos.com/show/1908)」が提供されているため、こちらを利用して動かしてみます。

'Reserve a demo' をクリックし、必要項目を記入します。
![reserve01.png](https://qiita-image-store.s3.amazonaws.com/0/121209/b0286841-8705-329b-8800-7bbd1224cba0.png)
予約が行われると２通メールが送られてきます。２通目のメールに環境へアクセスするための情報が含まれます。URLリンクにアクセスするとパスワードを求められるため、メール記載のパスワードを入力します。
![スクリーンショット 2019-04-10 10.39.35.png](https://qiita-image-store.s3.amazonaws.com/0/121209/ededcaa1-862a-c298-1552-557e12f23f66.png)
パスワード入力後、利用できるVMが表示されます。
![スクリーンショット 2019-04-08 10.13.42.png](https://qiita-image-store.s3.amazonaws.com/0/121209/2a1e988c-d8ef-282c-6f49-3e673426d232.png)
Skytap環境のVM(12core、48GBmemory、320GB)が払い出されているので、VMをクリックすると画面が拡大され、さらにクリックするとVMの起動が始まります。
![スクリーンショット 2019-04-08 10.14.02.png](https://qiita-image-store.s3.amazonaws.com/0/121209/60e9d49f-5655-7a44-da2d-019b70106463.png)
ブラウザー内でVMイメージを操作することが可能です。最初にsysadminのパスワードが求められますが、このパスワードは「[IBM API Connect 2018.4.1.x (LTS) Automated Installation and Configuration through REST Interface](https://bluedemos.com/show/1908)」に記載のある 'engageibm18' を入力します。
![スクリーンショット 2019-04-08 10.19.50.png](https://qiita-image-store.s3.amazonaws.com/0/121209/f1f65512-c60f-58d3-95b6-e6e494fe7760.png)
OSが稼働してきます。デスクトップには、API Designerが入っていることが確認できます。
![スクリーンショット 2019-04-08 10.20.47.png](https://qiita-image-store.s3.amazonaws.com/0/121209/4b17f259-8b33-0653-efa0-495652aaa629.png)
ガイドの手順を進め、API Connectのインストールを実行してみます。パス '/home/sysadmin/run' で 'make work' を実行します。この環境では一つのコマンドで簡単にインストールできるようにスクリプトが用意されており、１コマンド実行でインストールから設定まで実行されています。興味のある方は、'/home/sysadmin/run' 配下のファイルを参照ください。
![スクリーンショット 2019-04-08 10.21.44.png](https://qiita-image-store.s3.amazonaws.com/0/121209/00fee8b1-b188-7b97-e701-33a3ebad8a32.png)

インストールには、20分ほど時間がかかります。
インストール完了後 'kubectl get pods -n apic' コマンドを実行すると、多数のpodが起動しているのが確認できます。シングル構成でインストールされています。
![スクリーンショット 2019-04-10 10.57.31.png](https://qiita-image-store.s3.amazonaws.com/0/121209/e8f9acd2-5ad4-f586-319e-87f8f63482db.png)

#API Connect v2018.4.1を動かしてみた
インストールが完了すると、GUIにアクセスできるようになります。VM内のブラウザーを起動するとブックマークとして、API Connect Cloud Manager, API Connect API Manager, DataPower GUIが登録されています。Cloud Managerにアクセスします。
![スクリーンショット 2019-04-08 10.51.54.png](https://qiita-image-store.s3.amazonaws.com/0/121209/20ae8bcd-9517-3e27-f226-a01f71a265fb.png)
セキュリティの警告が出ますが、Advancedを押して、'Proceed to ・・・'をクリックするとアクセスできるようになります。
![スクリーンショット 2019-04-08 10.52.05.png](https://qiita-image-store.s3.amazonaws.com/0/121209/a866d834-a636-4198-0cd4-00f24bd6021e.png)
Cloud Managerは、ガイドの通り(user admin / password apic4you)でログインできます。
![スクリーンショット 2019-04-08 10.52.38.png](https://qiita-image-store.s3.amazonaws.com/0/121209/1021b8c4-b9fb-fe26-38a9-ce25ec8fad1e.png)
Configure Topologyをクリックすると、Portal, Analytics, DataPowerが構成されているのが確認できます。
![スクリーンショット 2019-04-10 11.13.06.png](https://qiita-image-store.s3.amazonaws.com/0/121209/49402bdf-f0c5-10c5-4570-fc6c68f17cf0.png)
メールサーバーも確認してみます。ホーム画面に戻り 'Manage Resrouces' をクリックします。表示された画面で 'Notifications' タブをクリックします。メールサーバーが登録されているのがわかります。
![スクリーンショット 2019-04-10 13.57.53.png](https://qiita-image-store.s3.amazonaws.com/0/121209/5e87dee1-00a4-6810-a6aa-eb4a5b2312b5.png)
この環境では、[Fakesmtp](http://nilhcem.com/FakeSMTP/#)サーバーを利用し、メールは '/home/sysadmin/fakesmtp/emails' に保存されるようになっています。おおよその設定は、インストール時に全て行われているようです。

次にAPIを公開する組織として、プロバイダー組織を作成します。プロバイダー組織ごとにAPIを管理することが可能です。メニューから'Provider Organizations'をクリックし、'Add'から'Create organization'をクリックします。
![スクリーンショット 2019-04-10 13.36.42.png](https://qiita-image-store.s3.amazonaws.com/0/121209/6be0da05-b66e-c142-a440-5d34d8124988.png)
![スクリーンショット 2019-04-10 13.30.05.png](https://qiita-image-store.s3.amazonaws.com/0/121209/a9f5697e-4554-7169-3b71-c0d2310d81bc.png)


プロバイダー組織の任意の情報を入力します。
![スクリーンショット 2019-04-10 13.35.36.png](https://qiita-image-store.s3.amazonaws.com/0/121209/651948c3-64a6-89b9-1291-25e054139e8d.png)
![スクリーンショット 2019-04-10 13.36.00.png](https://qiita-image-store.s3.amazonaws.com/0/121209/20f728e3-6a73-3556-b357-b133318e8c10.png)
この操作によりプロバイダー組織が作成されました。
![スクリーンショット 2019-04-10 13.33.21.png](https://qiita-image-store.s3.amazonaws.com/0/121209/f761747c-f806-bdbc-bc37-a63ced965953.png)
API ManagerのGUIにもアクセスすることができます。ブラウザーのブックマークからAPI Managerにアクセスし、作成したユーザーの情報でログインしてみます。
![スクリーンショット 2019-04-10 13.45.56.png](https://qiita-image-store.s3.amazonaws.com/0/121209/1b25ab05-0ce7-6c59-2395-64364c42dcc6.png)
これで、APIを作成、公開することが可能です。操作等については、[Knowledge Centerのチュートリアル](https://www.ibm.com/support/knowledgecenter/SSMNED_2018/com.ibm.apic.apionprem.doc/tapim_management_tutorials.html)を参考ください。

ちなみに、DataPower GatewayのGUIもブックマークされていますが、user admin/password adminでログインすることが可能です。

##参考DNS
API ConnectではDNSサーバーが必要ですが、この環境では、[xip.io](http://xip.io/)というIPアドレスをドメインに含む形にしておくと、そのIPアドレスに名前解決される仕組みを利用しています。DNSサーバーとしては、[OpenDNS](https://www.opendns.com/)の(208.67.222.222, 208.67.220.220)が設定されています。


#まとめ
IBM Blue Demo環境を利用して、最新のAPI Connectを動かすことができました。興味のある方は参考ください。