Edge Microgateway v. 2.5.x
このトピックでは、Edge Microgateway をインストールまたはアンインストールする方法について説明します。
ハードウェアの最小要件
Edge Microgateway には、少なくとも次のハードウェア構成が必要です。
- 仮想マシン(VM)では、Edge Microgateway には 1 コア以上、256 MB 以上の RAM が必要です。Edge Microgateway プロセス自体が必要とする RAM は、128 MB 未満です。
- コンテナで、Microgateway は 100 MB 未満のイメージサイズで使用できます。
前提条件
- システムに Node.js バージョン 6.x LTS 以降がインストールされている必要があります。次のコマンドを実行すると、バージョンを確認できます。
node -v v6.9.1
- Windows では OpenSSL をインストールして PATH に追加する必要があります。
- Apigee Edge Private Cloud を使用して Edge Microgateway で構成している場合は、Private Cloud バージョン 4.18.01 以降が稼働している必要があります。
インターネット接続を利用できる場合の Edge Microgateway のインストール
このセクションでは、Edge Microgateway をインストールして、デフォルト構成を初期化する方法について説明します。
- 次のように
npm
を使用して Edge Microgateway の最新バージョンをインストールします。このコマンドは、ソフトウェアをインストールし、パスにedgemicro
実行可能ファイルを置きます。npm install edgemicro -g
Edge Microgateway の特定のバージョンをインストールするには、インストール コマンドでバージョン番号を指定する必要があります。バージョン番号を指定しない場合、最新バージョンがインストールされます。 たとえば、バージョン 2.5.7 をインストールするには、次のコマンドを使用します。
npm install edgemicro@2.5.7 -g
- バージョン番号を確認します。たとえば、バージョン 2.5.7 をインストールした場合は、次のように表示されます。
edgemicro --version current nodejs version is v6.9.1 current edgemicro version is 2.5.7
- Edge Microgateway の設定と構成の設定と構成の手順を行います。
Edge Microgateway を Windows as a Service で運用する
Edge Microgateway は Windows as a Service で運用できます。詳細については、Apigee コミュニティの Windows 上での Microgateway(edgemicro)の運用管理におすすめの方法をご覧ください。
インターネット接続なしで Edge Microgateway をインストールする方法
インターネットに接続できないサイトでも、管理者は内部ネットワークにプライベート npm レジストリをインストールして管理できます。プライベート npm
レジストリを設定する手順については、このガイドの対象外です。ただし、有用な情報を検索によって見つけることができます。プライベート npm
レジストリがインストールされている場合は、上記の手順に沿ってインストールできます。
はじめに
Edge Microgateway を初めて使用する場合は、インストール後にまず Edge Microgateway の設定と構成を行うことをおすすめします。設定と構成のガイドには、Edge Microgateway のインスタンスのインストール、構成、起動、使用に必要な、すべての手順が記載されています。
Edge Microgateway がインストールされている場所
グローバル オプション(npm install -g edgemicro
)とともに npm
を使用すると、ソフトウェアは [prefix]/lib/node_modules/edgemicro
にインストールされます。次のコマンドで、[prefix]
の値を確認できます。
npm config get prefix
デフォルトでは、接頭辞の「config」はノードがインストールされている場所になります。ほとんどのシステムで、これは /usr/local
です。Windows では %AppData%\npm
です。[prefix]
の値は構成可能です。Node.js モジュールがデフォルトでインストールされる場所と、インストール場所を構成する方法の詳細については、npm フォルダをご覧ください。
Edge Microgateway のアンインストール
Edge Microgateway を削除する必要がある場合は、次の操作を行います。
- インストール ディレクトリ
[prefix]/lib/node_modules/edgemicro
を削除またはアーカイブします。ここで [prefix] は、Edge Microgateway がインストールされている場所で説明した npm 接頭辞です。 -
ログファイルを削除またはアーカイブします。デフォルトで
edgemicro-*.log
ファイルは/var/tmp/
にありますが、この場所は構成可能です。不明な場合は、Edge Microgateway 構成ファイルを確認してください。 - ランタイム構成ファイルとキャッシュ構成ファイルを、削除またはアーカイブします。
~/.edgemicro/*.yaml
Kubernetes のサポート
Kubernetes クラスタで実行中のサービスに対して、Edge Microgateway を使用して Apigee API 管理を利用できます。Edge Microgateway と Kubernetes の統合の概要をご覧ください。
Docker のサポート
最新の Edge Microgateway リリースを、Docker イメージとしてダウンロードできます。
docker pull gcr.io/apigee-microgateway/edgemicro:latest