Edge Microgateway のインストール

ここに表示されているのは 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 をインストールしてデフォルト 構成を初期化する方法について説明します。

  1. 次のコマンドを使用して、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. バージョン番号を確認します。たとえば、バージョン 2.3.5 をインストールした場合は、次のようになります。
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
  3. このコマンドを実行して、ホーム ディレクトリにデフォルトの構成ファイルを作成します。
    edgemicro init
  4. (省略可)default.yaml ファイルという構成ファイルは、ホーム ディレクトリの .edgemicro というサブディレクトリ内に配置されています。このファイルが存在することを確認します。
    ls ~/.edgemicro
    default.yaml

    注: Edge Microgateway ドキュメントでは、ホーム ディレクトリを UNIX のショートカットであるチルダ(~)で示しています。Windows を使用しており、チルダをサポートしていないシェルを実行している場合は、コマンドで、ホーム ディレクトリを参照する適切な 環境変数にチルダを置き換えます。たとえば、%USERPROFILE%/.edgemicro となります。

  5. 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 を削除する必要がある場合は、次の手順に従います。

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