Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về
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 một phiên bản mới của Apigee Edge dành cho đám mây riêng tư.
Kể từ phiên bản Edge trước dành cho Bản phát hành tính năng đám mây riêng tư (4.16.01), các bản phát hành sau đã ra mắt 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 bài viết Giới thiệu về cách đánh số bản phát hành để tìm hiểu cách xác định xem một bản phát hành cụ thể trên đám mây có trong phiên bản Edge dành cho đám mây riêng tư hay không.
Tính năng mới và tính năng nâng cao
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. Ngoài các tính năng nâng cao sau đây, bản phát hành này cũng nâng cao khả năng hữu dụng, hiệu suất, bảo mật và độ ổn định.
Để biết thêm thông tin và hướng dẫn, hãy xem tài liệu về Edge dành cho đám mây riêng tư.
Hướng dẫn cài đặt và vận hành đã được chuyển 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 đám mây riêng tư của Edge tại Phiên bản 4.18.01.
Cập nhật phần mềm
Bản phát hành có các bản cập nhật phần mềm sau đây:
- Java JDK 1.8 – Để tận dụng các tính năng Java mới nhất, bản phát hành này tương thích với Java 1.8. Oracle JDK 1.8 hoặc OpenJDK 8 được yêu cầu trong môi trường của bạn.
Trong bản cập nhật cho Java 8, một số thuật toán mật mã TLS không còn có trong Oracle JDK 1.8 nữa. Để xem danh sách đầy đủ, hãy xem phần "Default Disabled Cipher Suite" (Bộ thuật toán mật mã bị tắt 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 thay đổi đối với việc cài đặt, nâng cấp và 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 dành cho đám mây riêng tư.
- Quy trình mới để cập nhật từ 4.16.01 – Bản phát hành này thay thế tiện ích
apigee-migrate
bằng tiện íchupdate.sh
để cập nhật bản cài đặt của bạn từ 4.16.01 lên 4.16.05. Xem bài viết Cập nhật Apigee Edge 4.16.01 lên 4.16.05. -
Khởi động
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ảibootstrap_4.16.05.sh
xuống nữa.
- Khôi phục – Để khôi phục bản cập nhật về 4.16.05, bạn sẽ gỡ cài đặt phiên bản 4.16.05 của thành phần rồi cài đặt lại phiên bản trước đó. Tiện ích
rollback.sh
trước đây đã bị xoá. Xem 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 íchsetup.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 đang 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
, 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 đó. Tiện ích
update.sh
mới hỗ trợ cập nhật API BaaS tại chỗ. Xem bài viết 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 dành cho việc quản trị và định cấu hình Đám mây riêng tư.
- Xác thực chế độ cài đặt
– Giờ đây, tiện ích
apigee-validate
dùng để kiểm tra việc cài đặt Edge Private Cloud trên Máy chủ quản lý có thể chạy được. Trước đây, tập lệnh cần chạy trên Bộ xử lý thông báo. Vui lòng xem phần Kiểm thử bản cài đặt. - Tên vùng – Khu vực có thể là tên bất kỳ. 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 vào có thể có bất kỳ tên nào. Trong các bản phát hành trước, nhóm phải được đặt tên là "cổng vào".
- 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ùng các tác vụ định cấu hình Edge mà bạn thực hiện bằng cách thực hiện lệnh gọi đến API quản lý Edge. Hãy xem phần Sử dụng tiện ích apigee-adminapi.sh. - Cấu hình im lặng SSL cho 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áy chủ ảo. Hãy xem phần Giới thiệu một 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 phân phối trong các phiên bản đám mây trước đây của sản phẩm này.
Tiền tố có độ dài cố định cho tính năng ghi nhật ký thông báo nhật ký hệ thống (Cloud 16.03.30)
Chính sách Ghi nhật ký thông báo có một phần tử <FormatMessage>
mới trong cấu hình Nhật ký hệ thống. Khi bạn đặt <FormatMessage>true</FormatMessage>
, thông báo Nhật ký hệ thống sẽ 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ư. (APIRT-1398)
Ký tự đại diện trong đường dẫn cơ sở 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ở của /team/*/members
cho phép ứ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 phải tạo proxy mới để hỗ trợ các nhóm mới. Xin lưu ý rằng /**/
không được phép. (theo giờ GMT-3154)
Tạo chuỗi proxy API (Giao diện người dùng Cloud 16.03.02, Cloud 16.03.09)
Edge hỗ trợ chuỗi 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 mất thêm chi phí mạng. Trước đây, việc tạo chuỗi proxy API yêu cầu một lệnh gọi http đế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 trình cân bằng tải, bộ định tuyến và trình xử lý thông báo.
Các phần tử LocalTargetConnection
mới có sẵn trên TargetEndpoint của proxy API, cho phép bạn chỉ định tên proxy API, tên của một ProxyEndpoint cụ thể trong proxy API hoặc đơn giản là Đườ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 tuỳ chọn này khi bạn thêm hoặc cập nhật TargetEndpoint.
Bạn cũng có thể sử dụng chuỗi proxy 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.
(theo giờ GMT-3049, MGMT-3050)
Đã sửa lỗi
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 người dùng kiểm tra xem phiếu yêu cầu hỗ trợ của họ đã được khắc phục hay chưa. API này không nhằm cung cấp thông tin chi tiết cho tất cả người dùng.
Edge cho Đám mây riêng tư 4.16.05
ID vấn đề | Nội dung mô tả |
---|---|
PRC-770 | Trình cài đặt 16.01 không đăng ký được máy chủ chờ Postgres trong axgroup |
PRC-758 | Người dùng có vai trò Người dùng có thể chỉnh sửa báo cáo tuỳ chỉnh |
PRC-883 | Cập nhật về máy chủ Postgres có cấu hình chờ chính không thành công |
Đám mây 16.03.30
ID vấn đề | Nội dung mô tả |
---|---|
SECENG-584 | Quy trình kiểm tra xác thực dòng mới giữa các chứng chỉ trong chuỗi chứng chỉ gây ra sự cố với một số chứng chỉ trong phiên bản chính thức |
MGMT-3217 | Lệnh gọi API quản lý không thành công nếu tên KVMap kết thúc bằng "khoá" |
MGMT-3214 | Xung đột lớp có thể xảy ra trong Chú thích Java khiến mã Java của khách hàng bị lỗi |
MGMT-3185 | Lỗi khi thêm quản trị viên tổ chức vào tổ chức |
EDGEUI-127 | Không có đủ quyền với trình chỉnh sửa proxy mới |
EDGEUI-119 | Vấn đề hết thời gian chờ của phiên giao diện người dùng |
CORESERV-671 | Bạn thấy lỗi "Chưa định cấu hình vòng; Không thể khởi chạy dịch vụ cps" |
AXAPP-2345 | Vấn đề khi liệt kê báo cáo tuỳ chỉnh AX cho khách hàng không phải cps |
AXAPP-2302 | Báo cáo Tóm tắt về hoạt động phân tích ứng dụng Apigee hằng ngày cho thấy số lượng nhà phát triển sử dụng bằng 0 |
APIRT-2750 | Lỗi lưu lượng truy cập ở mức cao trong tổ chức cụ thể |
APIRT-2516 | Lỗi thời gian chạy trong chú thích JavaScript chỉ định số dòng không chính xác |
APIRT-2508 | Lỗi thoát khi gọi lệnh nghe nhanh trong lệnh gọi lại Vault |
APIRT-2336 | Vấn đề về Gzip với Node.js |
APIRT-1975 | Cấu hình mặt nạ không hoạt động với message.content |
Giao diện người dùng Cloud 16.03.16
ID vấn đề | Nội dung mô tả |
---|---|
MGMT-3142 | Biểu đồ không tải trên trang tổng quan Phân tích lỗi (bản sửa lỗi cập nhật) |
Giao diện người dùng Cloud 16.03.09
ID vấn đề | Nội dung mô tả |
---|---|
MGMT-3158 | Không đủ quyền trong giao diện người dùng khi RBAC trên các proxy riêng lẻ được đặt thông qua API |
MGMT-3142 | Biểu đồ không tải trên trang tổng quan Phân tích lỗi |
MGMT-3118 | Giao diện người dùng hiển thị cấu hình máy chủ ảo SSL không chính xác cho tham số "clientAuthEnabled" |
DEVRT-2344 | Định nghĩa báo cáo một ngày không tải giao dịch trong giao diện người dùng |
Đám mây 16.03.02
ID vấn đề | Nội dung mô tả |
---|---|
MGMT-3083 | Tự động làm mới nhật ký Node.js quá chi tiết với thông điệp nhật ký |
DEVRT-2275 | Gói giá dành cho Thuộc tính tuỳ chỉnh chỉ hiển thị 5 thuộc tính thay vì 10 thuộc tính được phép |
DEVRT-1275 | Không phải nhà phát triển nào cũng xuất hiện trong trình đơn thả xuống Gói giá |
DEVRT-1074 | Nhà phát triển trả trước có số dư bằng 0 sẽ gửi NullpointerException khi áp dụng khoản tín dụng |
Đám mây 16.02.17
ID vấn đề | Nội dung mô tả |
---|---|
MGMT-3083 | Tự động làm mới nhật ký Node.js quá chi tiết với thông điệp nhật ký |
MGMT-3077 | Giao diện người dùng tạo ra một gói proxy không hợp lệ từ một WSDL sử dụng không gian tên mặc định |
MGMT-1642 | Vai trò người dùng tuỳ chỉnh bị thiếu quyền "nhận" đối với Ứng dụng dành cho nhà phát triển |
Vấn đề đã biết
Bản phát hành này gặp một số vấn đề đã biết sau đây.
ID vấn đề | Nội dung mô tả |
---|---|
APIRT-2978 |
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 cạnh không khởi động được Nginx hoặc không khởi động được, như minh hoạ trong tệp /opt/apigee/var/log/edge-router/logs/system.log, sau đó 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 |
APIRT-3364 |
Bộ xử lý thư thực hiện tra cứu DNS trên IPv4 và IPv6 Nếu đã cài đặt và bật NSCD (Name Service Cache Daemon), bạn có thể nhận thấy rằng Bộ xử lý thông báo thực hiện hai lượt tra cứu DNS: một cho IPv4 và một cho IPv6. Để tắt tính năng tra cứu DNS trên IPv6:
|
PRC-1118 |
Lỗi khi chạy lệnh "apigee-service apigee-postgresql pg-data-purge" Nếu bạn chạy lệnh "apigee-service apigee-postgresql pg-data-purge" và thấy lỗi trong biểu mẫu: ERROR: phải là chủ sở hữu của mối quan hệ Chỉnh sửa /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge và đặt thuộc tính sau thành 'apigee': POSTGRES_USER=apigee |
DOC-1687 | Do có xung đột phần phụ thuộc gói đã biết, nên tác nhân Katello dùng trong Máy chủ vệ tinh 6 sẽ không cài đặt đúng cách trên các máy chủ Apigee Edge đang chạy trình nền Qpid. |
Tải trọng JSON trong các chính sách Chỉ định thông báo, Chú thích Java và Tăng lỗi
Các chính sách Chỉ định thông báo, Chú thích Java 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ể bao gồ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 tệp JSON không đúng định dạng. Để giải quyết vấn đề này, bạn có hai lựa chọn:
- Thoát khỏi 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ử Tải trọng, hãy sử dụng thuộc tính
variablePrefix
vàvariableSuffix
để biểu thị 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 Edge tiếp theo dành cho Bản phát hành tính năng đám mây riêng tư, bạn 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 Edge không khởi động được Nginx hoặc không khởi động được, như minh hoạ trong tệp /opt/apigee/var/log/edge-router/logs/system.log, sau đó 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