Edge Microgateway のインストール

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します
info

Edge Microgateway v. 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 のアップグレードをご覧ください。

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

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 をグローバル オプション(npm install -g edgemicro)で使用すると、ソフトウェアは [prefix]/lib/node_modules/edgemicro にインストールされます。 [prefix] の値は、次のコマンドで確認できます。

npm config get prefix

接頭辞の構成は、デフォルトで Node.js がインストールされている場所に設定されます。ほとんどのシステムでは、 /usr/local です。Windows では、%AppData%\npm です。 [prefix][value] の値は構成可能です。Node.js モジュールがデフォルトでインストールされる場所と、インストール場所を構成する方法の詳細については、npm-folders をご覧ください。

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