Edge Microgateway のインストール

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

Edge Microgateway バージョン 3.2.x

このトピックでは、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 をインストールできますか?をご覧ください。

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

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

    npm install edgemicro@3.1.5 -g
    
  2. バージョン番号を確認します。たとえば、バージョン 3.1.5 をインストールした場合は、次のようになります。
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.5
    
  3. Edge Microgateway の設定と構成の設定と構成の手順を行います。

Edge Microgateway のアップグレード

以前にインストールしたバージョンの Edge Microgateway をアップグレードするには、インターネット接続を利用できる場合の Edge Microgateway のアップグレードをご覧ください。

Apigee では、本番環境をアップグレードする前に、新しいバージョンで既存の構成をテストすることをおすすめします。

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

接頭辞の 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 のサポート

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

Docker のサポート

Edge Microgateway 最新リリースを Docker イメージとしてダウンロードできるようになりました。

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