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 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:

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

  1. Trên mọi nút Bộ xử lý thư, hãy chỉnh sửa /etc/nscd.conf.
  2. Đặt thuộc tính sau:

    enable-cache host no
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 variablePrefixvariableSuffix để 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