2.2. API Designer をサービスとして OpenShift 3 プロジェクトに追加
OpenShift サービスカタログから、API Designer をサービスとして OpenShift 3 プロジェクトに追加できます。このインスタンスは、OpenShift 環境外の URL からアクセスできます。
前提条件
- 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 を OpenShift プロジェクトにサービスとして追加するには、以下を実行します。
コマンドウィンドウで、OpenShift サーバーにログインします。
oc login -u developer -p developer
新規プロジェクト namespace を作成します。たとえば、以下のコマンドは test という名前の新規プロジェクトを作成します。
oc new-project test
-
Web ブラウザーで OpenShift コンソールを開き、認証情報 (例: ユーザー名
developerおよびパスワードdeveloper) を使用してログインします。 Catalog をクリックします。カタログ検索フィールドに
API Designerを入力してから Red Hat Fuse API Designer を選択します。Red Hat Fuse API Designer ウィザードの Information ステップが開きます。
Next をクリックします。
Red Hat Fuse API Designer ウィザードの Configuration ステップが開きます。
-
Image Stream Namespace フィールドに、
openshiftを入力します。 -
ROUTE_HOSTNAME フィールドに、API Designer インスタンスへのアクセスを可能にする外部ホスト名を入力します (例:
apidesigner-myproject.192.168.64.43.nip.io)。 Configuration ステップの残りの設定についてデフォルトの値を受け入れ、 Create をクリックします。
テンプレートウィザードの Results ステップが開きます。
- Close をクリックします。
OpenShift Web コンソールの My Projects ペインで、プロジェクト (例: test) を選択します。
プロジェクトの Overview タブが開き、apidesigner-ui アプリケーションが表示されます。
- apidesigner-ui デプロイメントの左側にある矢印をクリックして、デプロイメントの詳細情報を展開し、表示します。
API Designer インスタンスのリンクをクリックします (例:
https://apidesigner-myproject.192.168.64.43.nip.io)。API Designer が新規の Web ブラウザーウィンドウまたはタブで開きます。
API Designer インスタンスを開くことができない場合は、以下の構文を使用して、コンピューターの /etc/hosts ファイルを編集して ROUTE_HOSTNAME を追加する必要がある場合があります。ここで、$OPENSHIFT_IP_ADDR は OpenShift サーバーの IP アドレスであり、apidesigner.my-minishift.apicurio.io はステップ 7 で指定した ROUTE_HOSTNAME です。
$OPENSHIFT_IP_ADDR apidesigner.my-minishift.apicurio.io
