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

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:

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 ích update.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ữa bootstrap_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.shupdate.sh có thể ghi tệp nhật ký vào /tmp – Theo mặc định, setup.sh và Tiện ích update.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:

  1. Trên mỗi nút Trình xử lý thông báo, hãy chỉnh sửa /etc/nscd.conf.
  2. Đặt thuộc tính sau:

    máy chủ lưu trữ bộ nhớ đệm không
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ính variableSuffix để 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