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 コンポーネントをインストールします。 構成されます
  Edge コンポーネントをインストールする ノード上の 1 つのノード上に保持されます。
• 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 として、または 必ずしも可能ではありません。代わりに、プロセスをタスクに分割できます。 「apigee」へのフル sudo アクセス権を持つユーザーが、root で実行されるタスクとタスクを実行できます。

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 を使用する ユーティリティを使用して Edge 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 をインストールすると、root 権限があるユーザーが 「apigee」構成プロセスを完了します。
   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」に Chown します。

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

詳細は、Edge のインストール コンポーネントをご覧ください。

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

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

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

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

• 外部インターネット接続があるノード
  
  外部インターネット接続があるノードは、Apigee リポジトリにアクセスして Edge をインストールします。 RPM と依存関係
• 外部インターネット接続がないノード
  
  外部インターネット接続がないノードでも、ミラーリングされたバージョンの Apigee にアクセスできます 内部でセットアップしたリポジトリです。このリポジトリにはすべての Edge RPM が格納されていますが、 内部ネットワークのリポジトリから、他のすべての依存関係が使用可能であることを確認します。
  
  内部 Apigee リポジトリを作成するには、外部インターネットを持つノードが必要です アクセスする必要があります。新しい P-MAX キャンペーンを そのリポジトリを別のノードに移動したり、そのノードに Edge からアクセスできるようにしたりすることが可能です。 作成します。
  
  注: Apigee では、すべてのサードパーティの依存関係を できます。これらの依存関係は、一般公開されているものからダウンロードしてインストールする必要があります。 できます。

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

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

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

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

ミラーリングされたリポジトリは柔軟性に優れています。たとえば、最新の Deployment からミラーリングされたリポジトリを 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

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

データ

インストール後のタスク

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

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

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

.properties ファイルの内容は （/opt/apigee/customer/application ディレクトリにあります）。 このディレクトリには、コンポーネントごとに独自の .properties ファイルがあります。対象 （例: router.properties と management-server.properties.

コンポーネントのプロパティを設定するには、対応する .properties ファイルを編集してから component:

> /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
• バックアップ、復元
• インストール、アンインストール