このページは Cloud Translation API によって翻訳されました。

Edge のインストールの概要

Edge for Private Cloud v. 4.17.05

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

インストールプロセス

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

ノード上の SELinux を無効にするか、制限なしモードに設定します。詳細については、Edge apigee-setup ユーティリティをインストールするをご覧ください。できます。
Cassandra 認証を有効にするかどうかを決定します。
Postgres にマスター / スタンバイレプリケーションを設定するかどうかを決定します。
推奨トポロジのリストから Edge 構成を選択します。たとえば、 Edge は、テスト用には単一ノードに、本番環境用には 13 ノードにインストールできます。詳細については、インストールトポロジをご覧ください。
選択したトポロジの各ノードに、Edge apigee-setup ユーティリティをインストールします。 <ph type="x-smartling-placeholder">
- Edge の bootstrap_4.17.05.sh ファイルを /tmp/bootstrap_4.17.05.sh にダウンロードします。
- Edge apigee-service ユーティリティをインストールします。確認します。
- Edge apigee-setup ユーティリティと依存関係をインストールします。
  
  Edge apigee-setup のインストールユーティリティをご覧ください。
選択したトポロジに基づいて、apigee-setup ユーティリティを使用して 1 つ以上の Edge コンポーネントをノードにインストールします。
Google Cloud コンソールのノードに Edge コンポーネントをインストールするをご覧ください。あります。
Management Server ノード上で、apigee-setup ユーティリティを使用して、Edge 組織の作成と管理に使用するユーティリティである apigee-provision をインストールします。
詳細については、組織のオンボーディングをご覧ください。

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

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

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

apigee-service ユーティリティ: <ph type="x-smartling-placeholder">
- 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 ユーティリティコマンド。次のものがあります。
- 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 コマンドでアクセスできます。

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

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

Edge のインストールプロセス全体を root ユーザーか sudo フルアクセス権限のあるユーザーによって実行することが最も簡単な方法ですが、常にこのようにできるとは限りません。代わりに、ラベルをロールを持つタスクと、権限のあるユーザーが実行するタスクに分けることができます。「apigee」への sudo フルアクセス権できます。

root が実行するタスク:
1. bootstrap_4.17.05.sh ファイルをダウンロードして実行します。
  >curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  >sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
  
  このステップでは、apigee-service ユーティリティがインストールされ、「apigee」できます。
2. 「apigee」への sudo フルアクセスを持つようにユーザーを構成する説明のとおりです。ご覧ください。
3. apigee-setup ユーティリティをインストールします。
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
4. apigee-setup ユーティリティを使用してノード上のエッジ RPM:
  > /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 のいずれかを選択します。
root ユーザーがノードに Edge RPM をインストールすると、「apigee」への sudo フルアクセス権構成プロセスを完了します。
1. setup.sh ユーティリティを使用して、ノード上の Edge コンポーネントの構成を完了します。コマンドの形式は、ノードにインストールしたコンポーネントによって異なります。完全なリストについては、ノードに Edge コンポーネントをインストールするをご覧ください。
  たとえば、ZooKeeper と Cassandra のインストールを完了するには、次のコマンドを使用します。
  > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  
  ここで、configFile は Edge 構成ファイルです。
  
  オールインワンインストールを実行するには、次のコマンドを使用します。
  > /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 リポジトリを作成するには、外部インターネットを持つノードが必要ですアクセスする必要があります。内部リポジトリを作成したら、そのリポジトリを別のノードに移動したり、そのノードを Edge ノードからアクセスできるようしたりして、インストールに使用できます。

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

ローカルリポジトリやミラーリングされたリポジトリを使用する理由の 1 つは、前のセクションで説明したように、外部インターネット接続がないノードに 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 Cloud がデプロイされます。

ログファイル

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 Server	/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
Qpidd	/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
Qpidd	/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 を更新すると、/opt/apigee/customer/application ディレクトリの .properties ファイルが読み取られます。つまり、コンポーネントで設定したプロパティは更新後も保持されます。

詳細については、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
バックアップ、復元
インストール、アンインストール

Edge のインストールの概要

インストール プロセス

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

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

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

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

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

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