Ghi chú phát hành của Edge Microgateway

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Phiên bản 3.3.x

Sửa lỗi và cải tiến phiên bản 3.3.x

3.3.3

Vào ngày 25 tháng 4 năm 2024, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.3.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

• CVE-2023-0842
• CVE-2023-26115
• CVE-2022-25883
• CVE-2017-20162
• CVE-2022-31129
• CVE-2022-23539
• CVE-2022-23541
• CVE-2022-23540
• CVE-2024-21484
• CVE-2022-46175
• CVE-2023-45133
• CVE-2020-15366
• CVE-2023-26136
• CVE-2023-26115

3.3.2

Vào ngày 18 tháng 8 năm 2023, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.3.2. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

Không nội dung nào.

3.3.1

Vào ngày 7 tháng 6 năm 2022, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.3.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

3.3.0

Vào ngày 4 tháng 2 năm 2022, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.3.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

npm install apigeetool@0.15.1

Phiên bản 3.2.x

Sửa lỗi và cải tiến phiên bản 3.2.x

3.2.3

Vào ngày 17 tháng 9 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.2.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

3.2.2

Vào thứ Năm, ngày 15 tháng 7 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.2.2. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

3.2.1

Vào thứ Sáu, ngày 5 tháng 3 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.2.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

edgemicro:
 enable_GET_req_body: true

3.2.0

Vào thứ Năm, ngày 21 tháng 1 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.2.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

Phiên bản 3.1.x

Sửa lỗi và cải tiến phiên bản 3.1.x

3.1.8

Vào thứ Hai, ngày 16 tháng 11 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.8. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

3.1.7

Vào thứ Năm, ngày 24 tháng 9 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.7. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

Vào thứ Năm, ngày 20 tháng 8 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.6. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

3.1.5

Vào thứ Sáu, ngày 26 tháng 6 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.5. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

3.1.4

Vào thứ Sáu, ngày 23 tháng 4 năm 2020, chúng tôi đã phát hành bản sửa lỗi sau đây cho Edge Microgateway.

Sửa lỗi:

Đã khắc phục một vấn đề về phần phụ thuộc trong phiên bản 3.1.3. Phiên bản 3.1.3 được đánh dấu là không dùng nữa trong kho lưu trữ npm. Nếu không, tất cả các bản sửa lỗi và tính năng nâng cao được mô tả trong ghi chú phát hành của phiên bản 3.1.3 sẽ áp dụng cho bản phát hành này.

3.1.3

Vào thứ Tư, ngày 15 tháng 4 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 153509313 – Đã khắc phục một sự cố khiến mô-đun gỡ lỗi Node.js dẫn đến rò rỉ bộ nhớ. Vấn đề này tồn tại trong phiên bản v3.1.0, 3.1.1 và 3.1.2.
• 153509313 – Khắc phục sự cố khi cùng một mã thông báo cho hai giao dịch khác nhau được in trong kết quả ghi nhật ký.
• 151673570 – Khắc phục sự cố khiến Edge Microgateway không được cập nhật để sử dụng các API Apigee KVM mới. Edge Microgateway hiện sử dụng các lệnh mới để thêm và cập nhật các giá trị KVM.
• 152822846 – Trong các bản phát hành trước, Edge Microgateway đã được cập nhật để quá trình xử lý ánh xạ đường dẫn tài nguyên khớp với quá trình xử lý của Apigee Edge. Trong bản phát hành này, một vấn đề đã được khắc phục, đó là mẫu /literal_string/* không được xử lý chính xác. Ví dụ: /*/2/*. Hãy xem thêm phần Định cấu hình hoạt động của đường dẫn tài nguyên "/", "/*" và "/**".
• 152005003 – Các thay đổi đã được thực hiện để cho phép giá trị nhận dạng trong phạm vi tổ chức và môi trường cho hạn mức.
• 152005003 – Các thay đổi đã được thực hiện để cho phép giá trị nhận dạng trong phạm vi tổ chức và môi trường cho hạn mức. Tổ hợp 'org + env + appName + Feature' được sử dụng làm giá trị nhận dạng hạn mức.

3.1.2

Vào thứ Hai, ngày 16 tháng 3 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 151285018 – Một tính năng nâng cao đã được thực hiện để thêm tính năng hỗ trợ proxy HTTP cho lưu lượng truy cập giữa Edge Microgateway và các mục tiêu phụ trợ. Ngoài ra, chúng tôi cũng khắc phục các vấn đề đối với dịch vụ hỗ trợ proxy HTTP hiện có giữa Edge Microgateway và Apigee Edge. Để biết thông tin chi tiết, hãy xem:
  • Sử dụng proxy HTTP để giao tiếp với Apigee Edge
  • Sử dụng proxy HTTP để giao tiếp mục tiêu
• 149101890 – Mã thông báo nhật ký trong các trường hợp mà máy chủ mục tiêu hoặc trình cân bằng tải đóng kết nối bị thay đổi từ LỖI thành INFO.
• 150746985 – Khắc phục sự cố khiến lệnh edgemicro verify không hoạt động đúng cách nếu redisBasedConfigCache: true hoặc quotaUri: https://%s-%s.apigee.net/edgemicro-auth đã có trong tệp cấu hình.
• 151284716 – Một tính năng nâng cao đã được thực hiện để đóng kết nối máy chủ nhanh hơn khi worker được khởi động lại trong quá trình tải lại.
• 151588764 – Cập nhật phiên bản Node.js trong hình ảnh Docker dùng để chạy Edge Microgateway trong vùng chứa Docker lên 12, vì Node.js v8 không còn được dùng nữa.
• 151306049 – Một bản cập nhật tài liệu đã được thực hiện để liệt kê các API quản lý Apigee Edge mà các lệnh CLI của Edge Microgateway sử dụng. Hãy xem phần Edge Microgateway sử dụng API quản lý nào?.

3.1.1

Vào thứ Năm, ngày 20 tháng 2, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 146069701 – Khắc phục sự cố khiến mô-đun microgateway-core không tuân theo các biến môi trường HTTP_PROXY và HTTPS_PROXY. Với thay đổi này, các chế độ cài đặt proxy trong tệp cấu hình YAML (nếu được chỉ định) nay bị bỏ qua; chỉ các biến môi trường mới được dùng để chỉ định proxy.

  Nếu muốn chỉ định cấu hình proxy trong tệp cấu hình, bạn cũng phải chỉ định một biến HTTP_PROXY đề cập đến cùng URL proxy với URL được chỉ định trong tệp cấu hình. Ví dụ: nếu bạn chỉ định cấu hình sau:

  edge_config:
    proxy: http://10.128.0.20:3128
    proxy_tunnel: true
  

  Bạn cũng phải chỉ định biến môi trường này:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 – Một tham số cấu hình mới, edgemicro.headers_timeout, đã được thêm. Thuộc tính này giới hạn khoảng thời gian (tính bằng mili giây) mà trình phân tích cú pháp HTTP sẽ chờ để nhận được các tiêu đề HTTP hoàn chỉnh. Ví dụ:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Trong nội bộ, tham số này sẽ đặt thuộc tính Node.js Server.headersTimeout theo các yêu cầu. (Mặc định: Nhiều hơn 5 giây so với thời gian đã đặt bằng edgemicro.keep_alive_timeout. Chế độ cài đặt mặc định này ngăn trình cân bằng tải hoặc proxy xoá kết nối nhầm.)

• 149278885 – Một tính năng mới đã được thêm vào, cho phép bạn thiết lập thời gian chờ của API mục tiêu ở cấp proxy API thay vì sử dụng một chế độ cài đặt thời gian chờ chung.

  Nếu bạn thiết lập thuộc tính TargetEndpoint io.timeout.millis trong proxy API, thì Edge Microgateway sẽ có thể truy xuất thuộc tính đó và áp dụng thời gian chờ dành riêng cho thiết bị đầu cuối mục tiêu. Nếu tham số này không được áp dụng, Edge Microgateway sẽ sử dụng thời gian chờ chung được chỉ định bằng edgemicro.request_timeout.

3.1.0

Vào thứ Ba, ngày 21 tháng 1, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.1.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 144187500 – Sự kiện cấp WARN mới sẽ được ghi lại khi cờ quotas.failOpen được kích hoạt. Cờ này được kích hoạt nếu xảy ra lỗi xử lý hạn mức hoặc nếu yêu cầu "áp dụng hạn mức" đến Edge không cập nhật được bộ đếm hạn mức từ xa. Trong trường hợp này, hạn mức sẽ được xử lý chỉ dựa trên số lượng cục bộ cho đến khi lần đồng bộ hoá hạn mức từ xa thành công tiếp theo. Trước đây, sự kiện này chỉ được ghi lại khi cấp độ nhật ký được đặt thành DEBUG.

  Ví dụ:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519 – Sự cố đã được khắc phục khiến các giao dịch đang tiến hành hoặc giao dịch mới bị ảnh hưởng bất cứ khi nào Edge Microgateway phát hiện thấy thay đổi đối với một proxy API. Giờ đây, khi có thay đổi đối với một proxy, Edge Microgateway sẽ làm mới bộ nhớ đệm và các nút worker sẽ khởi động lại. Với thay đổi này, các giao dịch đang tiến hành và lệnh gọi API mới được gửi tới cổng vào vi mô sẽ không bị ảnh hưởng.
• 146378327 – Cấp độ nhật ký của sourceRequest, targetRequest và targetResponse đã được thay đổi thành cấp INFO.
• 146019878 – Sự khác biệt giữa độ trễ được tính toán cho "Hiệu suất proxy API" trong phân tích Edge và các sự kiện trong nhật ký sourceResponse/targetResponse của Edge Microgateway đã được khắc phục. Giờ đây, độ trễ trong các sự kiện trong nhật ký Microgateway và số liệu phân tích Edge đã được điều chỉnh.
• Các thay đổi liên quan đến logic so khớp mẫu:
  • 147027862 – Trình bổ trợ oauth đã được cập nhật để hỗ trợ các mẫu so khớp đường dẫn tài nguyên sau đây như được chỉ định trong Sản phẩm API:
    • /{literal}**
    • /{literal}*
    • Bất kỳ sự kết hợp nào của hai mẫu trên

    Với thay đổi này, trình bổ trợ Edge Microgateway hiện tuân theo cùng một mẫu khớp với Apigee Edge, như giải thích trong phần Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**".

  • 145644205 – Cập nhật logic so khớp mẫu của trình bổ trợ apiKeys để khớp với trình bổ trợ oauth.
• 143488312 – Một sự cố đã được khắc phục khi khoảng trắng ở đầu hoặc cuối trong tham số ID ứng dụng khách đã khiến việc tạo danh sách sản phẩm JWT bị trống đối với các yêu cầu mã thông báo OAuth và khoá API.
• 145640807 và 147579179 – Một tính năng mới đã được thêm vào, cho phép một phiên bản đặc biệt của Edge Microgateway có tên là "bộ đồng bộ hoá" (syncr) truy xuất dữ liệu cấu hình qua Apigee Edge và ghi dữ liệu đó vào cơ sở dữ liệu Redis cục bộ. Sau đó, các thực thể cổng vi mô khác có thể được định cấu hình để đọc dữ liệu cấu hình của các thực thể đó từ cơ sở dữ liệu. Tính năng này giúp tăng thêm khả năng phục hồi cho Edge Microgateway. Giải pháp này cho phép các thực thể cổng vi mô khởi động và hoạt động mà không cần giao tiếp với Apigee Edge. Để biết thông tin chi tiết, hãy xem phần Sử dụng trình đồng bộ hoá.

  Tính năng syncrhonizer hiện được hỗ trợ để hoạt động với Redis 5.0.x.

Phiên bản 3.0.x

Sửa lỗi và cải tiến phiên bản 3.0.x

3.0.10

Vào thứ Sáu, ngày 8 tháng 11, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.0.10. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 142677575 – Chúng tôi đã thực hiện một bản cập nhật tính năng để việc so khớp mẫu cho đường dẫn tài nguyên dùng trong các sản phẩm API cho Edge Microgateway nay phù hợp với mẫu đường dẫn tài nguyên mà Apigee Edge sử dụng, như mô tả trong phần Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**".

  Lưu ý: Nếu sử dụng một mẫu tài nguyên phức hợp như /*/2/**, bạn phải đảm bảo rằng proxy edgemicro_auth được thêm vào một sản phẩm API độc lập. Sau đó, bạn phải đưa sản phẩm đó vào Ứng dụng dành cho nhà phát triển của proxy, như minh hoạ trong ảnh chụp màn hình sau đây:

  

  Lưu ý: Thuộc tính cấu hình features.isSingleForwardSlashBlockingEnabled, như mô tả trong phần Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**, không được hỗ trợ cho Edge Microgateway.

• 143740696 – Cấu hình quotas đã thay đổi (xem thêm ghi chú phát hành cho phiên bản 3.0.9). Thuộc tính quotas được dùng để định cấu hình trình bổ trợ hạn mức. Thay đổi về cấu trúc được thực hiện để cải thiện độ rõ ràng của các phần tử cấu hình. Để định cấu hình trình bổ trợ hạn mức, hãy sử dụng cấu hình YAML sau. Lưu ý rằng thuộc tính cấu hình được gọi là quotas. Để biết thông tin chi tiết về từng thuộc tính cấu hình quotas, hãy xem Các tuỳ chọn cấu hình cho hạn mức.

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056 – Một tính năng mới đã được thêm vào, cho phép bạn sử dụng Redis làm kho lưu trữ sao lưu hạn mức. Nếu useRedis là true thì mô-đun volos-quota-redis sẽ được sử dụng. Khi đúng, hạn mức chỉ giới hạn ở những thực thể Edge Microgateway kết nối với Redis. Nếu giá trị là false, thì mô-đun volos-quota-apigee sẽ được dùng làm kho lưu trữ sao lưu và bộ đếm hạn mức sẽ dùng chung. Để biết thông tin chi tiết, hãy xem phần Các tuỳ chọn cấu hình cho hạn mức. Ví dụ:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210 – Thời gian hết hạn mặc định cho mã thông báo do proxy edgemicro-auth tạo đã được thay đổi từ 108000 mili giây (1,8 phút) thành 1800 giây (30 phút).
• 143551282 – Để hỗ trợ các tổ chức có bật SAML, lệnh edgemicro genkeys đã được cập nhật để thêm tham số ‑‑token. Tham số này cho phép bạn sử dụng mã thông báo OAuth để xác thực thay vì tên người dùng/mật khẩu. Để biết thông tin chi tiết, hãy xem phần Tạo khoá.

3.0.9

Vào thứ Sáu, ngày 11 tháng 10, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.0.9. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 141989374 – Một tính năng "không mở được" mới đã được thêm vào trình bổ trợ hạn mức. Khi tính năng này được bật, nếu xảy ra lỗi xử lý hạn mức hoặc nếu yêu cầu "áp dụng hạn mức" tới Edge không cập nhật được bộ đếm hạn mức từ xa, thì hạn mức sẽ chỉ được xử lý dựa trên số lượng cục bộ cho đến khi lần đồng bộ hoá hạn mức từ xa thành công tiếp theo. Trong cả hai trường hợp này, cờ quota-failed-open sẽ được đặt trong đối tượng yêu cầu.

  Để bật tính năng "không mở được" cho hạn mức, hãy đặt cấu hình sau:

  quotas :
   failOpen : true

  Lưu ý: Ngoài ra, tên cờ đối tượng yêu cầu fail-open của trình bổ trợ OAuth đã được đổi thành oauth-failed-open.

• 142093764 – Đã thực hiện thay đổi về cấu hình đối với proxy edgemicro-auth để ngăn việc vượt quá hạn mức. Việc thay đổi là để đặt loại hạn mức cho lịch. Để sử dụng điểm cải tiến này, bạn phải cập nhật edgemicro-auth lên phiên bản 3.0.7 trở lên.
• 142520568 – Một tính năng mới đã được thêm vào để cho phép ghi nhật ký mã MP (trình xử lý thư) trong các phản hồi hạn mức. Để sử dụng tính năng này, bạn phải cập nhật proxy edgemicro-auth lên phiên bản 3.0.7 trở lên và đặt cấu hình sau:

  quotas:
    useDebugMpId: true

  Khi bạn đặt useDebugMpId, hạn mức phản hồi từ Edge sẽ chứa mã MP và sẽ được Edge Microgateway ghi lại. Ví dụ:

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

Vào thứ Năm, ngày 26 tháng 9, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.0.8. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 140025210 – Một tính năng "không mở được" mới đã được thêm. Tính năng này cho phép quá trình xử lý API tiếp tục nếu không thể làm mới mã thông báo JWT đã hết hạn do lỗi kết nối ngăn lệnh gọi xác minh khoá API thành công đến proxy edgemicro-auth.

  Tính năng này cho phép bạn thiết lập thời gian ân hạn, trong đó mã thông báo cũ vẫn còn trong bộ nhớ đệm và được dùng lại cho đến khi thời gian ân hạn kết thúc. Tính năng này cho phép Edge Microgateway tiếp tục xử lý các yêu cầu trong trường hợp xảy ra lỗi kết nối tạm thời. Khi kết nối tiếp tục và lệnh gọi Xác minh khoá API thành công diễn ra, một JWT mới sẽ được tìm nạp và thay thế JWT cũ trong bộ nhớ đệm.

  Để định cấu hình tính năng "không mở được" mới, hãy làm như sau:

  1. Đặt các thuộc tính sau trong khổ oauth của tệp cấu hình Edge Microgateway:

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     Ví dụ:

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

     Trong ví dụ này, mã thông báo cũ sẽ được sử dụng trong 5 giây nếu không thể làm mới do vấn đề về khả năng kết nối. Sau 5 giây, hệ thống sẽ trả về lỗi xác thực.

• 141168968 – Một bản cập nhật đã được thực hiện để đưa correlation_id vào tất cả đầu ra nhật ký của trình bổ trợ. Ngoài ra, cấp độ nhật ký của một số nhật ký đã được thay đổi thành error theo yêu cầu.
• 140193349 – Một bản cập nhật đã được thực hiện đối với proxy edgemicro-auth để yêu cầu xác minh khoá và khoá bí mật Edge Microgateway cho mọi yêu cầu Xác minh khoá API. Edge Microgateway đã được cập nhật để luôn gửi khoá và bí mật cho mọi yêu cầu Xác minh khoá API. Thay đổi này ngăn ứng dụng lấy được JWT chỉ bằng một khoá API.
• 140090250 - Cập nhật để thêm tính năng ghi nhật ký chẩn đoán cho quá trình xử lý hạn mức. Với thay đổi này, giờ đây, bạn có thể tương quan đầu ra nhật ký quoto với phần còn lại của nhật ký Edge Microgateway.

3.0.7

Vào thứ Năm, ngày 12 tháng 9, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Các phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần liên kết với Edge Microgateway 3.0.7. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

Sửa lỗi và cải tiến:

• 140075602 – Trình bổ trợ OAuth đã được cập nhật để trả về mã trạng thái 5xx khi thích hợp. Trước đây, trình bổ trợ chỉ trả về mã trạng thái 4xx trong tất cả các trường hợp không phải 200 trường hợp. Giờ đây, đối với mọi phản hồi thông báo không phải là trạng thái 200, hệ thống sẽ trả về mã 4xx hoặc 5xx chính xác, tuỳ thuộc vào lỗi.

  Tính năng này bị tắt theo mặc định. Để bật tính năng này, hãy thêm thuộc tính oauth.useUpstreamResponse: true vào cấu hình Edge Microgateway. Ví dụ:

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• 140090623 – Trong bản phát hành 3.0.6, một thuộc tính cấu hình mới đã được thêm vào là quota.quotaUri. Đặt thuộc tính cấu hình này nếu bạn muốn quản lý hạn mức thông qua proxy edgemicro-auth được triển khai cho tổ chức của bạn. Nếu bạn không đặt thuộc tính này, điểm cuối hạn mức sẽ mặc định là điểm cuối nội bộ của Edge Microgateway. Ví dụ:

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  Trong bản phát hành 3.0.7, edgemicro-auth đã được cập nhật để chấp nhận cấu hình mới này. Để sử dụng thuộc tính quotaUri, bạn phải nâng cấp lên proxy edgemicro-auth mới nhất. Để biết thông tin chi tiết, hãy xem phần Nâng cấp proxy Edgemicro-auth.

• 140470888 – Tiêu đề Uỷ quyền đã được thêm vào các lệnh gọi hạn mức để cung cấp phương thức xác thực. Ngoài ra, proxy edgemicro-auth đã được sửa đổi để xóa "tổ chức" khỏi giá trị nhận dạng hạn mức. Vì điểm cuối của hạn mức nằm trong tổ chức của khách hàng nên giá trị nhận dạng hạn mức không còn cần thiết nữa.
• 140823165 – Tên tài sản sau:

  edgemicro:
      keepAliveTimeout

  đã được ghi lại không chính xác trong bản phát hành 3.0.6. Tên tài sản chính xác là:

  edgemicro:
      keep_alive_timeout

• 139526406 – Đã khắc phục một lỗi xảy ra số lượng hạn mức không chính xác nếu ứng dụng của nhà phát triển có nhiều sản phẩm. Giờ đây, hạn mức hiện được áp dụng chính xác cho từng sản phẩm trong một ứng dụng có nhiều sản phẩm. Tổ hợp 'appName + {0/}' được sử dụng làm giá trị nhận dạng hạn mức.

3.0.6

Vào thứ Năm, ngày 29 tháng 8, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

• 138633700 – Thêm một thuộc tính cấu hình mới là keepAliveTimeout. Thuộc tính này cho phép bạn đặt thời gian chờ của Edge Microgateway (tính bằng mili giây). (Mặc định: 5000 mili giây)

  Ví dụ:

  edgemicro:
    keep_alive_timeout: 600

• 140090623 – Thêm một thuộc tính cấu hình mới là quotaUri. Hãy đặt thuộc tính cấu hình này nếu bạn muốn quản lý hạn mức thông qua proxy edgemicro-auth được triển khai cho tổ chức của bạn. Nếu bạn không đặt thuộc tính này, điểm cuối hạn mức sẽ mặc định là điểm cuối Edge Microgateway nội bộ. Ví dụ:

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  Để sử dụng tính năng này, trước tiên, bạn phải triển khai phiên bản mới nhất của proxy edgemicro-auth cho tổ chức của mình. Để biết thông tin chi tiết, hãy xem nội dung Nâng cấp proxy Edgemicro-auth.

• 138722809 – Thêm một thuộc tính cấu hình mới là stack_trace. Thuộc tính này cho phép bạn kiểm soát xem dấu vết ngăn xếp có xuất hiện trong tệp nhật ký hay không. Ví dụ:

  stack_trace: false

  Nếu bạn đặt stack_trace thành true, dấu vết ngăn xếp sẽ được in trong nhật ký. Nếu bạn đặt chính sách này thành false, thì dấu vết ngăn xếp sẽ không được in trong nhật ký.

3.0.5

Vào thứ Năm, ngày 15 tháng 8, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

• 139005279 – Đã khắc phục sự cố khiến lệnh edgemicro status không trả về số lượng quy trình thực thi phù hợp.
• 138437710 – Một sự cố đã được khắc phục trong lớp ExitCounter khiến cho nhật ký phù hợp không được ghi.

• 139064652 – Thêm khả năng thêm cấp độ ghi nhật ký trace và debug cho nhật ký sự kiện và hệ thống. Hiện tại, hệ thống chỉ thêm khả năng thêm các cấp độ nhật ký này. Hiện tại, các cấp độ nhật ký có sẵn là info, warn và error.
• 139064616 – Đầu ra nhật ký đã được chuẩn hoá cho mọi câu lệnh nhật ký bảng điều khiển. Các câu lệnh ghi nhật ký trên bảng điều khiển nay bao gồm các thuộc tính sau:
• Dấu thời gian
• Tên thành phần
• ID quá trình
• Thông báo nhật ký trên bảng điều khiển

• 138413755 – Cải thiện khoá JWT và các thông điệp nhật ký liên quan đến bí mật cho các lệnh CLI sau: cert, verify, Upgradekvm, token, genkeys, Recallkeys, rotationkey và configuration.

• 138413577 – Thêm và cải thiện khả năng xử lý lỗi đối với thời gian chờ của dịch vụ phụ trợ.
• 138413303 – Thêm và cải thiện khả năng xử lý lỗi đối với thời gian chờ phản hồi và thời gian chờ của cổng.
• 138414116 – Thêm và cải thiện cách xử lý lỗi đối với lỗi "kết nối bị từ chối".

3.0.4

Vào thứ Năm, ngày 1 tháng 8, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

• 134445926 – Cải tiến cơ chế xác thực nội bộ Edge Microgateway.
• 137582169 – Giải quyết sự cố khiến các quy trình không mong muốn bắt đầu. Các quy trình bổ sung này đã khiến các trình bổ trợ tải lại và sử dụng quá nhiều bộ nhớ. Edge Microgateway hiện giữ số lượng quy trình trong giới hạn dự kiến.
• 137768774 – Cải thiện thông điệp nhật ký:
  • Đã xoá nhật ký giao dịch (yêu cầu).
  • Thêm thông điệp nhật ký khác khi cần.
  • Di chuyển thông điệp nhật ký giao dịch (yêu cầu) từ đầu ra của bảng điều khiển sang tệp nhật ký có liên quan.
  • Cập nhật nhật ký bảng điều khiển để dùng chức năng ghi nhật ký tập trung.
• 138321133, 138320563 – Thay đổi nội bộ cơ bản đối với vùng đệm hạn mức để có thể nâng cao hạn mức trong tương lai.

3.0.3

Vào thứ Ba, ngày 23 tháng 7, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

• Các tính năng nâng cao cho tính năng ghi nhật ký: Nhật ký thời gian chạy hiện có sử dụng một hàm eventLog() mới để thu thập và ghi nhật ký dữ liệu thời gian chạy ở một định dạng nhất quán. Thông tin nhật ký bao gồm:
  • Dấu thời gian (ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ).
  • Cấp độ nhật ký (lỗi, cảnh báo hoặc thông tin).
  • Tên máy chủ – Tên máy chủ yêu cầu từ tiêu đề của yêu cầu.
  • Mã quy trình – Nếu bạn đang chạy một cụm các quy trình Node.js, thì đây là mã của quy trình đã xảy ra quá trình ghi nhật ký.
  • Tên tổ chức Apigee.
  • Tên môi trường trong tổ chức.
  • Tên proxy API.
  • Địa chỉ IP của ứng dụng khách.
  • Mã ứng dụng khách.
  • Mã tham chiếu (hiện chưa được đặt).
  • Tên thành phần của Edge Microgateway.
  • Thông báo tuỳ chỉnh – Một số đối tượng có thể in thêm thông tin được truyền đến thuộc tính lỗi này.
  • Phương thức yêu cầu (nếu yêu cầu HTTP).
  • Mã trạng thái phản hồi (nếu có yêu cầu HTTP).
  • Thông báo lỗi.
  • Mã lỗi – Nếu một đối tượng chứa mã lỗi, thì đối tượng đó sẽ được in trong thuộc tính này.
  • Thời gian đã thực hiện.
  • Điểm đánh dấu cuối dòng của hệ điều hành.

  Giá trị thuộc tính rỗng sẽ dẫn đến dấu ngoặc rỗng, [].

  Ví dụ sau đây cho thấy định dạng nhật ký:

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• Hiệu suất: Các sản phẩm API không được lọc dựa trên môi trường. Chúng tôi đã khắc phục sự cố này. (135038879)
• Tích hợp kiểm thử chức năng khác và cải thiện chất lượng mã.

3.0.2

Vào thứ Tư, ngày 3 tháng 7 năm 2019, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

Chất lượng mã – Mã đã được xem xét về chất lượng và các thay đổi đối với mã đã được thực hiện để đáp ứng tiêu chuẩn chất lượng mà người dùng yêu cầu. Chúng tôi đã xử lý các lỗi và cảnh báo về chất lượng mã bắt nguồn từ JSHint. Kết quả là một số lỗi mã thực tế đã được xác định và sửa chữa. Tất cả mô-đun Apigee Edge Microgateway đều đã được đưa qua quy trình này. Xem các thay đổi cho ngày 28 tháng 6 và ngày 2 tháng 7 cho microgateway-config, microgateway-core, microgateway-plugins và microgateway. Tất cả mô-đun có thay đổi về chất lượng mã đều đã được kiểm thử bằng các công cụ nội bộ nhằm xác minh khả năng thực thi Edge Microgateway cho các trường hợp sử dụng của khách hàng.

3.0.1

Vào thứ Sáu, ngày 21 tháng 6 năm 2019, chúng tôi đã phát hành các bản sửa lỗi và tính năng nâng cao sau đây cho Edge Microgateway.

• 134834551 – Thay đổi các phiên bản Node.js được hỗ trợ cho Edge Microgateway
  (Phiên bản được hỗ trợ Node.js: 8 và 12; phiên bản 7, 9 và 11 đang thử nghiệm)
• 134751883 - Edge Microgateway gặp sự cố khi tải lại khi tải
• 134518428 – Điểm cuối của sản phẩm cho Edge Microgateway sẽ trả về 5XX nếu mẫu bộ lọc không chính xác
• 135113408 – Worker nên khởi động lại nếu chấm dứt đột ngột
• 134945852 – tokenCacheSize không được sử dụng trong trình bổ trợ OAuth
• 134947757 – đặt cacheTTL trong trình bổ trợ OAuth
• 135445171 – Tính toán hết hạn trong OAuth không chính xác
• Sử dụng mô-đun có ghi nhớ đi kèm khi cài đặt Edge Microgateway
• 135367906 – Kiểm tra bảo mật

Phiên bản 2.5.x

Các tính năng và tính năng nâng cao mới phiên bản 2.5.x

(Đã sửa lỗi 2.5.38, 07/06/2019)

JWT được định dạng không đúng cách có thể khiến worker gặp sự cố khi sử dụng bộ nhớ đệm của mã thông báo. Đã khắc phục trong mô-đun trình bổ trợ cổng vào vi mô của Edge. (b/134672029)

(Đã thêm 2.5.37) Thêm tuỳ chọn CLI edgemicro-cert -t.

Tuỳ chọn edgemicro cert -t cho phép bạn chỉ định mã thông báo OAuth để xác thực API quản lý. Xem thêm bài viết Quản lý chứng chỉ.

(Đã thêm 2.5.35) Thêm tính năng hỗ trợ để gỡ lỗi Edge Microgateway bằng edgemicroctl.

Bạn có thể sử dụng cờ mgdebug với edgemicroctl. Hãy xem thêm các nhiệm vụ tích hợp với Ubernetes.

(Đã thêm 2.5.35) Bật bản dựng Windows cho edgemicroctl.

(Đã thêm 2.5.31) API Edgemicro-auth/token mới

Một API Edgemicro-auth/token mới đã được thêm vào, cho phép bạn truyền ứng dụng khách/bí mật dưới dạng tiêu đề Uỷ quyền cơ bản được mã hoá Base64 và Grants_type dưới dạng tham số biểu mẫu. Xem Trực tiếp lấy mã thông báo truy cập.

(Đã sửa lỗi 2.5.31) Cấu hình riêng tư không tuân theo cờ mã thông báo

Chúng tôi đã khắc phục sự cố khi việc định cấu hình Edge Microgateway để sử dụng mã truy cập OAuth2 trên Edge cho Đám mây riêng tư không hoạt động đúng cách (mã không được tuân thủ).

Docker: Hỗ trợ việc sử dụng chứng chỉ tự ký

(Đã thêm 2.5.29) Nếu đang sử dụng một Tổ chức phát hành chứng chỉ (CA) không được Node.js tin cậy theo mặc định, thì bạn có thể sử dụng tham số NODE_EXTRA_CA_CERTS khi chạy vùng chứa Docker với Edge Microgateway. Để biết thông tin chi tiết, hãy xem phần Sử dụng CA không được Node.js tin cậy.

Docker: Hỗ trợ TLS

(Bổ sung 2.5.29) Edge Microgateway chạy trong vùng chứa Docker hiện hỗ trợ TLS cho các yêu cầu đến tới máy chủ Edge Microgateway (các yêu cầu hướng bắc) và các yêu cầu đi từ Edge Microgateway đến một ứng dụng mục tiêu (các yêu cầu hướng ra).

Các ví dụ sau đây giải thích chi tiết cách thiết lập các cấu hình TLS (Bảo mật tầng truyền tải) này:

• Ví dụ về cấu hình TLS hướng bắc
• Ví dụ về cấu hình TLS hướng nam

Trong những ví dụ này, bạn sẽ thấy cách sử dụng điểm gắn vùng chứa /opt/apigee/.edgemicro để tải các chứng chỉ, sau đó được tham chiếu trong tệp cấu hình Edge Microgateway.

Docker: Hỗ trợ việc ủy quyền yêu cầu

(Bổ sung 2.5.27) Nếu chạy Edge Microgateway trong vùng chứa Docker, bạn có thể sử dụng các tuỳ chọn sau để kiểm soát hành vi của proxy khi cổng microgateway chạy phía sau tường lửa:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Để biết thông tin chi tiết, hãy xem phần Chạy Edge Micro dưới dạng vùng chứa Docker.

Docker: Hướng dẫn cập nhật về trình bổ trợ

(Bổ sung 2.5.27) Nếu chạy Edge Microgateway trong vùng chứa Docker, bạn hiện có hai tuỳ chọn để triển khai các trình bổ trợ. Một lựa chọn mới là sử dụng điểm gắn Docker. Tuỳ chọn còn lại đã tồn tại trước đây, về cơ bản không thay đổi; tuy nhiên, Dockerfile đã được cập nhật. Để biết thông tin chi tiết, vui lòng tham khảo các đường liên kết sau:

• Cách A: Gắn thư mục trình bổ trợ vào một ổ đĩa (Mới)
• Lựa chọn B: Xây dựng trình bổ trợ vào vùng chứa (Đã cập nhật)

Hỗ trợ mã thông báo OAuth mới cho lệnh nâng cấp KVM

(Đã thêm ngày 2.5.27) Bạn có thể sử dụng mã thông báo OAuth bằng lệnh upgradekvm. Để biết thông tin chi tiết, hãy xem phần Nâng cấp KVM..

API tách biệt trong Analytics Edge

(Thêm ngày 2.5.26) Cờ trình bổ trợ phân tích mới cho phép bạn tách riêng một đường dẫn API cụ thể để đường dẫn đó xuất hiện dưới dạng một proxy riêng trong trang tổng quan của Edge Analytics. Ví dụ: bạn có thể tách riêng các API kiểm tra tình trạng để tránh nhầm lẫn các API này với các lệnh gọi API thực tế. Để biết thêm thông tin, hãy xem bài viết Loại trừ các đường dẫn khỏi số liệu phân tích.

Định cấu hình proxy cục bộ

(Thêm phiên bản 2.5.25) Với proxy cục bộ, bạn không cần tạo proxy nhận biết cổng vào theo cách thủ công trên Apigee Edge. Thay vào đó, cổng vào vi mô sẽ sử dụng đường dẫn cơ sở của proxy cục bộ. Để biết thêm thông tin, hãy xem phần Sử dụng chế độ proxy cục bộ.

Sử dụng chế độ độc lập

(Bổ sung ngày 2.5.25) Bạn có thể chạy Edge Microgateway bị ngắt kết nối hoàn toàn khỏi mọi phần phụ thuộc của Apigee Edge. Trường hợp này, được gọi là chế độ độc lập, cho phép bạn chạy và kiểm thử Edge Microgateway mà không cần kết nối Internet. Hãy xem phần Running Edge Microgateway ở chế độ độc lập.

Thu hồi chìa khoá

(Thêm 2.5.19) Một lệnh CLI mới đã được thêm vào để thu hồi thông tin xác thực khoá và bí mật đối với cấu hình Edge Microgateway.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

Hỗ trợ Docker

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

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

Nhóm hỗ trợ của Ubernetes

(Đã thêm 2.5.19) Bạn có thể triển khai Edge Microgateway dưới dạng một dịch vụ hoặc dưới dạng một cổng phụ trước các dịch vụ được triển khai trong cụm Kubernetes. Xem bài viết: Tích hợp Edge Microgateway với tổng quan về Kubernetes.

Hỗ trợ tuỳ chọn mạng lưới TCP

(Đã thêm 2.5.16) Một chế độ cài đặt cấu hình mới, nodelay, đã được thêm vào cấu hình Edge Micro.

Theo mặc định, các kết nối TCP sử dụng thuật toán Nagle để lưu dữ liệu vào bộ đệm trước khi gửi đi. Nếu bạn đặt nodelay thành true, hành vi này sẽ vô hiệu hoá (dữ liệu sẽ ngay lập tức kích hoạt dữ liệu mỗi khi socket.write() được gọi). Xem thêm tài liệu về Node.js để biết thêm thông tin chi tiết.

Để bật nodelay, hãy chỉnh sửa tệp cấu hình Edge Micro như sau:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

Các lựa chọn CLI mới cho hoạt động giám sát Vĩnh viễn

(Đã thêm 2.5.12) Các tham số mới đã được thêm vào lệnh edgemicro forever. Các tham số này cho phép bạn chỉ định vị trí của tệp forever.json và cho phép bạn bắt đầu hoặc dừng quá trình chạy ở chế độ nền Vĩnh viễn. Xem thêm bài viết Giám sát vĩnh viễn

Ví dụ:

Cách bắt đầu Vĩnh viễn:

edgemicro forever -f ~/mydir/forever.json -a start

Cách dừng Vĩnh viễn:

edgemicro forever -a stop

Xoay vòng khoá JWT

Một tính năng mới đã được thêm vào cho phép bạn xoay vòng các cặp khoá công khai/riêng tư dùng để tạo mã thông báo JWT dùng cho quá trình bảo mật OAuth trên Edge Microgateway. Xem nội dung Xoay phím JWT.

Lọc proxy API đã tải xuống

Theo mặc định, Edge Microgateway sẽ tải tất cả proxy trong tổ chức Edge của bạn xuống bắt đầu bằng tiền tố đặt tên "edgemicro_". Bạn có thể thay đổi chế độ mặc định này để tải các proxy có tên khớp với một mẫu xuống. Xem phần Lọc proxy đã tải xuống.

Chỉ định sản phẩm không có proxy API

Trong Apigee, bạn có thể tạo một sản phẩm API không chứa proxy API nào. Cấu hình sản phẩm này cho phép một khoá API liên kết với sản phẩm đó hoạt động thông qua mọi proxy được triển khai trong tổ chức của bạn. Kể từ phiên bản 2.5.4, Edge Microgateway hỗ trợ cấu hình sản phẩm này.

Hỗ trợ giám sát vĩnh viễn

Edge Microgateway có một tệp forever.json mà bạn có thể định cấu hình để kiểm soát số lần và khoảng thời gian nên khởi động lại Edge Microgateway. Tệp này định cấu hình một dịch vụ có tên forever-monitor, dịch vụ này quản lý Forever theo phương thức lập trình. Xem phần Theo dõi vĩnh viễn.

Quản lý tập trung tệp cấu hình Edge Micro

Nếu chạy nhiều thực thể Edge Microgateway, bạn nên quản lý các cấu hình của các thực thể đó từ một vị trí duy nhất. Bạn có thể thực hiện việc này bằng cách chỉ định một điểm cuối HTTP nơi Edge Micro có thể tải tệp cấu hình xuống. Xem phần Chỉ định điểm cuối của tệp cấu hình.

Hỗ trợ tuỳ chọn CLI vĩnh viễn

(Đã thêm 2.5.8) Dùng lệnh edgemicro forever [package.json] để chỉ định vị trí của tệp forever.json. Trước khi thêm lệnh này, tệp cấu hình phải nằm trong thư mục gốc của Edge Microgateway.

Ví dụ:

edgemicro forever ~/mydir/forever.json

Bổ sung tuỳ chọn configUrl để tải lại lệnh

(Đã thêm phiên bản 2.5.8) Giờ đây, bạn có thể sử dụng tuỳ chọn --configUrl hoặc -u bằng lệnh edgemicro reload.

Thời gian ân hạn đối với các sự khác biệt về thời gian JWT

(Bổ sung phiên bản 2.5.7) Thuộc tính gracePeriod trong cấu hình OAuth giúp ngăn chặn các lỗi do có sự chênh lệch nhỏ giữa đồng hồ hệ thống và thời gian Không được phát hành trước (nbf) hoặc được phát hành vào (iat) nêu trong mã thông báo uỷ quyền JWT. Hãy đặt thuộc tính này thành số giây để cho phép chênh lệch như vậy. Xem các thuộc tính OAuth.

(Bổ sung phiên bản 2.5.7) Thuộc tính gracePeriod trong cấu hình OAuth giúp ngăn chặn các lỗi do có sự chênh lệch nhỏ giữa đồng hồ hệ thống và thời gian Không được phát hành trước (nbf) hoặc được phát hành vào (iat) nêu trong mã thông báo uỷ quyền JWT. Hãy đặt thuộc tính này thành số giây để cho phép chênh lệch như vậy. Xem các thuộc tính OAuth.

Sửa lỗi phiên bản 2.5.x

• (Vấn đề #236) Sửa lỗi chính tả khi xoá bộ nhớ đệm.
• (Vấn đề #234) Tải lại sự cố cho Edge Microgateway 2.5.35.
• (Vấn đề #135) Lỗi "bảo mật" trong tham chiếu máy chủ ảo không hợp lệ khi sử dụng tuỳ chọn -v. Bản sửa lỗi này sửa đổi proxy Edgemicro-auth trước khi triển khai để đảm bảo các máy chủ ảo khớp chính xác với nội dung được chỉ định trong cờ "-v". Ngoài ra, bạn có thể chỉ định bất kỳ số lượng và tên bất kỳ cho máy chủ ảo (không còn bị giới hạn ở chế độ mặc định và bảo mật nữa).
• (Vấn đề #141) Lệnh Tài nguyên tải lại không hỗ trợ tuỳ chọn tệp cấu hình -c. Đã khắc phục sự cố này.
• (Vấn đề #142) Edge Microgateway phàn nàn về tiền mã hoá không dùng nữa tại thời điểm cài đặt. Đã khắc phục sự cố này.
• (Vấn đề #145) Hạn mức không hoạt động với Edge Microgateway. Đã khắc phục sự cố này.
• (Vấn đề về Cộng đồng Apigee: https://community.apigee.com/questions/33149/emg-jwt-token-validated-anti-cả-api-proxies-a.html#answer-33336) Mã thông báo JWT được xác thực dựa trên cả Proxy API và URI tài nguyên trong OAUTH. Chúng tôi đã khắc phục sự cố này.
• (Vấn đề về Cộng đồng Apigee: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway không hoạt động với OAuth. Đã khắc phục sự cố này.
• Sửa lỗi pidPath trên Windows.
• (Vấn đề #157) Sự cố gây ra thông báo lỗi sau đây đã được khắc phục: Không xác định ReferenceError: deployProxyWithPassword.
• (Vấn đề #169) Cập nhật phần phụ thuộc Node.js (kiểm tra npm)
• Proxy edgemicro-auth hiện sử dụng các chính sách Edge JWT. Proxy không còn phụ thuộc vào Node.js để cung cấp khả năng hỗ trợ JWT.

Phiên bản 2.4.x

Các tính năng và tính năng nâng cao mới phiên bản 2.4.x

1. Đặt bí danh tuỳ chỉnh cho proxy Edgemicro-auth (PR 116)

Bạn có thể thay đổi đường dẫn cơ sở mặc định cho proxy edgemicro-auth. Theo mặc định, đường dẫn cơ sở là /edgemicro-auth. Để thay đổi giá trị này, hãy sử dụng cờ -x trên lệnh edgemicro cấu hình.

Ví dụ:

edgemicro configure -x /mypath …

2. Hỗ trợ ký tự đại diện cho đường dẫn cơ sở (PR 77)

Bạn có thể sử dụng một hoặc nhiều ký tự đại diện "*" trong đường dẫn cơ sở của proxy edgemicro_*. Ví dụ: đường dẫn cơ bản của /team/*/members cho phép khách hàng gọi https://[host]/team/blue/members và https://[host]/team/green/members mà không cần tạo proxy API mới để hỗ trợ các nhóm mới. Xin lưu ý rằng hệ thống không hỗ trợ /**/.

3. Đã thêm đường dẫn cấu hình tuỳ chỉnh vào CLI cho cấu hình Đám mây riêng tư (PR 99)

Theo mặc định, tệp cấu hình cổng vi mô nằm trong ./config/config.yaml. Giờ đây, trên các lệnh init, cấu hình và bắt đầu, bạn có thể chỉ định một đường dẫn cấu hình tuỳ chỉnh trên dòng lệnh bằng cách sử dụng cờ -c hoặc --configDir. Khắc phục vấn đề không nhận dạng được thư mục cấu hình tuỳ chỉnh cho các lượt cài đặt trên Đám mây riêng tư.

Ví dụ:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4. Tôn trọng các biến *_PROXY (PR 61)

Nếu Edge Microgateway được cài đặt sau tường lửa và không thể giao tiếp với Apigee Edge trong đám mây công cộng, thì bạn có hai lựa chọn cần cân nhắc:

Cách 1:

Lựa chọn đầu tiên là đặt tuỳ chọn Edgemicro: proxy_tunnel thành true trong tệp cấu hình microgateway:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

Khi proxy_tunnel là true, Edge Microgateway sử dụng phương thức HTTP CONNECT để tạo đường hầm các yêu cầu HTTP qua một kết nối TCP. (Điều này cũng đúng nếu các biến môi trường dùng để định cấu hình proxy được bật TLS).

Cách 2:

Lựa chọn thứ hai là chỉ định một proxy và đặt proxy_tunnel thành false trong tệp cấu hình cổng vào siêu nhỏ. Ví dụ:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

Trong trường hợp này, bạn có thể đặt các biến sau để kiểm soát máy chủ cho từng proxy HTTP mà bạn muốn sử dụng hoặc những máy chủ không được xử lý proxy Microgateway Edge: HTTP_PROXY, HTTPS_PROXY và NO_PROXY. Bạn có thể đặt NO_PROXY thành một danh sách các miền được phân tách bằng dấu phẩy mà Edge Microgateway không nên proxy. Ví dụ:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

Để biết thêm thông tin về các biến này, hãy xem:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5. Đặt thời gian chờ tuỳ chỉnh cho các yêu cầu mục tiêu (PR 57)

Bạn có thể đặt thời gian chờ tuỳ chỉnh cho các yêu cầu mục tiêu bằng cấu hình sau:

edgemicro:
    request_timeout: 10

Thời gian chờ được đặt tính bằng giây. Nếu hết thời gian chờ, Edge Microgateway sẽ phản hồi bằng mã trạng thái 504.

6. Tuân thủ thông báo trạng thái HTTP tuỳ chỉnh trên phản hồi mục tiêu (PR 53)

Edge Microgateway tuân thủ thông báo trạng thái HTTP tuỳ chỉnh được đặt trên phản hồi mục tiêu. Trong các bản phát hành trước, thông báo trạng thái gửi từ mục tiêu đã bị ghi đè bằng các giá trị mặc định của Node.js.

7. Tiêu đề X-Forwarded-For có thể đặt client_ip cho số liệu phân tích

Nếu có, tiêu đề X-Forwarded-For sẽ đặt biến client_ip được báo cáo trong Edge Analytics. Tính năng này cho bạn biết IP của ứng dụng đã gửi yêu cầu đến Edge Microgateway.

8. Các thay đổi về trình bổ trợ OAuth

Trình bổ trợ OAuth hỗ trợ xác minh Khoá API và xác minh bằng mã thông báo truy cập OAuth. Trước sự thay đổi này, trình bổ trợ đã chấp nhận một trong hai hình thức bảo mật. Với thay đổi này, bạn chỉ có thể cho phép một trong các mô hình bảo mật đó (trong khi vẫn duy trì khả năng tương thích ngược).

Trình bổ trợ OAuth thêm hai cờ mới:

• allowOAuthOnly -- Nếu đặt thành allowOAuthOnly, mỗi API phải mang theo một Tiêu đề uỷ quyền có Mã truy cập mang tên.

• allowAPIKeyOnly – Nếu đặt thành true, mọi API phải mang một tiêu đề x-api-key (hoặc một vị trí tuỳ chỉnh) có một Khoá API.

Bạn đặt các cờ này trong tệp cấu hình Edge Microgateway như sau:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. Cải thiện proxy Edgemicro-auth (PR 40)

Chúng tôi đã cải tiến proxy edgemicro-auth. Trước những thay đổi này, proxy lưu trữ các khoá trong Edge Secure Store, một kho lưu trữ được mã hoá. Giờ đây, proxy lưu trữ các khoá trong bản đồ khoá-giá trị đã mã hoá (KVM) của Edge.

10. Viết lại URL đích mặc định trong trình bổ trợ (PR 74)

Bạn cũng có thể ghi đè cổng điểm cuối mục tiêu và chọn giữa HTTP và HTTPS. Sửa đổi các biến này trong mã trình bổ trợ: req.targetPort và req.targetSecure. Để chọn HTTPS, hãy đặt req.targetSecure thành true; đối với HTTP, hãy đặt thành false. Nếu bạn đặt req.targetSecure thành true, hãy xem chuỗi thảo luận này để biết thêm thông tin.

11. Hỗ trợ ban đầu cho việc xác thực mã thông báo OAuth (PR 125)

Bạn có thể định cấu hình Edge Microgateway để dùng mã thông báo OAuth cho việc xác thực thay vì tên người dùng/mật khẩu. Để dùng mã thông báo OAuth, hãy dùng tham số sau trong lệnh edgemicro cấu hình:

-t, --token <token>

Ví dụ:

edgemicro configure -o docs -e test -t <your token>

Sửa lỗi phiên bản 2.4.3

• Khắc phục vấn đề yêu cầu tổ chức trả phí phải chạy proxy Edgemicro-auth đúng cách. Hiện tại, bạn cũng có thể sử dụng Edge Microgateway với các tổ chức dùng thử. (Quan hệ công chúng 5)
• Khắc phục vấn đề luồng chưa xử lý xong dữ liệu nhưng các trình xử lý cuối vẫn đang thực thi. Điều này khiến hệ thống gửi phản hồi một phần. (PR 71)
• Khắc phục vấn đề không nhận dạng được thư mục cấu hình tuỳ chỉnh cho các lượt cài đặt trên Đám mây riêng tư. (PR 110)
• Khắc phục vấn đề về SSL hai chiều giữa ứng dụng và Edge Microgateway. (PR 70)
• Khắc phục vấn đề cần có dấu gạch chéo theo sau trên đường dẫn cơ sở proxy để xác minh khoá API hoạt động đúng cách. Bây giờ, không cần dấu gạch chéo ở cuối đường cơ sở. (PR 48)

Phiên bản 2.3.5

Các tính năng và tính năng nâng cao mới phiên bản 2.3.5

Lọc proxy

Bạn có thể lọc những proxy nhận biết cổng vi mô mà một thực thể Edge Microgateway sẽ xử lý. Khi Edge Microgateway khởi động, dịch vụ này sẽ tải tất cả các proxy nhận biết cổng vào ra trong tổ chức liên kết với Edge Microgateway. Sử dụng cấu hình sau để giới hạn những proxy nào mà cổng vào vi mô sẽ xử lý. Ví dụ: cấu hình này giới hạn các proxy mà cổng vào vi mô sẽ xử lý là 3: edgemicro_proxy-1, edgemicro_proxy-2 và edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Che giấu dữ liệu của Analytics

Cấu hình mới cho phép bạn ngăn thông tin đường dẫn của yêu cầu xuất hiện trong công cụ phân tích Edge. Thêm phần sau vào cấu hình cổng vào vi mô để che giấu URI yêu cầu và/hoặc đường dẫn yêu cầu. Xin lưu ý rằng URI bao gồm phần tên máy chủ và đường dẫn của yêu cầu.

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

Phiên bản 2.3.3

Các tính năng và tính năng nâng cao mới phiên bản 2.3.3

Sau đây là các tính năng và tính năng nâng cao mới trong bản phát hành này.

Tắt tính năng tự động thăm dò ý kiến thay đổi

Bạn có thể tắt tính năng tự động thay đổi cuộc thăm dò bằng cách đặt thuộc tính này trong cấu hình cổng vào vi mô:

disabled_config_poll_interval: true

Theo mặc định, tính năng thăm dò định kỳ sẽ chọn mọi thay đổi được thực hiện trên Edge (thay đổi đối với sản phẩm, proxy nhận biết cổng vào vi mô, v.v.) cũng như các thay đổi được thực hiện đối với tệp cấu hình cục bộ. Khoảng thời gian thăm dò mặc định là 600 giây (5 phút).

Viết lại URL đích trong trình bổ trợ

Bạn có thể ghi đè URL mục tiêu mặc định một cách linh động trong trình bổ trợ bằng cách sửa đổi các biến sau trong mã trình bổ trợ: req.targetHostname và req.targetPath.

Chữ ký hàm mới trong trình bổ trợ

Một chữ ký hàm mới trong trình bổ trợ đã được thêm vào để cung cấp phản hồi mục tiêu dưới dạng một đối số. Việc bổ sung này giúp các trình bổ trợ truy cập vào phản hồi mục tiêu dễ dàng hơn.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

Đơn giản hoá dữ liệu đầu ra ghi nhật ký mặc định

Theo mặc định, dịch vụ ghi nhật ký hiện bỏ qua JSON của các proxy, sản phẩm và JWT đã tải xuống. Bạn có thể đổi sang chế độ mặc định để xuất các đối tượng này bằng cách đặt DEBUG=* khi khởi động Edge Microgateway. Ví dụ:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

Đã thêm đường dẫn cấu hình tuỳ chỉnh vào CLI

Theo mặc định, tệp cấu hình cổng vào vi mô nằm ở ./config/config.yaml. Giờ đây, trên các lệnh init, định cấu hình và bắt đầu, bạn có thể chỉ định một đường dẫn cấu hình tuỳ chỉnh trên dòng lệnh. Ví dụ:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

Sửa lỗi phiên bản 2.3.3

• Khắc phục sự cố rò rỉ bộ nhớ xảy ra trong các yêu cầu/phản hồi có kích thước lớn.
• Đã khắc phục thứ tự thực thi trình bổ trợ. Quy tắc này hiện đang hoạt động theo cách giải thích trong tài liệu.
• Trình bổ trợ yêu cầu tích luỹ trình bổ trợ không còn bị treo đối với các yêu cầu GET.
• Chúng tôi đã khắc phục một vấn đề trong trình bổ trợ phản hồi tích luỹ, trong đó việc thiếu nội dung phản hồi đã gây ra lỗi.

Bản phát hành 2.3.1

Ghi chú cài đặt

Một số phiên bản trước của Edge Microgateway cho phép bạn cài đặt phần mềm bằng cách tải tệp ZIP xuống. Các tệp ZIP này không còn được hỗ trợ nữa. Để cài đặt Edge Microgateway, bạn phải sử dụng:

npm install -g edgemicro

Hãy tham khảo chủ đề cài đặt để biết thêm thông tin chi tiết.

Các tính năng và tính năng nâng cao mới phiên bản 2.3.1

Sau đây là các tính năng và tính năng nâng cao mới trong bản phát hành này.

Lọc proxy

Cấu hình mới cho phép bạn lọc những proxy mà Edge Microgateway sẽ tải khi khởi động. Trước đây, cổng vào vi mô đã tải tất cả các proxy nhận biết cổng vi mô (prox có tên là Edgemicro_*) được lấy từ tổ chức/môi trường Edge mà bạn chỉ định trong lệnh định cấu hình Edgemicro. Tính năng mới này cho phép bạn lọc danh sách proxy này để Edge Microgateway chỉ tải những proxy mà bạn chỉ định. Bạn chỉ cần thêm phần tử proxy vào tệp cấu hình cổng vào vi mô như sau:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

Ví dụ: giả sử bạn có 50 proxy edgemicro_* trong org/env Edge của mình, bao gồm cả những proxy có tên edgemicro_foo và edgemicro_bar. Bạn có thể yêu cầu cổng vào vi mô chỉ sử dụng 2 proxy này như sau:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Khi khởi động, cổng vào vi mô sẽ chỉ có thể gọi các proxy đã chỉ định. Mọi nỗ lực gọi các proxy nhận biết cổng vào vi mô khác được tải xuống từ tổ chức/môi trường Edge sẽ gây ra lỗi.

Đặt tiêu đề của yêu cầu mục tiêu trong trình bổ trợ

Có 2 mẫu cơ bản cần xem xét nếu bạn muốn thêm hay sửa đổi tiêu đề của yêu cầu mục tiêu: một mẫu mà trong đó yêu cầu đến chứa dữ liệu (như trong yêu cầu POST) và mẫu còn lại là không có dữ liệu (như trong một yêu cầu GET đơn giản).

Hãy xem xét trường hợp trong đó yêu cầu đến chứa dữ liệu và bạn muốn đặt tiêu đề của yêu cầu cho yêu cầu đích. Trong các phiên bản trước của Edge Microgateway, bạn không thể đặt tiêu đề mục tiêu một cách chính xác trong trường hợp này.

Chìa khoá cho mẫu này trước tiên là tích luỹ tất cả dữ liệu nhận được từ ứng dụng khách. Sau đó, trong hàm onend_request(), hãy dùng hàm mới request.setOverrideHeader(name, value) để tuỳ chỉnh tiêu đề.

Dưới đây là mã trình bổ trợ mẫu cho thấy cách thực hiện việc này. Các tiêu đề được đặt trong onend_request sẽ được gửi đến mục tiêu:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

Nếu yêu cầu không bao gồm dữ liệu, thì bạn có thể đặt tiêu đề mục tiêu trong trình xử lý onrequest(). Mẫu này không phải là mẫu mới – đã được ghi lại trước đây và từng được sử dụng trong các trình bổ trợ mẫu được cung cấp qua Edge Microgateway.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

Tính năng tải lại theo thời gian không ngừng hoạt động

Sau khi thay đổi cấu hình cho Edge Microgateway, bạn có thể tải cấu hình mà không cần bỏ qua bất kỳ thông báo nào. Với thay đổi này, Edge Microgateway luôn khởi động ở chế độ cụm đồng hồ và tuỳ chọn --cluster đã bị xoá khỏi lệnh edgemicro start.

Ngoài ra, chúng tôi cũng thêm 3 lệnh CLI mới. Bạn phải chạy các lệnh này từ cùng một thư mục nơi thực thi lệnh bắt đầu Edgemicro:

• edgemicro status – Kiểm tra xem Edge Microgateway có đang chạy hay không.
• edgemicro stop – Dừng cụm Edge Microgateway.
• edgemicro reload – Tải lại cấu hình Edge Microgateway mà không bị ngừng hoạt động.

Cấu hình tự động tải lại mà không có thời gian ngừng hoạt động

Edge Microgateway tải cấu hình mới theo định kỳ và thực thi quá trình tải lại nếu có gì thay đổi. Cuộc thăm dò ý kiến chọn mọi thay đổi được thực hiện trên Edge (thay đổi đối với sản phẩm, proxy nhận biết cổng vào vi mô, v.v.) cũng như các thay đổi đối với tệp cấu hình cục bộ. Khoảng thời gian thăm dò mặc định là 600 giây (5 phút). Bạn có thể thay đổi giá trị mặc định trong tệp cấu hình microgateway như sau:

edgemicro:
    config_change_poll_interval: [seconds]

Đã thêm thông tin phiên bản vào CLI

Một cờ --version đã được thêm vào CLI. Để tải phiên bản hiện tại của Edge Microgateway, hãy sử dụng:

edgemicro --version

Các tuỳ chọn SSL của máy chủ Microgateway mới ở Edge

Edge Microgateway hiện hỗ trợ các tuỳ chọn SSL của máy chủ sau đây, ngoài key và cert:

Gửi tệp nhật ký đến stdout

Bạn có thể gửi dữ liệu nhật ký tới đầu ra chuẩn bằng chế độ cài đặt cấu hình mới:

edgemicro:
  logging:
    to_console: true  

Xem phần Quản lý tệp nhật ký.

Phiên bản 2.1.2

Sau đây là các tính năng và tính năng nâng cao mới trong bản phát hành này.

Cho phép điểm cuối API tuỳ chỉnh cho cấu hình

Có các điểm cuối mới có thể định cấu hình cho proxy uỷ quyền để hỗ trợ việc sử dụng dịch vụ xác thực tuỳ chỉnh. Các điểm cuối đó là:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Để biết chi tiết, hãy xem phần Sử dụng dịch vụ xác thực tuỳ chỉnh.

Phiên bản 2.1.1

Sau đây là các tính năng và tính năng nâng cao mới trong bản phát hành này.

Triển khai tính năng tương thích với nhiều nền tảng của proxy xác thực

Chúng tôi đã cải tiến để lệnh dùng để triển khai proxy uỷ quyền Edge Microgateway cho Edge tương thích trên các hệ thống Windows.

Phiên bản 2.1.0

Các tính năng và tính năng nâng cao mới phiên bản 21.0

Sau đây là các tính năng và tính năng nâng cao mới:

Chỉ định các tuỳ chọn SSL/TLS của ứng dụng

Bạn có thể chỉ định tuỳ chọn máy khách cho kết nối SSL/TSL cho các mục tiêu bằng cách sử dụng tập hợp tuỳ chọn cấu hình mới. Xem phần Sử dụng tuỳ chọn SSL/TSL máy khách.

Phiên bản 2.0.11

Ghi chú cài đặt phiên bản 2.0.11

Một số phiên bản trước của Edge Microgateway cho phép bạn cài đặt phần mềm bằng cách tải tệp ZIP xuống. Các tệp ZIP này không còn được hỗ trợ nữa. Để cài đặt Edge Microgateway, bạn phải sử dụng:

npm install -g edgemicro

Hãy tham khảo chủ đề cài đặt để biết thêm thông tin chi tiết.

Các tính năng và tính năng nâng cao mới phiên bản 2.0.11

Sau đây là các tính năng và tính năng nâng cao mới:

Chỉ định cổng khi khởi động

Lệnh start cho phép bạn chỉ định số cổng để ghi đè cổng được chỉ định trong tệp cấu hình. Bạn cũng có thể chỉ định số cổng bằng cách sử dụng biến môi trường PORT. Xem phần bắt đầu lệnh để biết thông tin chi tiết.

Không bắt buộc giữ lại tiêu đề xác thực

Chế độ cài đặt cấu hình mới, keepAuthHeader, bạn có thể giữ lại tiêu đề Uỷ quyền đã gửi trong yêu cầu. Nếu bạn đặt chính sách này thành true, thì tiêu đề Xác thực sẽ được chuyển tới mục tiêu. Hãy xem các thuộc tính OAuth.

Khả năng sử dụng dịch vụ uỷ quyền tuỳ chỉnh

Nếu bạn muốn sử dụng dịch vụ tuỳ chỉnh của riêng mình để xử lý việc xác thực, hãy thay đổi giá trị authUri trong tệp cấu hình Edge Microgateway để trỏ đến dịch vụ của bạn. Để biết chi tiết, hãy xem phần Sử dụng dịch vụ xác thực tuỳ chỉnh.

Phiên bản 2.0.4

Edge Microgateway v.2.0.4 được phát hành vào ngày 25 tháng 5 năm 2016.

Tính năng và tính năng nâng cao mới phiên bản 2.0.4

Sau đây là các tính năng mới và tính năng nâng cao trong bản phát hành này.

Hỗ trợ đường dẫn tài nguyên trong sản phẩm

Edge Microgateway hiện hỗ trợ đường dẫn tài nguyên trong các sản phẩm. Đường dẫn tài nguyên cho phép bạn hạn chế quyền truy cập vào API dựa trên hậu tố đường dẫn proxy. Để biết thông tin chi tiết về cách tạo sản phẩm và định cấu hình đường dẫn tài nguyên, hãy xem nội dung Tạo sản phẩm API.

Hỗ trợ cài đặt toàn cục npm

Bạn hiện có thể cài đặt Edge Microgateway bằng cách sử dụng tuỳ chọn npm -g (global). Để biết thông tin chi tiết về lựa chọn này, hãy tham khảo tài liệu về npm.

Phiên bản 2.0.0

Edge Microgateway v2.0.0 được phát hành vào ngày 18 tháng 4 năm 2016.

Các tính năng và tính năng nâng cao mới phiên bản 2.0.0

Sau đây là các tính năng mới và tính năng nâng cao trong bản phát hành này.

Máy chủ xử lý duy nhất

Edge Microgateway hiện là một máy chủ xử lý duy nhất. Công cụ này không còn sử dụng mô hình 2 quy trình, trong đó một quy trình (trước đây gọi là "tác nhân") khởi chạy Edge Microgateway, quy trình thứ hai. Cấu trúc mới giúp việc tự động hoá và đóng vùng chứa trở nên dễ dàng hơn.

Tệp cấu hình giãn cách tên

Các tệp cấu hình hiện được phân vùng bằng cách sử dụng tổ chức và môi trường để nhiều thực thể Microgateway có thể chạy trên cùng một máy chủ lưu trữ. Bạn có thể tìm thấy các tệp cấu hình trong ~/.edgemicro sau khi chạy lệnh config của Edge Microgateway.

Biến môi trường mới

Hiện có 4 biến môi trường: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Nếu đặt các biến này trên hệ thống, bạn không cần chỉ định giá trị của các biến đó khi sử dụng Giao diện dòng lệnh (CLI) để định cấu hình và khởi động Edge Microgateway.

Cấu hình được lưu vào bộ nhớ đệm

Edge Microgateway sẽ sử dụng tệp cấu hình đã lưu vào bộ nhớ đệm nếu khởi động lại mà không kết nối với Apigee Edge.

Chế độ cụm

Hiện có các tuỳ chọn để khởi động Edge Microgateway ở chế độ cụm. Chế độ cụm cho phép bạn tận dụng các hệ thống đa nhân. Cổng vi mô sử dụng mô-đun cụm Node.js cho tính năng này. Để biết thông tin chi tiết, hãy xem tài liệu về Node.js.

Đã sửa lỗi phiên bản 2.0.0

Vòng đời sự kiện của trình bổ trợ hiện xử lý đúng cách mã không đồng bộ chứa mã bằng một lệnh gọi lại mới.

Phiên bản 1.1.2

Edge Microgateway v. 1.1.2 được phát hành vào ngày 14 tháng 3 năm 2016.

Tính năng và tính năng nâng cao mới v.1.1.2

Sau đây là các tính năng mới và tính năng nâng cao trong bản phát hành này.

Cải thiện hiệu suất

Edge Microgateway hiện sử dụng tác nhân HTTP Node.js đúng cách để tổng hợp kết nối hiệu quả hơn. Tính năng nâng cao này giúp cải thiện hiệu suất và độ ổn định tổng thể trong tình trạng tải cao.

Hỗ trợ trình gỡ lỗi từ xa

Bạn có thể định cấu hình Edge Microgateway để chạy bằng một trình gỡ lỗi từ xa, chẳng hạn như node-inspector.

Vị trí mới cho tệp cấu hình

Khi bạn định cấu hình Edge Microgateway, tệp agent/config/default.yaml hiện sẽ được sao chép vào ~./edgemicro/config.yaml.

Chế độ xoay vòng của tệp nhật ký

Thuộc tính cấu hình mới cho phép bạn chỉ định khoảng thời gian xoay cho nhật ký Edge Microgateway.

Đã sửa lỗi phiên bản 1.1.2

Các lỗi sau được khắc phục trong phiên bản 1.1.2.