ここに表示されているのは Apigee Edge のドキュメントです。
Go to the
Apigee X のドキュメントに移動します。 info
Edge Microgateway v. 3.1.5 以降
このトピックでは、Edge Microgateway をインストールまたはアンインストールする方法について説明します。
ハードウェアの最小要件
Edge Microgateway には、少なくとも次のハードウェア構成が必要です。
- 仮想マシン(VM)では、Edge Microgateway には 1 コア以上、256 MB 以上の RAM が必要です。Edge Microgateway プロセス自体が必要とする RAM は、128 MB 未満です。
- コンテナで、Microgateway は 100 MB 未満のイメージサイズで使用できます。
前提条件
- 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 をインストールする方法をご覧ください。
- 次のように
npmを使用して Edge Microgateway の最新バージョンをインストールします。この コマンドを実行すると、ソフトウェアがインストールされ、edgemicro実行可能ファイルが指定のパスに配置されます。npm install edgemicro -g
特定のバージョンの Edge Microgateway をインストールするには、インストール コマンドで バージョン番号 を指定する必要があります。バージョン番号を指定しない場合、最新バージョンがインストールされます。たとえば、バージョン 3.1.5 をインストールするには、次のコマンドを使用します。
npm install edgemicro@3.1.5 -g
- バージョン番号を確認します。たとえば、バージョン 3.1.5 をインストールした場合:
edgemicro --version current nodejs version is v12.5.0 current edgemicro version is 3.1.5
- Edge Microgateway の設定と構成の説明に従って、設定 と構成の手順を行います。
Edge Microgateway のアップグレード
すでにインストールされている Edge Microgateway のバージョンをアップグレードするには、 インターネット接続を利用できる場合の 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 をグローバル オプション(npm install -g edgemicro)で使用すると、ソフトウェアは [prefix]/lib/node_modules/edgemicro にインストールされます。
[prefix] の値は、次のコマンドで確認できます。
npm config get prefix
接頭辞の構成は、デフォルトで Node.js がインストールされている場所に設定されます。ほとんどのシステムでは、
/usr/local です。Windows では、%AppData%\npm です。
[prefix][value] の値は構成可能です。Node.js
モジュールがデフォルトでインストールされる場所と、インストール場所を構成する方法の詳細については、npm-folders をご覧ください。
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