Edge のインストールの概要

Edge for Private Cloud v. 4.17.09

一般的な Edge インストール環境は、複数のノードに分散された Edge コンポーネントで構成されます。 Edge をノードにインストールした後、1 つ以上の Edge コンポーネントをノードにインストールして構成します。 作成されます。

インストール プロセス

ノードへの Edge のインストールは、複数のステップから成ります。

  • ノードで SELinux を無効にするか、permissive モードに設定します。詳細については、Edge apigee-setup ユーティリティをインストールするをご覧ください。 できます。
  • Cassandra 認証を有効にするかどうかを決定します。
  • Postgres にマスター / スタンバイ レプリケーションを設定するかどうかを決定します。
  • 推奨トポロジのリストから Edge 構成を選択します。たとえば、 Edge は、テスト用には単一ノードに、本番環境用には 13 ノードにインストールできます。詳細については、インストール トポロジをご覧ください。
  • 選択したトポロジの各ノードに、Edge apigee-setup ユーティリティをインストールします。 <ph type="x-smartling-placeholder">
      </ph>
    • Edge の bootstrap_4.17.09.sh ファイルをダウンロードします。 /tmp/bootstrap_4.17.09.sh
    • Edge apigee-service ユーティリティをインストールします。 確認します。
    • Edge apigee-setup ユーティリティと依存関係をインストールします。

      Edge apigee-setup のインストール ユーティリティをご覧ください。
  • apigee-setup を使用する ユーティリティを使用して、選択した構成に基づいて各ノードに 1 つ以上の Edge コンポーネントをインストールします。 構成されます
    Google Cloud コンソールのノードに Edge コンポーネントをインストールするをご覧ください。 あります。
  • Management Server ノードで、apigee-setup ユーティリティを使用して apigee-provision をインストールします。 Edge 組織の作成と管理に使用するユーティリティ。
    詳細については、組織のオンボーディングをご覧ください。

インストールを実行できるユーザー

Apigee Edge 配布ファイルは、一連の RPM と依存関係としてインストールされます。宛先 Edge RPM のインストール、アンインストール、更新を行うには、root ユーザーまたはユーザーがコマンドを実行する必要があります。 権限があります完全な sudo アクセス権とは、ユーザーが実行するための sudo アクセス権があることを意味します。 root と同じ操作を行います。

以下のコマンドまたはスクリプトを実行するユーザーは、root であるか、ユーザーである必要があります。 sudo 完全アクセス権あり:

  • apigee-service ユーティリティ: <ph type="x-smartling-placeholder">
      </ph>
    • apigee-service コマンド: install、uninstall、update
    • apigee-all コマンド: install、uninstall、update
  • Edge コンポーネントをインストールする setup.sh スクリプト( 「apigee-service install」から インストールします。不要な場合は root アクセス権または sudo フルアクセス権が必要です)。
  • Edge コンポーネントを更新する update.sh スクリプト

また、Edge インストーラによって、システム上に「apigee」という名前の新しいユーザーが作成されます。多数の Edge コマンド sudo を呼び出して「apigee」として実行するできます。

上記以外のすべてのコマンドを実行するには、 「apigee」への sudo フルアクセス権できます。たとえば、次のようなコマンドです。

  • 次のような apigee-service ユーティリティ コマンド <ph type="x-smartling-placeholder">
      </ph>
    • start、stop、restart、configure などの apigee-service コマンド。
    • apigee-all コマンド(start、stop、restart、configure など)。

以下を使用してユーザーを作成する 「apigee」への sudo フルアクセス権ユーザー

「apigee」へのフル sudo アクセス権をユーザーが持つように構成します。「visudo」を使用します。コマンドを sudoers ファイルを編集して以下を追加します。

installUser        ALL=(apigee)      NOPASSWD: ALL

ここで、installUser は作業する担当者のユーザー名です。 。

権限の設定 構成ファイルを

Edge コマンドで使用するファイルやリソースには、apigee からアクセスできる必要があります。できます。この Edge ライセンス ファイルとすべての構成ファイルが含まれています。

構成ファイルを作成するときに、ファイルのオーナーを「apigee:apigee」に変更できます。確実に保存し、 Edge コマンドでアクセスできます。

  1. エディタで、任意のユーザーとしてファイルを作成します。
  2. ファイルのオーナーを「apigee:apigee」に変更するEdge を実行しているユーザーを変更した場合や、 「apigee」からEdge を実行しているユーザーにファイルの変更を許可する あります。

分離 root ユーザーと非 root ユーザー間のエッジ インストール タスク

Edge のインストール プロセス全体を実行するのは、root として実行するか、インストールを行ったユーザーが sudo フルアクセスが付与されるため、常に可能とは限りません。代わりに、ラベルを ロールを持つタスクと、権限のあるユーザーが実行するタスクに分けることができます。 「apigee」への sudo フルアクセス権できます。

  1. root が実行するタスク: <ph type="x-smartling-placeholder">
      </ph>
    1. bootstrap_4.17.09.sh ファイルをダウンロードして実行します。
      &gt;curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      &gt;sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord


      このステップでは、apigee-service ユーティリティがインストールされ、 「apigee」できます。
    2. 「apigee」への sudo フルアクセスを持つようにユーザーを構成する説明のとおりです。 ご覧ください。
    3. apigee-setup ユーティリティをインストールします。
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. apigee-setup ユーティリティを使用して ノード上のエッジ RPM:
      &gt; /opt/apigee/apigee-service/bin/apigee-service compName インストール

      ノードにインストールする Edge RPM は、トポロジによって異なります。使用可能な コンポーネントには、apigee-provision、 apigee-validate、apigee-zookeeper、apigee-cassandra、apigee-openldap、edge-ui、 Edge-management-server、edge-ui、edge-router、 Edge-message-processor、apigee-postgresql、apigee-qpidd、edge-postgres-server、edge-qpid-server のいずれかを選択します。
  2. root ユーザーがノードに Edge RPM をインストールすると、 「apigee」への sudo フルアクセス権構成プロセスを完了します。
    1. setup.sh を使用する ユーティリティを使用してノード上の Edge コンポーネントの構成を完了します。Pod の コマンドは、ノードにインストールしたコンポーネントによって異なります。完全なリストについては、 Edge コンポーネントをノードにインストールする
      たとえば、ZooKeeper と Cassandra のインストールを完了するには、次のコマンドを使用します。 コマンド:
      &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      ここで、configFile は Edge 構成ファイルです。

      オールインワン インストールを実行するには、次のコマンドを使用します。
      &gt; /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

インストール構成の場所 ファイル

環境変数を含む apigee-setup ユーティリティに構成ファイルを渡す必要があります。 詳細情報を確認できます。サイレント インストールの唯一の要件は、 構成ファイルが「apigee」からアクセス可能または読み取り可能になっている必要があります。できます。たとえば、 /usr/local/var または /usr/local/share ディレクトリ 「apigee:apigee」に変更する必要があります。

エッジシステムを除くすべての構成ファイル内の情報が必要です 入力します。パスワードを省略すると、apigee-setup ユーティリティによってパスワードの入力を求められます。 指定します。

詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。 できます。

インストール エラーの処理

Edge コンポーネントのインストール中にエラーが発生した場合は、 インストーラを再度実行します。インストーラは、 障害を検出した場合や、後でコンポーネントの変更または更新が必要になった場合に インストールできます。

インターネットまたはインターネット以外のインストール

Edge をノードにインストールするには、そのノードが Apigee リポジトリにアクセスできる必要があります。

  • 外部インターネット接続があるノード

    外部インターネット接続があるノードは、Apigee リポジトリにアクセスして Edge をインストールします。 RPM と依存関係
  • 外部インターネット接続がないノード

    外部インターネット接続がないノードでも、ミラーリングされたバージョンの Apigee にアクセスできます 内部でセットアップしたリポジトリです。このリポジトリにはすべての Edge RPM が格納されていますが、 他の依存関係が内部リポジトリのリポジトリから利用可能であることを 接続します

    : Apigee では、すべてのサードパーティの依存関係を できます。これらの依存関係は、一般公開されているものからダウンロードしてインストールする必要があります。 できます。

    内部 Apigee リポジトリを作成するには、外部インターネットを持つノードが必要です アクセスする必要があります。新しい P-MAX キャンペーンを そのリポジトリを別のノードに移動したり、そのノードに Edge からアクセスできるようにしたりすることが可能です。 作成します。

ローカルの Edge リポジトリを使用して、 Edge の

ローカル(ミラーリング)リポジトリを使用する理由の一つは、ノードに Edge をインストールするためです。 外部インターネット接続なしで使用できます。

ただし、外部リポジトリがあるノードであっても、ローカル リポジトリを使用することには インターネット接続ですApigee 公開リポジトリから Edge をインストールすると、 最新の Edge RPM です。そのため、特定のアプリケーション用に Edge RPM をダウンロードして保存し、 その Edge バージョンのローカル リポジトリを作成する必要があります。そのデータを使用して ローカル リポジトリを使用して、任意のバージョンの Edge のインストールを実行できます。

たとえば、最初にローカル リポジトリを使用して Edge 開発環境をインストールします。その後、 本番環境に移行する準備ができたら、ローカルから Edge を リポジトリをご覧ください。ローカル リポジトリからインストールすることで、開発環境と本番環境が 環境が一致します。

ミラーリングされたリポジトリは柔軟性に優れています。たとえば、Terraform からミラーリングされたリポジトリを 最新の Edge RPM または特定のバージョンの Edge から入手できます。リポジトリを作成したら、リポジトリを 異なる Edge バージョンの RPM を追加するように更新する必要があります。詳細については、Edge apigee-setup ユーティリティをインストールするをご覧ください。 できます。

RPM インストールの依存関係を解決する

Apigee Edge 配布ファイルは、RPM ファイルのセットとしてインストールされます。各ファイルには、 独自のインストール依存関係のチェーンを構築します。これらの依存関係の多くは、サードパーティ Apigee の管理外で、いつでも変更される可能性があります。したがって、 ドキュメントに各依存関係の明示的なバージョン番号が記載されていません。

インターネットにアクセスできるマシンにインストールを実行する場合は、 パッケージ化されています。ただし、インターネット接続がないノードからインストールする場合、 アクセスするには、通常は必要な依存関係をすべて含む内部リポジトリを設定します。唯一の方法 インストールを試行するため、すべての依存関係がローカル リポジトリに含まれていることを保証します。 不足している依存関係を特定し、インストールまでローカル リポジトリにコピーします 成功します。

一般的な Yum コマンド

Linux 用の Edge インストール ツールは、Yum を使用してコンポーネントのインストールと更新を行います。もしかしたら、 ノードでのインストールを管理するには、いくつかの Yum コマンドを使用する必要があります。

  • すべての Yum キャッシュを削除します。
    sudo yum clean all
  • Edge コンポーネントを更新するには:
    sudo yum update componentName
    例:
    sudo yum update apigee-setup
    sudo yum update edge-management-server

ファイル システム構造

Edge では、すべてのファイルが /opt/apigee ディレクトリにインストールされます。

このガイドと Edge オペレーション ガイドでは、ルート インストール ディレクトリは 例:

/opt/apigee

インストールでは、次のファイル システム構造を使用して Apigee Edge for Private をデプロイします 説明します。

ログファイル

apigee-setup のログファイル setup.sh スクリプトは /tmp/setup-root.log に書き込まれます。

各コンポーネントのログファイルは /opt/apigee/var/log ディレクトリに格納されます。各コンポーネント 独自のサブディレクトリがあります。たとえば、Management Server のログは ディレクトリ:

/opt/apigee/var/log/edge-management-server

次の表に、ログファイルの場所を示します。

コンポーネント

ロケーション

管理サーバー

/opt/apigee/var/log/edge-management-server

ルーター

/opt/apigee/var/log/edge-router

Edge Router は Nginx を使用して実装されています。その他のログについては、以下をご覧ください。

/opt/apigee/var/log/edge-router/nginx

/opt/nginx/logs

Message Processor

/opt/apigee/var/log/edge-message-processor

Apigee Qpid サーバー

/opt/apigee/var/log/edge-qpid-server

Apigee Postgres サーバー

/opt/apigee/var/log/edge-postgres-server

Edge UI

/opt/apigee/var/log/edge-ui

ZooKeeper

/opt/apigee/var/log/apigee-zookeeper

OpenLDAP

/opt/apigee/var/log/apigee-openldap

Cassandra

/opt/apigee/var/log/apigee-cassandra

クピッド

/opt/apigee/var/log/apigee-qpidd

PostgreSQL データベース

/opt/apigee/var/log/apigee-postgresql

データ

コンポーネント

ロケーション

管理サーバー

/opt/apigee/data/edge-management-server

ルーター

/opt/apigee/data/edge-router

Message Processor

/opt/apigee/data/edge-message-processor

Apigee Qpid エージェント

/opt/apigee/data/edge-qpid-server

Apigee Postgres エージェント

/opt/apigee/data/edge-postgres-server

ZooKeeper

/opt/apigee/data/apigee-zookeeper

OpenLDAP

/opt/apigee/data/apigee-openldap

Cassandra

/opt/apigee/data/apigee-cassandra/data

クピッド

/opt/apigee/data/apigee-qpid/data

PostgreSQL データベース

/opt/apigee/data/apigee-postgres/pgdata

インストール後のタスク

インストールが完了したら、Edge コンポーネントに対して追加の操作を実行できます。

Edge の構成 インストール後のコンポーネント

インストール後に Edge を構成するには、.properties ファイルと Edge ユーティリティを組み合わせて使用します。対象 たとえば、Edge UI で TLS/SSL を構成するには、.properties ファイルを編集して 指定する必要があります。.properties ファイルに変更を加えるには Edge コンポーネントを再起動します。

.properties ファイルは次の場所にあります。 /opt/apigee/customer/application ディレクトリにコピーします。 このディレクトリには、コンポーネントごとに独自の .properties ファイルがあります。 例: router.properties management-server.properties です。

コンポーネントのプロパティを設定するには、対応する .properties ファイルを編集してから再起動する 行います。

> /opt/apigee/apigee-service/bin/apigee-service component restart

例:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Edge を更新すると、アプリケーションの .properties ファイルが /opt/apigee/customer/application ディレクトリが読み取られます。つまり、コンポーネントで設定したプロパティは更新後も保持されます。

詳細については、Edge の構成方法をご覧ください。 エッジ構成。

Edge でのコマンドの呼び出し コンポーネント

Edge では、管理ユーティリティが /opt/apigee/apigee-service/bin にインストールされ、 管理するために使用します。たとえば、apigee-all ユーティリティを使用して、コンテナの起動、停止、再起動、 または、ノード上のすべての Edge コンポーネントのステータスを確認します。

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

apigee-service ユーティリティを使用する 個別のコンポーネントを制御および構成できます。apigee-service ユーティリティの形式は次のとおりです。

/opt/apigee/apigee-service/bin/apigee-service component action

たとえば、Edge Router を再起動するには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

ノードにインストールされているコンポーネントの一覧は、/opt/apigee ディレクトリを調べることで確認できます。このディレクトリ には、ノードにインストールされているすべての Edge コンポーネントのサブディレクトリが含まれています。各サブディレクトリは、 先頭に次の文字列を追加します。

  • apigee - サードパーティ 使用されます。たとえば、apigee-cassandra です。
  • edge - Edge コンポーネント Apigee からデプロイできます。例: edge-management-server
  • edge-mint - 収益化 説明します。例: edge-mint-management-server
  • baas - API BaaS 説明します。例: baas-usergrid

コンポーネントに対するアクションの完全なリストはコンポーネント自体によって異なりますが、 次のアクションをサポートしています。

  • 起動、停止、再起動
  • status、version
  • バックアップ、復元
  • インストール、アンインストール