Edge Microgateway のインストール

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。

Edge Microgateway v 3.3.x

このトピックでは、Edge Microgateway をインストールまたはアンインストールする方法について説明します。

ハードウェアの最小要件

Edge Microgateway には、次の最小ハードウェア構成が必要です。

  • 仮想マシン（VM）の場合、Edge Microgateway には 1 コア以上、256 MB 以上の RAM が必要です。Edge Microgateway プロセス自体の RAM の容量は 128 MB 未満です。
  • コンテナで、 Microgateway は 100 MB 未満のイメージサイズで使用できます。

Prerequisites

  • Apigee は、Windows、macOS、Linux で Active LTS または Maintenance LTS リリースをサポートしています。詳細については、Apigee Edge Microgateway でサポートされるソフトウェアをご覧ください。
  • Windows では、OpenSSL をインストールして PATH に追加する必要があります。
  • Apigee Edge Private Cloud を使用して Edge Microgateway で構成する場合は、Private Cloud バージョン 4.18.01 以降を実行する必要があります。

インターネットに接続している場合の Edge Microgateway のインストール

このセクションでは、Edge Microgateway をインストールしてデフォルト構成を初期化する方法について説明します。インターネットに接続せずに動作している場合は、インターネットに接続せずに Edge Microgateway をインストールすることはできますか？をご覧ください。

  1. 次のように、npm を使用して最新バージョンの Edge Microgateway をインストールします。このコマンドを実行すると、ソフトウェアがインストールされ、edgemicro 実行可能ファイルがパスに配置されます。 
    npm install edgemicro -g

    特定のバージョンの Edge Microgateway をインストールするには、インストール コマンドでバージョン番号を指定する必要があります。バージョン番号を指定しない場合、最新バージョンがインストールされます。たとえば、バージョン 3.1.5 をインストールするには、次のコマンドを使用します。

    npm install edgemicro@3.1.5 -g
  2. バージョン番号を確認します。たとえば、バージョン 3.1.5 をインストールした場合: 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.5
  3. Edge Microgateway の設定と構成の手順を行います。

Edge Microgateway のアップグレード

以前にインストールした Edge Microgateway のバージョンをアップグレードするには、インターネットに接続している場合の Edge Microgateway のアップグレードをご覧ください。

本番環境をアップグレードする前に、新しいバージョンで既存の構成をテストすることをおすすめします。

Windows での Service として Edge Microgateway を操作する

Windows で Edge Microgateway をサービスとして操作できます。詳細については、Apigee コミュニティの Windows での Microgateway（エッジマイクロ）の運用管理のベスト プラクティスをご覧ください。

インターネット接続なしで Edge Microgateway をインストールできますか？

インターネットにアクセスできない場合、管理者が内部ネットワーク上に限定公開の npm レジストリをインストールして管理することは可能です。非公開 npm レジストリの設定手順については、このガイドでは扱いませんが、有用な情報の検索や検索は可能です。限定公開の npm レジストリをインストールすると、上記のインストールまたはアップグレードの手順に沿って操作できます。

はじめに

Edge Microgateway を初めて使用する場合は、インストールの完了後に Edge Microgateway の設定と構成を行うことをおすすめします。設定と構成のガイドには、Edge Microgateway のインスタンスのインストール、構成、起動、使用に必要なすべての手順が記載されています。

Edge Microgateway はどこに保存されますか？

npm をグローバル オプション（npm install -g edgemicro）とともに使用すると、ソフトウェアが [prefix]/lib/node_modules/edgemicro にインストールされます。[prefix] の値は、次のコマンドで確認できます。

npm config get prefix

接頭辞の構成はデフォルトで、ノードがインストールされているロケーションになります。ほとんどのシステムでは /usr/local です。Windows の場合は %AppData%\npm です。[prefix] の値は構成可能です。Node.js モジュールがデフォルトでインストールされている場所とインストール場所の詳細については、npm-folders をご覧ください。

Edge Microgateway のアンインストール

Edge Microgateway を削除する方法は次のとおりです。

  1. インストール ディレクトリ [prefix]/lib/node_modules/edgemicro を削除またはアーカイブします。ここで、[接頭辞] は Edge Microgateway がインストールされている場所で説明されている npm 接頭辞です。
  2. ログファイルを削除またはアーカイブします。デフォルトでは、edgemicro-*.log ファイルは /var/tmp/ にありますが、この場所は構成可能です。不明な場合は、Edge Microgateway 構成ファイルを確認します。
  3. ランタイム構成ファイルとキャッシュ構成ファイルを削除またはアーカイブします。 
    ~/.edgemicro/*.yaml

Kubernetes のサポート

Edge Microgateway を使用すると、Kubernetes クラスタで実行されるサービスに Apigee API の管理を提供できます。Edge Microgateway と Kubernetes の統合をご覧ください。

Docker のサポート

最新の Edge Microgateway リリースを Docker イメージとしてダウンロードできるようになりました。

docker pull gcr.io/apigee-microgateway/edgemicro:latest