4.15.07.00 – Ghi chú phát hành Apigee Edge cho Private Cloud

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. info

Vào thứ Ba, ngày 8 tháng 9 năm 2015, chúng tôi đã phát hành một Bản phát hành tính năng chính của Apigee Edge cho Private Cloud.

Kể từ bản phát hành hằng quý trước của Edge cho đám mây riêng tư (4.15.04.00), các bản phát hành sau đây đã ra mắt và được đưa vào bản phát hành hằng quý này:

• Cloud: 15.04.15, 15.04.29, 15.05.27, 15.06.10 và 15.06.24
• Đám mây riêng tư: 4.15.04.01

Bạn có thể nâng cấp lên phiên bản Edge nào 4.15.07.00

Tuỳ thuộc vào phiên bản Edge hiện tại, bạn có thể:

• Nâng cấp trực tiếp lên phiên bản 4.15.07.00
• Nâng cấp dần dần, tức là bạn phải nâng cấp từ phiên bản hiện tại lên một phiên bản Edge khác, sau đó nâng cấp lên phiên bản 4.15.07.00.

Để biết thêm thông tin, hãy xem bài viết Những phiên bản Edge cho đám mây riêng tư nào có thể nâng cấp lên 4.15.07.00.

Trước khi nâng cấp từ phiên bản 4.15.01.x hoặc từ phiên bản cũ hơn

1. Kiểm tra phiên bản Cassandra SSTable:
   1. Thay đổi thư mục thành /<install-root>/apigee4/data/cassandra/data.
   2. Chạy lệnh tìm,
      > find . -name *-ic-*
      Kết quả sẽ trả về một tập hợp các tệp .db nếu bạn đang chạy Cassandra 1.2 SSTable.
   3. Chạy lệnh tìm này:
      > find . -name *-hf-*
      Kết quả sẽ trống, nghĩa là không có tệp .db nào ở định dạng hf. Nếu không thấy tệp nào ở định dạng hf, thì tức là bạn đã hoàn tất và có thể nâng cấp lên phiên bản 4.15.07.00.
      
      Định dạng hf dành cho Cassandra 1.0 SSTables. Nếu có bất kỳ tệp *.db nào ở định dạng hf, thì bạn phải nâng cấp SSTable như mô tả trong phần còn lại của quy trình này.
2. Nếu bạn tìm thấy tệp *.db ở định dạng hf, hãy nâng cấp SSTable bằng cách chạy lệnh sau trên mọi nút Cassandra cho đến khi bạn nâng cấp tất cả các nút Cassandra:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. Lặp lại Bước 1 để kiểm tra xem tất cả tệp *.db có ở định dạng ic cho phiên bản Cassandra 1.2 hay không.
4. Lặp lại các bước từ 1 đến 3 trên mọi nút Cassandra trong bản cài đặt Edge của bạn.
5. Nâng cấp lên Edge 4.15.07.00.
6. Sau khi nâng cấp 4.15.07.00, hãy kiểm tra các tệp *.db để đảm bảo tất cả đều đã được nâng cấp lên sstable kiểu C* 2.0:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   Lệnh này sẽ trả về một tập hợp các tệp .db nếu bạn đang chạy Cassandra 2.0.

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.

Cài đặt và nâng cấp

Nâng cấp và gỡ cài đặt thành phần có chọn lọc

Giờ đây, tập lệnh apigee-upgrade.sh và apigee-uninstall.sh cho phép bạn chọn các thành phần Edge để nâng cấp hoặc gỡ cài đặt. Trước đây, lệnh này nâng cấp hoặc gỡ cài đặt tất cả thành phần trên nút. (OPDK-1377, OPDK-1175)

Huỷ nâng cấp

Nếu apigee-upgrade.sh không thành công trong quá trình nâng cấp, thì giờ đây, bạn có thể sử dụng tập lệnh apigee-rollback.sh để khôi phục bản nâng cấp. Sau khi khắc phục mọi vấn đề về việc nâng cấp, bạn có thể thử nâng cấp lại. (OPDK-1275)

Các lựa chọn tập lệnh cài đặt rút gọn

Các tập lệnh cài đặt không còn sử dụng dạng dài của các tuỳ chọn, chẳng hạn như --help. Giờ đây, các lệnh này chỉ chấp nhận các tuỳ chọn một chữ cái, chẳng hạn như -h. (OPDK-1356)

Cài đặt SmartDocs

Khi cài đặt SmartDocs bằng tập lệnh setup-smartdocs.sh, bạn sẽ được nhắc nhập tổ chức, môi trường và máy chủ ảo để đảm bảo rằng SmartDocs được cài đặt ở vị trí dự kiến. Trước đây, các giá trị đó được cố định giá trị trong mã của tập lệnh. (OPDK-1310)

Đang chạy update-cass-pwd-in-config.sh mà không có lời nhắc

Bạn có thể chạy tập lệnh update-cass-pwd-in-config.sh mà không cần lời nhắc nếu đặt các biến môi trường ENABLE_CASS_AUTH, CASS_USERNAME và CASS_PASSWORD. (OPDK-1309)

Nền tảng biên

Sau đây là các tính năng mới của nền tảng Edge có trong bản phát hành này.

OpenJDK 1.7 được Edge Private Cloud hỗ trợ

Bản phát hành Edge này hỗ trợ Oracle JDK 1.7 và OpenJDK 7, đồng thời ngừng hỗ trợ JDK 1.6. (OPDK-1187)

Hỗ trợ hệ điều hành

Apigee Edge cho đám mây riêng tư đã mở rộng khả năng hỗ trợ hệ điều hành để bao gồm Red Hat Enterprise Linux 6.6 và 7.0 (64 bit), CentOS 6.5, 6.6 và 7.0 (64 bit) và Oracle Linux 6.5.

Cassandra 2.0.15 có trong OPDK 15.07

Bản phát hành này cài đặt Cassandra 2.0.15. Nếu bạn đang nâng cấp cho một bản phát hành trước đó, thì phiên bản Cassandra của bạn sẽ được cập nhật. (OPDK-1197)

Hỗ trợ SHA2 cho việc băm mã thông báo OAuth

Để bảo vệ mã thông báo OAuth hiệu quả hơn trong trường hợp xảy ra lỗi bảo mật cơ sở dữ liệu, Edge hỗ trợ thuật toán SHA2 để băm mã thông báo OAuth (ngoài SHA1). Với các thuộc tính mới ở cấp tổ chức, bạn có thể bật và định cấu hình tính năng băm cho mã thông báo mới, cũng như giữ lại tính năng băm cũ trên mọi mã thông báo đã tồn tại trước khi có tính năng mới này. Trước đây, trong Edge cho đám mây riêng tư, một thuộc tính có tên là hash.oauth.tokens.enabled trong tệp keymanagement.properties (trên máy chủ quản lý và bộ xử lý thông báo) đã bật tính năng tự động băm SHA1 của mã thông báo OAuth. Thuộc tính này hiện không được dùng nữa.

Nếu trước đây bạn đã sử dụng thuộc tính hash.oauth.tokens.enabled để bật tính năng băm SHA1, thì tập lệnh nâng cấp cho bản phát hành này sẽ tự động tạo các thuộc tính mới ở cấp tổ chức cho bạn. Để xác minh sau khi nâng cấp, hãy thực hiện yêu cầu GET với tư cách là quản trị viên hệ thống bằng API này: https://{host}:{port}/v1/o/{your_org}.

• Để biết thông tin về cách bật tính năng băm mã thông báo trong tổ chức của bạn bằng các thuộc tính mới, hãy xem phần "Băm mã thông báo trong cơ sở dữ liệu" trong chủ đề Yêu cầu mã truy cập.
• Để biết thông tin về cách băm hàng loạt mã thông báo hiện có, hãy xem Hướng dẫn thao tác trên Edge cho đám mây riêng tư. (APIRT-1389)

Cấu trúc thư mục phẳng cho tệp nhật ký

Bạn có thể định cấu hình Edge để lưu trữ tệp nhật ký trong cấu trúc thư mục phẳng bằng cách đặt thuộc tính enable.flat.directory.structure mới thành true trong tệp message-logging.properties. Để biết thêm thông tin, hãy xem Chính sách ghi nhật ký thông báo. (APIRT-1394)

Hiệu suất của bộ nhớ đệm môi trường

Để quản lý và sử dụng bộ nhớ đệm trong bộ nhớ hiệu quả hơn, chế độ cài đặt "Số phần tử tối đa trong bộ nhớ" trên tài nguyên bộ nhớ đệm của môi trường đã ngừng hoạt động. Tổng số phần tử có trong tất cả tài nguyên bộ nhớ đệm (bao gồm cả bộ nhớ đệm mặc định) phụ thuộc vào tổng bộ nhớ được phân bổ cho bộ nhớ đệm. Theo mặc định, tổng bộ nhớ được phân bổ cho việc lưu vào bộ nhớ đệm trong bộ nhớ trên một trình xử lý thông báo nhất định là 40% tổng bộ nhớ hiện có, được xác định bằng chế độ cài đặt thuộc tính bộ nhớ đệm trong tệp cache.properties của trình xử lý thông báo. Các phần tử sẽ chỉ bị loại bỏ khỏi bộ nhớ đệm của bộ nhớ khi không có đủ bộ nhớ đệm hoặc các phần tử hết hạn.

Để quay lại hành vi cũ là sử dụng thuộc tính "Maximum Elements in Memory" (Số phần tử tối đa trong bộ nhớ) để quản lý bộ nhớ đệm, hãy đặt thuộc tính overrideMaxElementsInCacheResource=false trong tệp cache.properties. (APIRT-1140)

Dịch vụ API

Sau đây là các tính năng mới của Dịch vụ API có trong bản phát hành này.

Trình chỉnh sửa proxy mới làm mặc định

Trình chỉnh sửa proxy API mới được bật theo mặc định trong giao diện người dùng quản lý. Trình chỉnh sửa mới có nhiều điểm cải tiến về khả năng hữu dụng, bao gồm cả chế độ xem toàn diện hơn về các luồng có điều kiện và điểm cuối trên trang Tổng quan, tất cả cấu hình trên trang Phát triển, cách thêm luồng có điều kiện, điểm cuối và chính sách trực quan hơn, chế độ xem XML hoàn chỉnh hơn thay vì các đoạn mã nhỏ, tính năng tìm kiếm thu thập thông tin tên tệp và văn bản, v.v. (MGMT-2279)

Chính sách mới về việc xoá thông tin OAuth phiên bản 2.0

Chính sách "Xoá thông tin OAuth phiên bản 2.0" mới cho phép bạn xoá mã truy cập và mã uỷ quyền OAuth phiên bản 2. Chính sách này thay thế chức năng mà API quản lý cung cấp trước đây. Để biết thêm thông tin, hãy xem phần Xoá chính sách thông tin OAuthV2. (MGMT-2257)

Chính sách mới về việc xoá thông tin OAuth phiên bản 1.0

Chính sách "Xoá thông tin OAuth phiên bản 1.0" mới cho phép bạn xoá mã thông báo yêu cầu, mã truy cập và mã xác minh OAuth phiên bản 1.0. Chính sách này thay thế chức năng mà API quản lý cung cấp trước đây. Để biết thêm thông tin, hãy xem Chính sách xoá thông tin OAuth phiên bản 1. (APIRT-1351)

Chính sách Kiểm soát quyền truy cập

Chính sách Kiểm soát quyền truy cập đã được cải tiến để cho phép đánh giá chi tiết hơn về địa chỉ IP để đưa vào danh sách cho phép và danh sách từ chối khi địa chỉ IP có trong tiêu đề HTTP X-FORWARDED-FOR.

Khi bạn bật tính năng kiểm tra nhiều địa chỉ IP trên tiêu đề (hãy liên hệ với Nhóm hỗ trợ để đặt feature.enableMultipleXForwardCheckForACL), một phần tử <ValidateBasedOn> mới trong chính sách sẽ cho phép bạn kiểm tra địa chỉ IP đầu tiên, địa chỉ IP cuối cùng hoặc tất cả địa chỉ IP trong tiêu đề. Để biết thêm thông tin, hãy xem Chính sách kiểm soát quyền truy cập.

Các thực thể mới trong chính sách về Thực thể truy cập

Chính sách Access Entity (Truy cập thực thể) cung cấp quyền truy cập vào các thực thể mới sau: consumerkey-scopes, authorizationcode, requesttoken và verifier. Để biết thêm thông tin, hãy xem Chính sách về thực thể truy cập.

Chính sách của Trình thu thập số liệu thống kê: tự động chuyển đổi tên số liệu thống kê thành chữ thường

Khi tạo một tập hợp số liệu phân tích tuỳ chỉnh trong trình chỉnh sửa proxy API (Trang phát triển > Công cụ > Tập hợp số liệu phân tích tuỳ chỉnh), "Tên" của biến thu thập (thống kê) phải là chữ thường. Nếu bạn nhập tên bằng chữ hoa, công cụ sẽ tự động chuyển đổi tên Thống kê thành chữ thường trong chính sách Trình thu thập số liệu thống kê. (MGMT-740)

Xoá tính năng Theo dõi cũ trong trình chỉnh sửa proxy API

Phiên bản mới nhất của chức năng Theo dõi trong trình chỉnh sửa proxy API đã chuyển từ giai đoạn thử nghiệm sang giai đoạn phát hành rộng rãi. Bạn không thể truy cập vào "dấu vết cũ" bằng đường liên kết "Truy cập vào phiên bản dấu vết cũ" nữa.

Truy cập vào Cộng đồng Apigee từ trình đơn Trợ giúp của giao diện người dùng quản lý

Bạn có thể truy cập vào Cộng đồng Apigee từ trình đơn Trợ giúp của giao diện người dùng quản lý.

Thông báo lỗi trong giao diện người dùng quản lý

Sau đây là các điểm cải tiến về thông báo lỗi trong giao diện người dùng quản lý:

• Giao diện người dùng quản lý dùng để nhóm và hiển thị tất cả thông báo lỗi trên giao diện người dùng cho toàn bộ phiên đăng nhập, trừ phi bạn đóng các thông báo đó. Với bản cập nhật này, thông báo lỗi sẽ tự động bị xoá khi bạn rời khỏi trang xảy ra lỗi. (MGMT-2254)
• Giao diện người dùng quản lý không còn chặn các thông báo lỗi trùng lặp. (MGMT-2242)

Cải thiện hiệu suất và lỗi giao diện người dùng

Chúng tôi đã thực hiện các điểm cải tiến chung cho nhiều khía cạnh của giao diện người dùng quản lý, bao gồm cả hiệu suất hiển thị trang và dọn dẹp thông báo lỗi.

Đường liên kết đến vai trò trên trang Người dùng của tổ chức trong giao diện người dùng quản lý

Trên trang Người dùng của tổ chức trong giao diện người dùng quản lý (Quản trị > Người dùng của tổ chức), tên vai trò hiện được liên kết, giúp bạn nhanh chóng chuyển đến các trang vai trò. (MGMT-1055)

Biến mục tiêu mới trong luồng thông báo

Các biến mới trong luồng thông báo cung cấp thông tin URL đầy đủ hơn cho các điểm cuối mục tiêu và máy chủ mục tiêu:

• TargetEndpoint: request.url thay thế target.basepath.with.query.
• TargetServer: loadbalancing.targetserver thay thế targetserver.name. Ngoài ra, target.basepath chỉ được điền sẵn khi phần tử <Path> được dùng trong phần tử <LoadBalancer> HTTPTargetConnection của TargetEndpoint.

Hỗ trợ Chỉ báo tên máy chủ (SNI)

Edge hỗ trợ việc sử dụng Chỉ báo tên máy chủ theo hướng nam (từ trình xử lý thông báo đến điểm cuối mục tiêu). Nếu bạn muốn sử dụng SNI, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.

Cần có Java 1.7.

Với SNI (một tiện ích của TLS/SSL), nhiều mục tiêu HTTPS có thể được phân phát từ cùng một địa chỉ IP và cổng mà không yêu cầu tất cả các mục tiêu đó phải sử dụng cùng một chứng chỉ.

Bạn không cần phải định cấu hình riêng cho Edge. Nếu môi trường của bạn được định cấu hình cho SNI hướng nam (Edge Cloud là mặc định), thì Edge sẽ hỗ trợ SNI này.

Edge tự động trích xuất tên máy chủ từ URL yêu cầu và thêm tên đó vào yêu cầu bắt tay SSL. Ví dụ: nếu máy chủ lưu trữ mục tiêu là https://example.com/request/path, thì Edge sẽ thêm tiện ích server_name như minh hoạ dưới đây:

Để biết thêm thông tin về SNI, hãy xem bài viết http://en.wikipedia.org/wiki/Server_Name_Indication.

"Thuật toán chữ ký" trong thông tin chi tiết về Chứng chỉ SSL

Trường "Thuật toán chữ ký" mới đã được thêm vào thông tin chi tiết về chứng chỉ SSL, có thể xem được trong giao diện người dùng quản lý (Quản trị > Chứng chỉ SSL) và API quản lý (Lấy thông tin chi tiết về chứng chỉ từ Kho khoá hoặc Kho tin cậy). Trường này cho thấy "sha1WithRSAEncryption" hoặc "sha256WithRSAEncryption", tuỳ thuộc vào loại thuật toán băm dùng để tạo chứng chỉ.

Đang hiển thị các chứng chỉ SSL sắp hết hạn

Trang Chứng chỉ SSL trong giao diện người dùng quản lý (Quản trị viên > Chứng chỉ SSL) cho biết thời điểm chứng chỉ SSL sẽ hết hạn trong vòng 10, 15, 30 hoặc 90 ngày, tuỳ thuộc vào lựa chọn của bạn trong trường thả xuống mới về ngày hết hạn.

Lỗi cấu hình tính năng bảo vệ khỏi mối đe doạ

Theo mặc định, Edge sẽ gửi mã trạng thái Lỗi phía máy chủ nội bộ HTTP 500 và lỗi ExecutionFailed nếu một thông báo không vượt qua được chính sách Bảo vệ khỏi mối đe doạ JSON hoặc XML. Bạn có thể thay đổi hành vi lỗi đó bằng một thuộc tính mới ở cấp tổ chức. Khi đặt thuộc tính tổ chức features.isPolicyHttpStatusEnabled thành true, hành vi sau đây sẽ xảy ra:

• Yêu cầu: Khi chính sách bảo vệ khỏi mối đe doạ được đính kèm vào bất kỳ luồng yêu cầu nào, các thông báo không hợp lệ sẽ trả về mã trạng thái 400, cùng với thông báo lỗi chính sách tương ứng.
• Phản hồi: Khi chính sách bảo vệ khỏi mối đe doạ được đính kèm vào bất kỳ luồng phản hồi nào, các thông báo không hợp lệ vẫn trả về mã trạng thái 500 và một trong các thông báo lỗi chính sách tương ứng sẽ được gửi (thay vì chỉ ExecutionFailed).

Khách hàng sử dụng dịch vụ đám mây phải liên hệ với Nhóm hỗ trợ Apigee Edge để đặt thuộc tính tổ chức. Tính năng này sẽ được cung cấp cho khách hàng sử dụng Edge Private Cloud trong bản phát hành hằng quý tiếp theo của Private Cloud.

Đã cập nhật giản đồ cho điểm cuối, proxy và các thực thể khác

Giản đồ tham chiếu đã được cập nhật cho các thực thể không phải chính sách, chẳng hạn như TargetEndpoint, ProxyEndpoint, APIProxy và nhiều thực thể khác. Xem https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)

Các dịch vụ dành cho nhà phát triển

Sau đây là các tính năng mới của Dịch vụ dành cho nhà phát triển trong bản phát hành này.

Phát hành rộng rãi SmartDocs

SmartDocs sẽ chuyển từ giai đoạn thử nghiệm sang giai đoạn phát hành rộng rãi. Các bản cập nhật và tính năng mới bao gồm:

• Hỗ trợ Swagger 2.0, bao gồm cả việc nhập theo tệp hoặc URL, bao gồm cả việc hỗ trợ các đối tượng bảo mật có tên tuỳ chỉnh.
• Cải tiến thiết kế hình ảnh trong các mẫu tạo SmartDocs.
• Các điểm cải tiến về khả năng hữu dụng và quy trình làm việc trong Cổng thông tin cho nhà phát triển, có trong trình đơn Nội dung > SmartDocs trong Drupal.
• Phương thức xác thực "Mã thông báo tuỳ chỉnh" hiện được gọi là "Khoá API".
• Các đối tượng "bảo mật" xác thực được xác định ở cấp bản sửa đổi.
• Cấu hình xác thực ứng dụng ở cấp mẫu. Các bản sửa đổi mới không còn đặt lại thông tin xác thực ứng dụng SmartDocs đã định cấu hình trước.

Để biết thêm nội dung mô tả tính năng, hãy xem bài đăng trên blog này.

Để xem tài liệu về SmartDocs, hãy xem bài viết Sử dụng SmartDocs để ghi lại tài liệu về API.

Tên ứng dụng của nhà phát triển xuất hiện trong giao diện người dùng quản lý

Ứng dụng của nhà phát triển trong Edge có cả Tên nội bộ không thay đổi và Tên hiển thị mà bạn có thể thay đổi. Trên trang Ứng dụng của nhà phát triển trong giao diện người dùng quản lý (Xuất bản > Ứng dụng của nhà phát triển > tên ứng dụng), "Tên" nội bộ của ứng dụng sẽ xuất hiện cùng với "Tên hiển thị", giúp bạn dễ dàng xác định ứng dụng bằng tên nội bộ để khắc phục sự cố và quản lý API.

Dịch vụ phân tích

Sau đây là các tính năng mới của Dịch vụ Analytics có trong bản phát hành này.

Giới hạn thời gian lưu giữ dữ liệu

Khi tạo báo cáo phân tích bằng giao diện người dùng hoặc API quản lý, theo mặc định, bạn không thể truy cập vào dữ liệu cũ hơn 6 tháng tính từ ngày hiện tại. Nếu bạn muốn truy cập vào dữ liệu cũ hơn 6 tháng, hãy liên hệ với Bộ phận hỗ trợ của Apigee Edge.

Phiên bản cũ của báo cáo tùy chỉnh sẽ bị xóa khỏi giao diện người dùng quản lý

Phiên bản cũ không bắt buộc của báo cáo phân tích tuỳ chỉnh không còn hoạt động trong giao diện người dùng quản lý.

Hiệu suất của tiện ích Mức độ tương tác của nhà phát triển

Tiện ích phễu trên trang tổng quan số liệu phân tích chính (phần Mức độ tương tác của nhà phát triển) đã được cải thiện để mang lại hiệu suất cao hơn.

Kiếm tiền

Sau đây là các tính năng kiếm tiền mới có trong bản phát hành này.

Thông báo qua email về gói giá

Loại thông báo mới qua email về Gói giá cho phép bạn thông báo cho nhà phát triển khi họ đạt đến một giới hạn giao dịch hoặc giới hạn tiền nhất định trong gói giá theo gói hoặc theo dải khối lượng mà họ đã mua. Để biết thông tin chi tiết, hãy xem phần Thiết lập thông báo bằng mẫu thông báo.

Đồng bộ hoá Phí định kỳ và Kỳ tổng hợp

Trong một gói giá, có thể có hai khoảng thời gian khác nhau có hiệu lực:

• Khoảng thời gian tính phí định kỳ, được định cấu hình trên thẻ Phí của một gói giá, xác định thời điểm nhà phát triển bị tính phí định kỳ.
• Kỳ cơ sở tổng hợp, được xác định trên bảng giá cho các gói theo Gói hoặc theo Băng tần, xác định thời điểm đặt lại mức sử dụng gói cho nhà phát triển.

Hai khoảng thời gian đó hiện đã được đồng bộ hoá. Khi cả phí định kỳ khác 0 và bảng giá theo Gói hoặc theo Băng tần đều tồn tại trong một gói giá, thì kỳ phí định kỳ sẽ được dùng cho cả hai. Ví dụ: nếu có phí định kỳ hằng tháng, thì các gói trong bảng giá cũng được đặt lại hằng tháng (theo mặc định là vào đầu tháng).

Nếu không có phí định kỳ, các gói sẽ được đặt lại dựa trên Cơ sở tổng hợp được xác định trên bảng giá. Ví dụ: nếu nhà phát triển bắt đầu sử dụng bảng giá vào ngày 19 của tháng và Cơ sở tổng hợp là hằng tháng, thì mức sử dụng gói sẽ được đặt lại sau ngày 19 một tháng.

Cơ sở tổng hợp không còn được dùng nữa và sẽ bị xoá khỏi tính năng kiếm tiền trong một bản phát hành sau này. Để biết thêm thông tin, hãy xem phần Chỉ định thông tin chi tiết về gói bảng giá.

Thuộc tính tuỳ chỉnh trong báo cáo tóm tắt doanh thu

Chính sách ghi lại giao dịch cho phép bạn tuỳ ý thu thập dữ liệu thuộc tính tuỳ chỉnh từ các giao dịch. Giờ đây, bạn có thể đưa các thuộc tính giao dịch tuỳ chỉnh đó vào báo cáo tóm tắt doanh thu. Bằng cách thêm thuộc tính MINT.SUMMARY_CUSTOM_ATTRIBUTES vào tổ chức của mình, bạn có thể cho biết những thuộc tính tuỳ chỉnh nào được thêm vào bảng cơ sở dữ liệu để sử dụng trong báo cáo.

Khách hàng của Apigee Edge cho đám mây riêng tư có thể đặt cờ bằng lệnh gọi API sau đây và Thông tin đăng nhập của quản trị viên hệ thống.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

Xin lưu ý rằng mảng thuộc tính tùy chỉnh trong lệnh gọi API được mã hóa URL.

Quy trình nâng cấp SmartDocs

Nếu bạn đã sử dụng SmartDocs trong giai đoạn thử nghiệm, thì các tính năng và chức năng mới trong phiên bản phát hành rộng rãi sẽ yêu cầu bạn nâng cấp SmartDocs trong cổng thông tin cho nhà phát triển.

Mọi trang SmartDocs đã được xuất bản trong cổng thông tin cho nhà phát triển sẽ tiếp tục hoạt động, nhưng bạn phải làm theo quy trình cập nhật trước khi chỉnh sửa hoặc xuất bản bất kỳ thay đổi nào đối với các trang hiện có hoặc trang mới.

Xin lưu ý rằng mặc dù bạn có thể kết xuất và xuất bản SmartDocs trong cổng thông tin cho nhà phát triển, nhưng SmartDocs được tạo từ mô hình API nằm trong Dịch vụ quản lý API Edge của Apigee. Mọi thay đổi bạn thực hiện đối với mô hình API trong Edge sẽ giống nhau trên tất cả các môi trường Pantheon (tương tự như cách nhà phát triển tồn tại trên các môi trường Pantheon).

Cách nâng cấp từ SmartDocs phiên bản thử nghiệm lên giai đoạn phát hành rộng rãi

1. Cập nhật và thử nghiệm bản phát hành 15.05.27 trong môi trường phát triển hoặc thử nghiệm trên Pantheon.
2. Tạo một mô hình mới để thay thế mọi mô hình API hiện có mà bạn đang sử dụng.
   • Nếu bạn đã nhập tài liệu Swagger hoặc WADL, hãy nhập lại các tài liệu đó vào một bản sửa đổi mới.
   • Nếu bạn đang duy trì mô hình API thông qua mô-đun SmartDocs, hãy xuất dưới dạng SmartDocs JSON và nhập vào mô hình mới bằng tệp đính kèm.
3. Đặt các thuộc tính bảo mật của bản sửa đổi mô hình. Trên trang Content > SmartDocs > model (Nội dung > SmartDocs > mô hình), hãy chọn Security Settings (Cài đặt bảo mật).
   
4. Kiểm tra mọi phương thức xác thực được định cấu hình sẵn trong trang cài đặt mô hình (Nội dung > SmartDocs) bằng cách nhấp vào Cài đặt trong cột Thao tác.
   
5. Cập nhật mọi mẫu tuỳ chỉnh để sử dụng phiên bản 6 của thành phần CSS và JS, đồng thời thực hiện các thay đổi để phản ánh mọi tên đối tượng mới, chẳng hạn như authSchemes và apiSchema. Để biết thông tin về cách cập nhật mẫu SmartDocs, hãy xem bài viết Sử dụng SmartDocs để ghi lại API.
6. Hiển thị lại và xuất bản bản sửa đổi mô hình.
7. Sau khi xác thực tài liệu mới, hãy cập nhật cổng thông tin production lên bản phát hành 15.05.27.

Nếu bạn là khách hàng doanh nghiệp của Edge và có thắc mắc hoặc lo ngại về quy trình nâng cấp, vui lòng gửi email đến marsh@apigee.com và cnovak@apigee.com. Nếu không, vui lòng sử dụng Cộng đồng Apigee để nhận được câu trả lời phù hợp nhất.

Các thay đổi và điểm cải tiến đối với tính năng trong tương lai

Phần này giới thiệu trước những thay đổi và điểm cải tiến dự kiến cho các tính năng trong tương lai:

Thay đổi đối với hành vi của chính sách Bộ nhớ đệm phản hồi

Trong một bản phát hành trong tương lai (chưa xác định), hành vi mặc định của phần tử <ExcludeErrorResponse> trong chính sách Bộ nhớ đệm phản hồi sẽ thay đổi.

Hành vi hiện tại: Phần tử <ExcludeErrorResponse> trong chính sách bộ nhớ đệm phản hồi có giá trị mặc định là false. Điều này có nghĩa là theo mặc định, các phản hồi có bất kỳ mã trạng thái HTTP nào (bao gồm cả 3xx) đều được lưu vào bộ nhớ đệm theo chính sách Bộ nhớ đệm phản hồi.

Hành vi trong tương lai: Phần tử <ExcludeErrorResponse> trong chính sách Bộ nhớ đệm phản hồi sẽ mặc định là true. Điều này có nghĩa là theo mặc định, chỉ những phản hồi có mã trạng thái HTTP từ 200 đến 205 mới được lưu vào bộ nhớ đệm. Để ghi đè hành vi này và lưu phản hồi vào bộ nhớ đệm cho tất cả mã trạng thái, bạn cần đặt phần tử <ExcludeErrorResponse> thành true một cách rõ ràng.

Cách giải quyết hiện tại: Đối với Private Cloud 4.15.07.00 và các bản phát hành cũ hơn, nếu muốn lưu phản hồi vào bộ nhớ đệm chỉ bằng Mã trạng thái từ 200 đến 205, bạn phải đặt rõ ràng phần tử <ExcludeErrorResponse> thành true.

Đã sửa lỗi

Các lỗi sau đây đã được khắc phục trong bản phát hành này.

Vấn đề đã biết

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

> source /{install-dir}/apigee4/bin/apigee-env.sh

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh

> rm /install-dir/apigee4/share/monetization

**************************************
In order to complete the monetization upgrade please run:
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh
**************************************

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart