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 phiên bản Apigee Edge mới cho Private Cloud.
Kể từ Phiên bản Edge trước cho Tính năng đám mây riêng tư (4.16.01), các bản phát hành sau đã xảy ra và được đưa vào Bản phát hành tính năng này:
- Đám mây: 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
Xem bài viết Giới thiệu về bản phát hành đánh số để biết được làm thế nào để xác định xem một bản phát hành trên đám mây cụ thể có có trong phiên bản Edge dành cho Private Cloud của bạn.
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 sản phẩm sau các tính năng nâng cao, bản phát hành này cũng có nhiều tính hữu dụng, hiệu suất, tính bảo mật và độ ổn định các tính năng nâng cao.
Để biết thêm thông tin và hướng dẫn, hãy xem tài liệu của Edge dành cho đám mây riêng tư.
Cài đặt và Hướng dẫn hoạt động được chuyển sang trực tuyến
Giờ đây, bạn có thể truy cập Hướng dẫn vận hành và cài đặt trên đám mây riêng tư của Edge dành cho 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ác tính năng Java mới nhất,
tương thích với Java 1.8. Yêu cầu Oracle JDK 1.8 hoặc OpenJDK 8 trong
môi trường của bạn.
Là một phần của bản cập nhật cho Java 8, một số mật mã TLS không còn có sẵn trong Oracle JDK 1.8. Để biết danh sách đầy đủ, hãy xem phần "Bộ mật mã bị vô hiệu hoá 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 chế độ cài đặt, nâng cấp và các tập lệnh liên quan. Để biết thông tin khi sử dụng, hãy xem tài liệu Edge dành cho đám mây riêng tư.
- 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ế cho
Tiện ích
apigee-migrate
cùng với tiện íchupdate.sh
để cập nhật cài đặt từ 4.16.01 đến 4.16.05. Xem bài viết Cập nhật Apigee Edge 4.16.01 lên 4.16.05. -
Giày 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ải xuống nữabootstrap_4.16.05.sh
- Khôi phục – Để khôi phục một bản cập nhật lên 4.16.05, bạn hãy gỡ cài đặt
4.16.05 của thành phần và cài đặt lại phiên bản trước đó. Trước đó
Tiện ích
rollback.sh
đã bị xoá. Xem Quy trình khôi phục 4.16.05. setup.sh
vàupdate.sh
có thể ghi tệp nhật ký vào/tmp
– Theo mặc định,setup.sh
và Tiện íchupdate.sh
ghi thông tin nhật ký đến/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 đó, hệ thống 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 được.- Quy trình cập nhật API BaaS – Trong bản phát hành 4.16.01, bạn phải
Hãy 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 định cấu hình và quản trị Đám mây riêng tư.
- Xác thực lượt cài đặt
– Tiện ích
apigee-validate
dùng để kiểm thử Edge Private Cloud của bạn bây giờ có thể chạy cài đặt từ Máy chủ quản lý. Trước đây, tập lệnh cần được chạy Trình xử lý thư. Xem bài viết Kiểm tra cài đặt. - Tên khu vực – Khu vực có thể là bất kỳ tên nào. Trong những bản phát hành trước, tên này được ở dạng "dc-#", trong đó # là giá trị số nguyên.
- Nhóm cổng – Các 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 – A
tiện ích dòng lệnh
apigee-adminapi.sh
mới cho phép bạn thực hiện tương tự Các tác vụ định cấu hình cạnh 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. Xem Sử dụng tiện ích apigee-adminapi.sh. - Cấu hình im lặng SSL của máy chủ lưu trữ ảo – Khi tạo một tổ chức hoặc , bạn hiện có thể truyền các thuộc tính để định cấu hình SSL trên máy chủ lưu trữ ảo. Hãy xem bài viết Tham gia một tổ chức.
Dịch vụ API
Sau đây là các tính năng mới dành cho Dịch vụ API Edge, vốn được phân phối trên nền tảng đám mây trước đây các phiên bản của sản phẩm.
Tiền tố có độ dài cố định để 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ý tin nhắn có một phần tử <FormatMessage>
mới trong
cấu hình Nhật ký hệ thống. Theo
đang cài đặt <FormatMessage>true</FormatMessage>
, thông báo nhật ký hệ thống
bắt đầu bằng số lượng ký tự cố định, cho phép bạn lọc ra dữ liệu được chèn bằng Apigee. Để biết thêm
thông tin, hãy xem Thông báo
Chính sách ghi nhật ký. (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 proxy API
đường dẫn cơ sở. Ví dụ: đường dẫn cơ sở của /team/*/members
cho phép ứng dụng gọi
proxy của bạn với https://[host]/team/blue/members
hoặc
https://[host]/team/green/members
mà bạn không cần phải tạo proxy mới
để hỗ trợ các nhóm mới. Lưu ý /**/
không được phép. (MGMT-3154)
Tạo chuỗi proxy API (Cloud 16.03.02, giao diện người dùng 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 phát sinh thêm chi phí mạng. Trước đây, proxy API việc tạo chuỗi yêu cầu một lệnh gọi http(s) đến một proxy API khác, proxy này đã chuyển tiếp yêu cầu thông qua một trình cân bằng tải, bộ định tuyến và trình xử lý tin nhắn.
Các phần tử LocalTargetConnection
mới có sẵn trên proxy API
TargetEndpoint, 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 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
Điểm cuối đích.
Tính năng tạo chuỗi proxy cũng có trong chính sách về Chú thích dịch vụ.
Để biết thêm thông tin, hãy xem phần Tạo chuỗi proxy API
khi kết hợp cùng nhau. Các phần tử LocalTargetConnection
mới cũng được liệt kê trong tệp XML
giản đồ tại đây: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd.
(MGMT-3049, MGMT-3050)
Đã khắc phục 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 việc kiểm tra của người dùng để xem phiếu yêu cầu hỗ trợ của họ đã được khắc phục hay chưa. Công cụ này không được thiết kế để cung cấp cho tất cả người dùng.
Edge cho Private Cloud 4.16.05
ID vấn đề | Mô tả |
---|---|
PRC-770 | Trình cài đặt 16.01 không đăng ký được máy chủ dự phòng Postgres trong nhóm 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 | Thông tin cập nhật trên máy chủ Postgres có cấu hình chế độ chờ chính không thành công |
Cloud 16.03.30
ID vấn đề | Mô tả |
---|---|
SECENG-584 | Quá trình kiểm tra xác thực cho dòng mới giữa các chứng chỉ trong một chuỗi chứng chỉ gây ra sự cố với một số chứng chỉ trong phiên bản phát hành công khai |
MGMT-3217 | Các lệnh gọi API Quản lý sẽ không thực hiện được nếu tên KVMap kết thúc bằng "khoá" |
MGMT-3214 | Xung đột lớp có thể xảy ra trong JavaAnnotations khiến mã Java của khách hàng trở thành không thành công |
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 | thấy thông báo "Chưa thiết lập chuông báo; Không thể khởi chạy dịch vụ cps" các lỗi |
AXAPP-2345 | Vấn đề khi liệt kê báo cáo tuỳ chỉnh AX cho những khách hàng không sử dụng cp |
AXAPP-2302 | Thông tin tóm tắt hằng ngày về Apigee hiển thị số 0 trong mục nhà phát triển tình hình sử dụng |
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 dòng không chính xác số điện thoại |
APIRT-2508 | Lỗi thoát khi gọi nhanh chóng nghe 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 đối với message.content |
Giao diện người dùng Cloud 16.03.16
ID vấn đề | Mô tả |
---|---|
MGMT-3142 | Biểu đồ không tải trên trang tổng quan Error Analysis (Bản sửa lỗi đã cập nhật) |
Giao diện người dùng Cloud 16.03.09
ID vấn đề | 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 thiết lập 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 "clientAuthEnabled" tham số |
DEVRT-2344 | Định nghĩa trong báo cáo một ngày không tải giao dịch trong giao diện người dùng |
Cloud 16.03.02
ID vấn đề | Mô tả |
---|---|
MGMT-3083 | Tính năng 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á 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 thấy trong trình đơn thả xuống Gói giá |
DEVRT-1074 | Nhà phát triển trả trước không có số dư sẽ gửi NullpointerException khi có tín dụng được áp dụng |
Cloud 16.02.17
ID vấn đề | Mô tả |
---|---|
MGMT-3083 | Tính năng 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 gói proxy không hợp lệ từ WSDL sử dụng gói mặc định không gian tên |
MGMT-1642 | Vai trò của người dùng tuỳ chỉnh bị thiếu nút "get" quyền đối với Ứng dụng của nhà phát triển |
Vấn đề đã biết
Bản phát hành này gặp các vấn đề đã biết sau đây.
ID vấn đề | 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 Edge không khởi động được Nginx hoặc không khởi động được, như minh hoạ trong /opt/apigee/var/log/edge-router/logs/system.log sau đó xóa tất cả các tệp trong thư mục /opt/nginx/conf.d và 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 |
Trình xử lý thông báo thực hiện tra cứu DNS trên IPv4 và IPv6 Nếu đã cài đặt và bật NSCD (Trình nền dịch vụ bộ nhớ đệm của dịch vụ tên), bạn có thể lưu ý rằng Trình xử lý thông báo thực hiện hai lần tra cứu DNS: một cho IPv4 và một cho IPv6. Cách tắt tính năng tra cứu DNS trên IPv6:
|
PRC-1118 |
Lỗi khi chạy "apigee-service apigee-postgresql pg-data-purge" Command Nếu bạn chạy lệnh "apigee-service apigee-postgresql pg-data-purge" Command và thấy một 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 xung đột về phần phụ thuộc gói đã biết, tác nhân Katello được sử dụng trong Vệ tinh Máy chủ 6 sẽ không cài đặt đúng cách trên các máy chủ Apigee Edge chạy Qpid daemon. |
Tải trọng JSON trong Gán chính sách Message (Thông báo), Chú thích Java và Raise Fault (Nâng cao lỗi)
Chính sách Gán thông báo, Chú thích Java và Raise Fault cho phép bạn tạo thông báo
bằng phần tử <Set><Payload>
. Trong những thư đó, bạn
có thể bao gồm các biến có giá trị được tự động điền khi chạy. Ví dụ: nếu bạn muốn
xuất ngày từ tiêu đề HTTP, bạn có thể
hãy chèn {message.header.date}
vào tin nhắn của bạn.
Nếu thông báo định dạng 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 đó là JSON không đúng định dạng. Để giải quyết vấn đề này, bạn có hai tùy chọn:
- 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ử Tải trọng, hãy sử dụng
variablePrefix
và Các thuộc tínhvariableSuffix
để cho biết một biến trong tải trọng JSON. Cho 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 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 Không khởi động được bộ định tuyến
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 /opt/apigee/var/log/edge-router/logs/system.log sau đó xóa tất cả các tệp trong thư mục /opt/nginx/conf.d rồi khởi động lại thư mục bộ định tuyến:
> rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart