您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
Edge Microgateway 3.3.x 版
本主題說明如何安裝或解除安裝 Edge Microgateway。
最低硬體需求
Edge Microgateway 具備下列最低硬體設定需求:
- 在虛擬機器 (VM) 上,Edge Microgateway 需要至少 1 個核心,並至少需要 256 MB 的 RAM。Edge Microgateway 程序本身只需不到 128 MB 的 RAM。
- 在容器中,Microgateway 可用於小於 100 MB 的圖片大小。
必要條件
- Apigee 支援 Windows、macOS 和 Linux 上的 Active LTS 或維護 LTS 版本。詳情請參閱 Apigee Edge Microgateway 支援的軟體。
- Windows 規定必須安裝 OpenSSL,並新增至 PATH。
- 如果您使用 Apigee Edge Private Cloud 來設定 Edge Microgateway,您必須執行 Private Cloud 版本 4.18.01 以上版本。
如果您有網際網路連線,請安裝 Edge Microgateway
本節說明如何安裝 Edge Microgateway 及初始化預設設定。如果您在沒有網際網路連線的情況下運作,請參閱「我可以在沒有網際網路連線的情況下安裝 Edge Microgateway 嗎?」。
- 使用
npm
安裝最新版本的 Edge Microgateway,如下所示。這個指令會安裝軟體,並將edgemicro
執行檔存放在路徑中。npm install edgemicro -g
如要安裝特定版本的 Edge Microgateway,您必須在安裝指令中指定「版本號碼」。如果未指定版本號碼,系統會安裝最新版本。舉例來說,如要安裝 3.1.5 版,請使用下列指令。
npm install edgemicro@3.1.5 -g
- 查看版本號碼。舉例來說,如果已安裝 3.1.5 版:
edgemicro --version current nodejs version is v12.5.0 current edgemicro version is 3.1.5
- 按照「設定及設定 Edge Microgateway」中的設定和設定步驟操作。
升級 Edge Microgateway
如要升級先前安裝的 Edge Microgateway 版本,請參閱「在連上網際網路的情況下升級 Edge Microgateway」。
Apigee 建議您先以新版本測試現有設定,然後再升級實際工作環境。
在 Windows 中以服務的形式使用作業系統微閘道
您可以在 Windows 中以服務的形式操作 Edge Microgateway。詳情請參閱 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
前置字串設定會預設為節點的安裝位置。在大多數系統中,這個值為 /usr/local
。Windows 上的版本為 %AppData%\npm
。[prefix]
的值可進行設定。如要進一步瞭解預設 Node.js 模組安裝的位置,以及如何設定安裝位置,請參閱 npm-folders。
正在解除安裝 Edge Microgateway
如要移除 Edge Microgateway,請按照下列步驟操作:
- 刪除或封存安裝目錄
[prefix]/lib/node_modules/edgemicro
,其中 [prefix] 是 npm 前置字串,如 Edge Microgateway 的安裝位置一節所述 -
刪除或封存記錄檔。根據預設,
edgemicro-*.log
檔案位於/var/tmp/
,但這個位置可以設定。如有任何疑問,請檢查 Edge Microgateway 設定檔。 - 刪除或封存執行階段設定和快取設定檔:
~/.edgemicro/*.yaml
Kubernetes 支援
您可以使用 Edge Microgateway 為 Kubernetes 叢集中執行的服務提供 Apigee API 管理服務。請參閱「整合 Edge Microgateway 與 Kubernetes 總覽」一文。
支援 Docker
您現在可以將最新的 Edge Microgateway 版本下載為 Docker 映像檔:
docker pull gcr.io/apigee-microgateway/edgemicro:latest