Edge Microgateway のインストール

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

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

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

        npm install edgemicro@2.5.7 -g
        
  2. バージョン番号を確認します。たとえば、バージョン 2.5.7 をインストールした場合は、次のように表示されます。
        edgemicro --version
        current nodejs version is v6.9.1
        current edgemicro version is 2.5.7
        
  3. 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 を削除する必要がある場合は、次の操作を行います。

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

Kubernetes のサポート

Kubernetes クラスタで実行中のサービスに対して、Edge Microgateway を使用して Apigee API 管理を利用できます。Edge Microgateway と Kubernetes の統合の概要をご覧ください。

Docker のサポート

最新の Edge Microgateway リリースを、Docker イメージとしてダウンロードできます。

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