Edge Microgateway のインストール

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

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 のインストールの手順に沿って操作します。

Windows as a Service での Edge Microgateway の運用

Edge Microgateway は Windows 上でサービスとして操作できます。詳細については、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

[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