Đang cài đặt Edge Microgateway

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Edge Microgateway phiên bản 3.3.x

Chủ đề này giải thích cách cài đặt hoặc gỡ cài đặt Edge Microgateway.

Yêu cầu tối thiểu về phần cứng

Edge Microgateway yêu cầu cấu hình phần cứng tối thiểu như sau:

  • Trên máy ảo (VM), Edge Microgateway yêu cầu tối thiểu 1 lõi và RAM tối thiểu là 256 MB. Bản thân quy trình Edge Microgateway chiếm chưa đến 128 MB RAM.
  • Trên một vùng chứa, bạn có thể dùng Microgateway với kích thước hình ảnh nhỏ hơn 100 MB.

Điều kiện tiên quyết

  • Apigee hỗ trợ các bản phát hành LTS đang hoạt động hoặc LTS bảo trì trên Windows, macOS và Linux. Hãy xem phần Phần mềm được hỗ trợ cho Apigee Edge Microgateway để biết thêm thông tin.
  • Windows yêu cầu bạn cài đặt và thêm OpenSSL vào PATH.
  • Nếu đang sử dụng Apigee Edge Private Cloud để định cấu hình bằng Edge Microgateway, bạn phải đang chạy Private Cloud phiên bản 4.18.01 trở lên.

Cài đặt Edge Microgateway nếu bạn có kết nối Internet

Phần này giải thích cách cài đặt Edge Microgateway và khởi động cấu hình mặc định. Nếu bạn đang hoạt động mà không có kết nối Internet, hãy xem phần Tôi có thể cài đặt Edge Microgateway mà không cần kết nối Internet không?.

  1. Cài đặt phiên bản Edge Microgateway mới nhất bằng npm như sau. Lệnh này sẽ cài đặt phần mềm và đặt tệp thực thi edgemicro vào đường dẫn của bạn. 
    npm install edgemicro -g

    Để cài đặt một phiên bản cụ thể của Edge Microgateway, bạn cần chỉ định số phiên bản trong lệnh cài đặt. Nếu bạn không chỉ định số phiên bản, phiên bản mới nhất sẽ được cài đặt. Ví dụ: để cài đặt phiên bản 3.1.5, hãy dùng lệnh sau. 

    npm install edgemicro@3.1.5 -g
  2. Kiểm tra số phiên bản. Ví dụ: nếu bạn đã cài đặt phiên bản 3.1.5: 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.5
  3. Làm theo các bước thiết lập và định cấu hình trong phần Thiết lập và định cấu hình Edge Microgateway.

Nâng cấp Edge Microgateway

Để nâng cấp một phiên bản Edge Microgateway đã cài đặt trước đó, hãy xem phần Nâng cấp Edge Microgateway nếu bạn có kết nối Internet.

Apigee khuyên bạn nên kiểm thử cấu hình hiện có bằng phiên bản mới trước khi nâng cấp môi trường thực tế.

Vận hành Edge Microgateway trên Windows dưới dạng một dịch vụ

Bạn có thể vận hành Edge Microgateway trên Windows dưới dạng một dịch vụ. Để biết thông tin chi tiết, hãy xem bài viết Các phương pháp hay nhất để quản lý hoạt động của Microgateway (edgemicro) trên Windows trên Cộng đồng Apigee.

Tôi có thể cài đặt Edge Microgateway mà không cần kết nối Internet không?

Trên những trang web không có quyền truy cập Internet, quản trị viên có thể cài đặt và duy trì sổ đăng ký npm riêng tư trên mạng nội bộ của bạn. Hướng dẫn thiết lập một sổ đăng ký npm riêng tư nằm ngoài phạm vi của hướng dẫn này; tuy nhiên, bạn có thể tìm kiếm và xem hướng dẫn hữu ích. Sau khi cài đặt một sổ đăng ký npm riêng tư, bạn có thể làm theo hướng dẫn cài đặt hoặc nâng cấp nêu trên.

Bắt đầu

Nếu bạn mới sử dụng Edge Microgateway, thì Thiết lập và định cấu hình Edge Microgateway là nơi tốt nhất để bắt đầu sau khi bạn hoàn tất quá trình cài đặt. Hướng dẫn thiết lập và định cấu hình bao gồm tất cả các bước bạn cần thực hiện để cài đặt, định cấu hình, khởi động và sử dụng một phiên bản Edge Microgateway.

Edge Microgateway được cài đặt ở đâu?

Khi bạn sử dụng npm với lựa chọn chung (npm install -g edgemicro), phần mềm sẽ được cài đặt trong [prefix]/lib/node_modules/edgemicro. Bạn có thể tìm thấy giá trị của [prefix] bằng lệnh sau:

npm config get prefix

Cấu hình tiền tố mặc định là vị trí cài đặt nút. Trên hầu hết các hệ thống, đây là /usr/local. Trên Windows, đó là %AppData%\npm. Bạn có thể định cấu hình giá trị của [prefix]. Hãy xem npm-folders để biết thêm thông tin về vị trí cài đặt mặc định của các mô-đun Node.js và cách định cấu hình vị trí cài đặt.

Gỡ cài đặt Edge Microgateway

Nếu bạn cần xoá Edge Microgateway, hãy làm như sau:

  1. Xoá hoặc lưu trữ thư mục cài đặt [prefix]/lib/node_modules/edgemicro, trong đó [prefix] là tiền tố npm như được giải thích trong phần Nơi cài đặt Edge Microgateway?
  2. Xoá hoặc lưu trữ tệp nhật ký. Theo mặc định, các tệp edgemicro-*.log nằm trong /var/tmp/, nhưng bạn có thể định cấu hình vị trí này. Kiểm tra tệp cấu hình Edge Microgateway nếu bạn không chắc chắn.
  3. Xoá hoặc lưu trữ tệp cấu hình thời gian chạy và tệp cấu hình bộ nhớ đệm: 
    ~/.edgemicro/*.yaml

Hỗ trợ Kubernetes

Bạn có thể sử dụng Edge Microgateway để cung cấp tính năng quản lý API Apigee cho các dịch vụ đang chạy trong một cụm Kubernetes. Xem bài viết Tổng quan về việc tích hợp Edge Microgateway với Kubernetes.

Hỗ trợ Docker

Giờ đây, bạn có thể tải bản phát hành Edge Microgateway mới nhất xuống dưới dạng hình ảnh Docker:

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