ここに表示されているのは Apigee Edge のドキュメントです。
Go to the
Apigee X のドキュメントに移動します。 info
Edge Microgateway v. 2.3.x
オーディエンス
このガイドは、Edge Microgateway をインストールまたはアンインストールする必要がある場合に使用します。
前提条件
- システムに Node.js バージョン 4.5 LTS 以降がインストールされている必要があります。Node.js の追加の手順については、以下をご覧ください。
- Windows では OpenSSL をインストールして PATH に追加する必要があります。
- Apigee Edge Private Cloud を使用して Edge Microgateway で構成している場合は、 Private Cloud バージョン 4.15.07 以降が稼働している必要があります。
Node.js のインストール
システムに Node.js バージョン 4.5 以降 がインストールされている必要があります。確認するには、以下を実行します。
node -v
Node.js を取得または更新する方法は多数あります。たとえば、HomeBrew、yum を使用するか、
Node.js サイト(https://nodejs.org/download.)から直接ダウンロードできます。
インターネット接続を利用できる場合の Edge Microgateway のインストール
このセクションでは、Edge Microgateway をインストールしてデフォルト 構成を初期化する方法について説明します。
- 次のコマンドを使用して、
npmで Edge Microgateway の最新 バージョンをインストールします。このコマンドを実行すると、ソフトウェアがインストールされ、edgemicro実行可能ファイルが指定のパスに配置されます。次のコマンドで Edge Microgateway がインストールされる場所を確認するには、Edge Microgateway がインストールされている場所をご覧ください。npm install edgemicro -g
特定のバージョンの Edge Microgateway をインストールするには、インストール コマンドで バージョン番号 を指定する必要があります。バージョン番号を指定しない場合、最新バージョンがインストールされます。たとえば、バージョン 2.3.1 をインストールするには、次のコマンドを使用します。
npm install edgemicro@2.3.1 -g
- バージョン番号を確認します。たとえば、バージョン 2.3.5 をインストールした場合は、次のようになります。
edgemicro --version current nodejs version is v6.1.0 current edgemicro version is 2.3.5
- このコマンドを実行して、ホーム ディレクトリにデフォルトの構成ファイルを作成します。
edgemicro init
- (省略可)
default.yamlファイルという構成ファイルは、ホーム ディレクトリの.edgemicroというサブディレクトリ内に配置されています。このファイルが存在することを確認します。ls ~/.edgemicro default.yaml
注: Edge Microgateway ドキュメントでは、ホーム ディレクトリを UNIX のショートカットであるチルダ(
~)で示しています。Windows を使用しており、チルダをサポートしていないシェルを実行している場合は、コマンドで、ホーム ディレクトリを参照する適切な 環境変数にチルダを置き換えます。たとえば、%USERPROFILE%/.edgemicroとなります。 - 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
[prefix] の値は構成可能です。詳細については、npm-folders をご覧ください。
Edge Microgateway のアンインストール
Edge Microgateway を削除する必要がある場合は、次の手順に従います。
- インストール先ディレクトリ
[prefix]/lib/node_modules/edgemicroを削除するか、アーカイブします。ここで、[prefix] は Edge Microgateway がインストールされている場所で説明されている npm 接頭辞です。 - ログファイルを削除またはアーカイブします。デフォルトでは、
edgemicro-*.logファイルは/var/tmp/にありますが、この場所は変更可能です。不明な場合は、「ログファイルの管理」の説明に従って構成ファイルを確認してください。 - ランタイム構成ファイルとキャッシュ構成ファイルを、削除またはアーカイブします。
~/.edgemicro/*.yaml