2.2. API Designer をサービスとして OpenShift 3.11 プロジェクトに追加

コマンドラインから API Designer テンプレートをデプロイすることで、API Designer をサービスとして OpenShift 3.11 プロジェクトに追加できます。

前提条件

  • OpenShift システム管理者が推奨するガイドラインに従って、API Designer へのアクセスが可能なホスト名を取得します。

  • コマンドウィンドウで以下のコマンドを実行して、Fuse on OpenShift イメージとテンプレート (apidesigner-ui および fuse-apidesigner-generator を含む) が OpenShift クラスターにインストールされていることを確認します。 

    oc get is -n openshift

    イメージおよびテンプレートが事前にインストールされていない場合や、提供されたバージョンが古い場合は、Fuse on OpenShift Guide に説明されているように Fuse on OpenShift イメージおよびテンプレートをインストール (または更新) します。

手順

コマンドラインから API Designer サービスを追加するには、以下を実行します。

  1. コマンドウィンドウで、OpenShift サーバーにログインします。 

    oc login -u developer -p developer

  2. 新規プロジェクト namespace を作成します。たとえば、以下のコマンドは myproject という名前の新規プロジェクトを作成します。 

    oc new-project myproject

  3. 次のコマンド (myprojectはプロジェクトの名前) を実行して、APIDesigner テンプレートに基づいて新しいアプリケーションを作成します。 

    oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fuse-apicurito.yml -p ROUTE_HOSTNAME=myhost

    注: オプションで、oc new-app コマンドに追加の -p オプションを追加することにより、他のテンプレートパラメーターを指定できます。たとえば、Fuse on OpenShift イメージおよびテンプレートをデフォルトの openshift namespace 以外の namespace にインストールしている場合、IMAGE_STREAM_NAMESPACE を設定して、Fuse イメージストリームがインストールされている namespace を指定できます。 

    oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fuse-apicurito.yml -p ROUTE_HOSTNAME=myhost -p IMAGE_STREAM_NAMESPACE=othernamespace

  4. 以下のコマンドを実行して、API Designer デプロイメントのステータスおよび URL を取得します。 

    oc status

    API Designer がデプロイされていない場合は、次のコマンドを実行して、正しいバージョンの apicurito-ui および fuse-apicurito-generator イメージがインストールされていることを確認します。 

    oc get is -n openshift | grep "apicurito"
  5. ブラウザーから API Designer にアクセスするには、提供される URL (例: https://apicurito.192.168.64.12.nip.io) を使用します。