2.3. OpenShift 4.x への API Designer のインストール
Red Hat Fuse on OpenShift では、REST API の設計に使用できる Web ベースの API デザイナーツールである API Designer が提供されます。API Designer Operator を使用すると、OpenShift Container Platform 4.x で API Designer を簡単にインストールおよびアップグレードできます。
OpenShift 管理者として、API Designer Operator を OpenShift プロジェクト (namespace) にインストールします。Operator はインストール後に、選択された namespace で実行されます。しかし、API Designer をサービスとして使用できるようにするには、OpenShift 管理者または開発者が API Designer のインスタンスを作成する必要があります。API Designer サービスによって、API Designer Web コンソールにアクセスするための URL が提供されます。
前提条件
- OpenShift クラスターの管理者権限を持っている必要があります。
- Red Hat コンテナーレジストリーへの認証が設定されている必要があります。
手順
- OpenShift 4.x サーバーを起動します。
- Web ブラウザーで OpenShift コンソールに移動します。ご自分のクレデンシャルでコンソールにログインします。
- Catalog をクリックした後、OperatorHub をクリックします。
検索フィールドに API Designer を入力します。
右側のパネルに API Designer カードが表示されます。
- API Designer をクリックします。API Designer Operator のインストールウインドウが表示されます。
Install をクリックします。Create Operator Subscription フォームが表示されます。
- Installation mode では、クラスターの namespace のリストから namespace (プロジェクト) を 1 つ選択します。
Approval Strategy では、Automatic または Manual を選択し、API Designer Operator の更新が OpenShift によってどのように対処されるかを設定します。
- Automatic (自動) 更新を選択した場合、新しいバージョンの API Designer Operator が使用できるようになると、人的な介入なしで OpenShift Operator Lifecycle Manager (OLM) によって、API Designer の稼働中のインスタンスが自動的にアップグレードされます。
- Manual (手動) 更新を選択した場合、Operator の新しいバージョンが使用できるようになると、OLM によって更新リクエストが作成されます。クラスター管理者は、更新リクエストを手動で承認して、API Designer Operator を新しいバージョンに更新する必要があります。
- Subscribe をクリックして、指定の namespace (プロジェクト) で API Designer Operator を使用できるようにします。
- API Designer がプロジェクトにインストールされていることを確認するには、Operators をクリックした後、Installed Operators をクリックし、リストに API Designer があることを確認します。
次のステップ
API Designer Operator のインストール後、API Designer のインスタンスを作成し、API Designer をサービスとして OpenShift プロジェクトに追加する必要があります。このタスクを実行する方法は 2 つあります。
- OpenShift 管理者は、「API Designer をサービスとして OpenShift 4.x プロジェクトに追加」 の手順を実行します。
OpenShift 開発者は、API の設計 に記載されている手順を実行できます。
API Designer サービスによって、API Designer Web コンソールにアクセスするための URL が提供されます。
2.3.1. API Designer をサービスとして OpenShift 4.x プロジェクトに追加 リンクのコピーリンクがクリップボードにコピーされました!
API Designer Operator を OpenShift 4.x プロジェクトにインストールした後、OpenShift 開発者はこれをサービスとして OpenShift プロジェクトに追加できます。開発者が API Designer Web コンソールへアクセスするために使用する URL は API Designer サービスによって提供されます。
OpenShift 開発者が API Designer をサービスとして OpenShift 4.x プロジェクトに追加するための手順は、API の設計 を参照してください。
前提条件
- OpenShift クラスターの管理者権限を持っている必要があります。
- API Designer Operator は現在の OpenShift プロジェクトにインストールされます。
手順
- OpenShift Web コンソールで、Operators をクリックした後、Installed Operators をクリックします。
- Name 列で、API Designer をクリックします。
Provided APIs の Create Instance をクリックします。
API Designer インスタンスの最小限の開始テンプレートがあるデフォルトのフォームが開かれます。
デフォルト値を使用するか、任意で以下の値を編集します。
size: API Designer インスタンスの Pod の数。
デフォルトは、API Designer の管理に特化したロジックが含まれる 3 つの新規リソースタイプの 3 つの Pod になります。
- image: API Designer イメージ。このイメージを変更すると、API Designer Operator はクラスターで自動的にアップグレードされます。
- Create をクリックし、新しい apicurito-service を作成します。OpenShift は、新しい API Designer サービスの Pod、サービス、およびその他のコンポーネントを起動します。
API Designer サービスが使用できることを確認するには、以下を実行します。
- Operators をクリックした後、Installed Operators をクリックします。
Provided APIs 列で Apicurito CRD をクリックします。
Operator Details ページに、apicurito-service のリストが表示されます。
API Designer の URL を取得するには、以下を行います。
- Networking > Routes をクリックします。
- 正しいプロジェクトが選択されていることを確認してください。
- apicurito-service 行で、Location 列にある API Designer Web コンソールの URL を見つけます。
2.3.2. OpenShift 4.x での API Designer のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift 4.x では、Red Hat Fuse Operator などの Operator の更新が処理されます。詳細は、OpenShift ドキュメントの Operator を参照してください。
また、Operator の更新によってアプリケーションのアップグレードがトリガーされる可能性があります。アプリケーションのアップグレードの実行方法は、アプリケーションの設定によって異なります。
API Designer アプリケーションでは、API Designer Operator をアップグレードすると、OpenShift によってクラスターの API Designer アプリケーションもアップグレードされます。
OCP 4.6 以降、API Designer Operator (Apicurito Operator) の Operator チャネルの名前が alpha から fuse-apicurito-7.7.x に変更されました。OpenShift を OCP 4.6 にアップグレードした後に新しい operator チャンネルが表示されない場合は、既知の問題 ENTESB-15232 を参照し、OpenShift の OperatorHub から表示される operator チャンネルを更新する方法を確認してください。