新しい Edge UI を構成する

このドキュメントでは、Apigee Edge for Private Cloud 用の新しい Edge UI をインストールして構成する方法について説明します。バージョン 4.54.00 では、新しい Edge UI は次の 2 つの RPM コンポーネントで構成されています。

  • edge-management-ui: 新しい Edge UI バックエンド サーバー。
  • edge-management-ui-static: 新しい Edge UI フロントエンドの静的ウェブ アセット。

新しい Edge UI は、setup.sh を aio（オールインワン）、sa（スタンドアロン）、ms（管理 サーバー）プロファイルで実行するとデフォルトでインストールされます。また、ue プロファイルを使用してノードに個別にインストールすることもできます。

前提条件

Apigee Edge for Private Cloud のインストールで新しい Edge UI をインストールまたは構成する前に、ノードが 次の要件を満たしていることを確認してください。

  • ハードウェアと OS の要件:
    • 4 GB の RAM
    • 2 個の CPU コア
    • 60 GB のディスク容量
    • Edge apigee-setup ユーティリティのインストールの説明に従って、 ノードにインストールされた apigee-setup ユーティリティの 4.54.00 バージョン。
    • ポート 3001 が開いている必要があります。これは、新しい Edge UI へのリクエストに使用されるデフォルトのポートです。新しい Edge UI 構成ファイルで説明されている プロパティを使用してポートを変更する場合は、 そのポートが開いていることを 確認してください。
  • 認証:
    • 基本認証（デフォルト）: デフォルトで有効になっています （AUTH_MODE=basic）。外部 ID プロバイダ（IDP）を必要とせずに、Edge Management Server と SymasLDAP の認証情報を使用します。
    • SSO / 外部 IDP（省略可）: 必要に応じて、 Apigee SSO または外部 IDP（SAML や OIDC など）を構成できます。 TLS 経由で外部 IDP に接続する場合は、IDP が TLS v1.2 以降をサポートしている必要があります。

新しい Edge UI の機能の詳細については、Private Cloud 用の新しい Edge UI をご覧ください。

インストールと構成の概要

` ue` プロファイルを使用して新しい Edge UI をインストールまたは再構成するプロセスは、大まかに次のようになります。

  • apigee-setup ユーティリティがノードにインストールされていることを確認します。
  • サイレント構成ファイルを作成し、設定を変更します。
  • /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. を実行します。これにより、edge-management-ui と edge-management-ui-static の両方がインストールされ、構成されます。
  • http://new_edge_UI_IP:3001 で新しい Edge UI にログインしてテストします。

管理サーバーと新しい Edge UI サーバーが、ロードバランサで TLS オフロードが行われるロードバランサの背後にある場合は、構成に ロードバランサで TLS 終端されるときに新しい Edge UI を構成するでハイライト表示されているプロパティが反映されていることを確認してください。

新しい Edge UI 構成ファイル

次の例は、デフォルトの基本認証を使用して新しい Edge UI をインストールして構成するための構成ファイルを示しています。

基本認証の構成（デフォルト）

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

新しい Edge UI をインストールまたは構成する

ue プロファイルを使用して新しい Edge UI をインストールまたは構成するには:

  1. 管理者としてターゲット ノードにログインします。
  2. ノードに apigee-setup ユーティリティの 4.54.00 バージョンをインストールします。 Edge apigee-setup ユーティリティのインストールの説明に従ってください。
  3. 次のコマンドを実行して、Yum でキャッシュに保存されたすべての情報を消去します。 
    sudo yum clean all
  4. 新しい Edge UI 構成ファイルの説明に従って構成ファイルを作成し、そのファイルが「apigee」ユーザーによって所有されていることを確認します。 
    chown apigee:apigee configFile
  5. ノードで次のコマンドを実行します。 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    apigee-setup ユーティリティは、 edge-management-ui と edge-management-ui-static をインストールして構成します。

  6. ブラウザで次の URL を開いて、新しい Edge UI にログインします。 
    http://new_edge_UI_IP:3001

    ここで、new_edge_UI_IP は、新しい Edge UI をホストするノードの IP アドレスまたはホスト名です。

  7. 認証情報を入力します。

    新しい Edge UI が表示されます。新しい Edge UI の使用方法については、Private Cloud 用の新しい Edge UI をご覧ください。

    新しい Edge UI が表示されない場合は、ポート 3001 が接続用に開いていることを確認してください。

省略可: 認証に Apigee SSO を構成する場合は、Apigee SSO をインストールして構成するの手順と、新しい Edge UI で外部 IDP を有効にするの手順に沿って操作します。

新しい Edge UI をアンインストールする

ノードから新しい Edge UI をアンインストールするには、edge-management-ui と edge-management-ui-static コンポーネントの両方をアンインストールします。

新しい Edge UI コンポーネントをアンインストールするには:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

ノードからすべての Edge コンポーネントを削除するには:

  1. マシンで実行されているすべての Edge サービスを停止します。 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. yum キャッシュを消去します。 
    sudo yum clean all
  3. すべての Apigee RPM を削除します。 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. インストール ルート ディレクトリを削除します。 
    sudo rm -rf /opt/apigee