4.16.05 – Ghi chú phát hành Edge for Private Cloud

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

Vào thứ Ba, ngày 31 tháng 5 năm 2016, chúng tôi đã phát hành phiên bản mới của Apigee Edge cho Đám mây riêng tư.

Kể từ Bản phát hành tính năng Edge cho Đám mây riêng tư trước đó (4.16.01), các bản phát hành sau đây đã diễn ra và được đưa vào Bản phát hành tính năng này:

• Cloud: 16.02.17, 16.03.02, 16.03.09 (giao diện người dùng), 16.03.16 (giao diện người dùng), 16.03.23 (giao diện người dùng), 16.03.30

Hãy xem phần Giới thiệu về cách đánh số bản phát hành để biết cách xác định xem một bản phát hành cụ thể trên đám mây có được đưa vào phiên bản Edge cho Đám mây riêng tư của bạn hay không.

Tính năng mới và điểm cải tiến

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này. Ngoài những điểm cải tiến sau, bản phát hành này còn có nhiều điểm cải tiến về khả năng sử dụng, hiệu suất, tính bảo mật và độ ổn định.

Để biết thêm thông tin chi tiết và hướng dẫn, hãy xem tài liệu về Edge cho Đám mây riêng tư.

Hướng dẫn lắp đặt và vận hành đã được chuyển sang hình thức trực tuyến

Giờ đây, bạn có thể truy cập vào hướng dẫn Cài đặt và vận hành Edge cho Đám mây riêng tư tại Phiên bản 4.18.01.

Cập nhật phần mềm

Bản phát hành này bao gồm các bản cập nhật phần mềm sau:

• Java JDK 1.8 – Để tận dụng các tính năng mới nhất của Java, bản phát hành này tương thích với Java 1.8. Bạn phải có Oracle JDK 1.8 hoặc OpenJDK 8 trong môi trường của mình.
  Trong quá trình cập nhật lên Java 8, một số mật mã TLS không còn có trong Oracle JDK 1.8. Để xem danh sách đầy đủ, hãy xem phần "Default Disabled Cipher Suites" (Bộ mật mã bị vô hiệu hoá theo mặc định) http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
• Cassandra 2.1.13 – Cập nhật từ Cassandra 2.0.15.

Cài đặt, nâng cấp, khôi phục

Sau đây là danh sách các thay đổi đối với quá trình cài đặt, nâng cấp và các tập lệnh liên quan. Để biết thông tin về cách sử dụng, hãy xem tài liệu về Edge cho Đám mây riêng.

• Quy trình mới để cập nhật từ phiên bản 4.16.01 – Bản phát hành này thay thế tiện ích apigee-migrate bằng tiện ích update.sh để cập nhật bản cài đặt từ phiên bản 4.16.01 lên 4.16.05. Xem phần Cập nhật Apigee Edge 4.16.01 lên 4.16.05.
• Bootstrap
  • bootstrap.sh (phiên bản 4.16.01) hiện là bootstrap_4.16.05.sh trong phiên bản 4.16.05.
  • Bạn không cần chỉ định uname:pword để tải bootstrap_4.16.05.sh xuống nữa.
• Quay lại – Để quay lại bản cập nhật 4.16.05, bạn phải gỡ cài đặt phiên bản 4.16.05 của thành phần và cài đặt lại phiên bản trước đó. Tiện ích rollback.sh trước đây đã bị xoá. Xem phần 4.16.05 Quy trình khôi phục.
• setup.sh và update.sh có thể ghi tệp nhật ký vào /tmp – Theo mặc định, các tiện ích setup.sh và update.sh sẽ ghi thông tin nhật ký vào /opt/apigee/var/log/apigee-setup. Nếu người dùng chạy tiện ích không có quyền truy cập vào thư mục đó, thì tiện ích sẽ ghi nhật ký vào thư mục /tmp. Nếu người dùng không có quyền truy cập vào /tmp, thì tiện ích này sẽ không hoạt động.
• Quy trình cập nhật API BaaS – Trong bản phát hành 4.16.01, bạn phải cài đặt lại API BaaS để di chuyển API này. Tiện ích update.sh mới hỗ trợ việc cập nhật API BaaS tại chỗ. Xem phần Cập nhật Apigee Edge 4.16.01 lên 4.16.05.

Quản trị

Sau đây là các tính năng mới để quản trị và định cấu hình Đám mây riêng.

• Xác thực quá trình cài đặt – Giờ đây, bạn có thể chạy tiện ích apigee-validate dùng để kiểm thử quá trình cài đặt Edge Private Cloud từ Máy chủ quản lý. Trước đây, bạn cần chạy tập lệnh trên Trình xử lý tin nhắn. Xem phần Kiểm thử quá trình cài đặt.
• Tên khu vực – Khu vực có thể là bất kỳ tên nào. Trong các bản phát hành trước, tên có dạng "dc-#", trong đó # là một giá trị số nguyên.
• Nhóm cổng – Nhóm cổng có thể có tên bất kỳ. Trong các bản phát hành trước, nhóm phải được đặt tên là "gateway".
• Quản trị dựa trên tập lệnh – Tiện ích dòng lệnh apigee-adminapi.sh mới cho phép bạn thực hiện các tác vụ định cấu hình Edge tương tự như khi bạn thực hiện bằng cách gọi API quản lý Edge. Xem phần Sử dụng tiện ích apigee-adminapi.sh.
• Cấu hình SSL ẩn của máy chủ ảo – Khi tạo một tổ chức hoặc môi trường, giờ đây, bạn có thể truyền các thuộc tính để định cấu hình SSL trên một máy chủ ảo. Xem phần Thiết lập cho tổ chức.

Dịch vụ API

Sau đây là các tính năng mới cho Dịch vụ API Edge, được cung cấp trong các phiên bản đám mây trước của sản phẩm.

Tiền tố có độ dài cố định để ghi nhật ký thông báo syslog (Cloud 16.03.30)

Chính sách Ghi nhật ký tin nhắn có một phần tử <FormatMessage> mới trong cấu hình Syslog. Bằng cách thiết lập <FormatMessage>true</FormatMessage>, các thông báo Syslog bắt đầu bằng một số lượng ký tự cố định, cho phép bạn lọc ra dữ liệu do Apigee chèn. Để biết thêm thông tin, hãy xem Chính sách ghi nhật ký thông báo. (APIRT-1398)

Ký tự đại diện trong Đường dẫn cơ sở của proxy API (Giao diện người dùng Cloud 16.03.09)

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

Chuỗi proxy API (Cloud 16.03.02, giao diện người dùng Cloud 16.03.09)

Edge hỗ trợ việc liên kết proxy API cục bộ, cho phép một proxy API gọi một proxy API khác được triển khai trong tổ chức Edge của bạn mà không cần thêm chi phí mạng. Trước đây, việc liên kết chuỗi proxy API yêu cầu một lệnh gọi http(s) đến một proxy API khác, lệnh gọi này sẽ chuyển tiếp yêu cầu thông qua một bộ cân bằng tải, bộ định tuyến và bộ xử lý thông báo.

Các phần tử LocalTargetConnection mới có trên TargetEndpoint của một proxy API, cho phép bạn chỉ định tên proxy API, tên của một ProxyEndpoint cụ thể trong một proxy API hoặc chỉ cần Đường dẫn cơ sở đến một tài nguyên proxy API cục bộ (chẳng hạn như /v1/myresource). Giao diện người dùng của trình chỉnh sửa proxy cũng cung cấp các lựa chọn này khi bạn thêm hoặc cập nhật TargetEndpoint.

Tính năng liên kết proxy cũng có trong chính sách Chú thích dịch vụ.

Để biết thêm thông tin, hãy xem phần Liên kết các proxy API với nhau. Các phần tử LocalTargetConnection mới cũng được liệt kê trong giản đồ XML tại đây: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Các lỗi đã được khắc phục

Các lỗi sau đây đã được khắc phục trong bản phát hành này. Danh sách này chủ yếu dành cho những người dùng kiểm tra để xem các phiếu yêu cầu hỗ trợ của họ đã được giải quyết hay chưa. Báo cáo này không được thiết kế để cung cấp thông tin chi tiết cho tất cả người dùng.

Edge for Private Cloud 4.16.05

Cloud 16.03.30

Giao diện người dùng Cloud 16.03.16

Giao diện người dùng Cloud 16.03.09

Cloud 16.03.02

Cloud 16.02.17

Vấn đề đã biết

Bản phát hành này có các vấn đề đã biết sau đây.

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Tải trọng JSON trong các chính sách Assign Message, Java Callout và Raise Fault

Các chính sách Assign Message, Java Callout và Raise Fault cho phép bạn tạo nội dung thông báo bằng phần tử <Set><Payload>. Trong những thông báo đó, bạn có thể thêm các biến có giá trị được tự động điền vào thời gian chạy. Ví dụ: nếu muốn xuất ngày từ tiêu đề HTTP, bạn có thể chèn {message.header.date} vào thông báo.

Nếu định dạng thông báo là JSON, thì thông báo sẽ có dạng như sau:

{"The date is: " : "{message.header.date}"}

Tuy nhiên, bạn có thể thấy rằng đó là JSON không đúng định dạng. Để giải quyết vấn đề này, bạn có thể chọn một trong hai cách sau:

• Thoát dấu ngoặc nhọn mở bằng dấu gạch chéo ngược:

  \{"The date is: " : "{message.header.date}"}

• Trong cấu hình phần tử Payload, hãy sử dụng các thuộc tính variablePrefix và variableSuffix để cho biết một biến trong tải trọng JSON. Ví dụ:
  

  <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

Trong Bản phát hành tính năng tiếp theo của Edge cho Đám mây riêng tư, bạn sẽ có thể sử dụng dấu ngoặc nhọn cho các biến trong thông báo JSON mà không gặp vấn đề gì. (APIRT-1160)

Bộ định tuyến không khởi động được Nginx hoặc Bộ định tuyến không khởi động được

Nếu Bộ định tuyến biên không khởi động được Nginx hoặc không khởi động được, như trong tệp /opt/apigee/var/log/edge-router/logs/system.log, hãy xoá tất cả các tệp trong thư mục /opt/nginx/conf.d rồi khởi động lại bộ định tuyến:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart