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. thông tin

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 Edge for Private Cloud hằng quý trước (4.15.04.00), các bản phát hành sau đây đã diễn ra 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
• Private Cloud: 4.15.04.01

Bạn có thể nâng cấp lên phiên bản Edge nào lên phiên bản 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 tăng dần, nghĩa 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 khác của Edge, 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 Bạn có thể nâng cấp lên phiên bản Edge for Private Cloud nào lên phiên bản 4.15.07.00.

Trước khi nâng cấp từ phiên bản 4.15.01.x hoặc từ một phiên bản trước

1. Kiểm tra phiên bản SSTable Cassandra:
   1. Thay đổi thư mục thành /<install-root>/apigee4/data/cassandra/data.
   2. Chạy lệnh tìm kiế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ì 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 SSTables Cassandra 1.0. Nếu có tệp *.db ở đị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 nào có đị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ả 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 đều ở đị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 quá trình cài đặt Edge.
5. Nâng cấp lên Edge 4.15.07.00.
6. Sau khi nâng cấp lên phiên bản 4.15.07.00, hãy kiểm tra các tệp *.db để đảm bảo rằng tất cả các tệp đó đề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.

Các tính năng và điểm cải tiến mới

Sau đây là các tính năng mới và điểm cải tiến 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, các 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, công cụ 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)

Khôi phục bản nâng cấp

Nếu apigee-upgrade.sh không thành công trong quá trình nâng cấp, giờ đây, bạn có thể sử dụng tập lệnh apigee-rollback.sh để khôi phục quá trình 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 tuỳ chọn tập lệnh trì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, chúng chỉ nhận các tuỳ chọn chữ cái đơn, 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 SmartDocs được cài đặt ở vị trí dự kiến. Trước đây, các giá trị đó được mã hoá cứng trong tập lệnh. (OPDK-1310)

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

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

Nền tảng Edge

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 xoá tính năng hỗ trợ cho JDK 1.6. (OPDK-1187)

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

Apigee Edge cho đám mây riêng tư đã mở rộng phạm vi 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 đó, phiên bản Cassandra của bạn sẽ được cập nhật. (OPDK-1197)

Hỗ trợ SHA2 để băm mã thông báo OAuth

Để bảo vệ mã thông báo OAuth tốt hơn trong trường hợp xảy ra sự cố bảo mật cơ sở dữ liệu, Edge hỗ trợ các thuật toán SHA2 để băm mã thông báo OAuth (ngoài SHA1). Với các tài sản 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 tính năng mới này. Trước đây, trong Edge cho đám mây riêng, một thuộc tính có tên hash.oauth.tokens.enabled trong tệp keymanagement.properties (trên máy chủ quản lý và trình xử lý thông báo) đã bật tính năng băm SHA1 tự động của mã thông báo OAuth. Thuộc tính này 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 cấp tổ chức mới cho bạn. Để xác minh sau khi nâng cấp, hãy thực hiện một lệnh 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ã thông báo 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 về hoạt động của Edge cho đám mây riêng. (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ữ các 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 về việc ghi nhật ký thông báo. (APIRT-1394)

Hiệu suất 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 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 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ớ có sẵn, được xác định theo 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 trong 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, tính năng thêm trực quan hơn các luồng có điều kiện, điểm cuối và chính sách, 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 v2.0

Chính sách mới "Xoá thông tin OAuth v2.0" cho phép bạn xoá mã truy cập và mã uỷ quyền OAuth v2. 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 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 mới "Xoá thông tin OAuth v1.0" 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 v1.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 về việc xoá thông tin OAuth V1. (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 nâng cao để cho phép đánh giá chi tiết hơn về địa chỉ IP cho 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ật tính năng kiểm tra nhiều địa chỉ IP trên tiêu đề (liên hệ với Nhóm hỗ trợ để đặt tính năng.enableMultipleXForwardCheckForACL), phần tử <ValidateBasedOn> mới trong chính sách sẽ cho phép bạn kiểm tra theo đị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 về thực thể truy cập cấp quyền truy cập vào các thực thể mới sau: consumerkey-scopes, mã uỷ quyền, mã yêu cầu và trình xác thực. Để 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: 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), biến bộ thu thập (thống kê) "Tên" phải viết thường. Nếu bạn nhập tên bằng chữ in hoa, công cụ này sẽ tự động chuyển đổi tên Thống kê thành chữ thường trong chính sách của Trình thu thập số liệu thống kê. (MGMT-740)

Xoá tính năng Theo dõi cổ điển 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ừ phiên bản beta sang phiên bản phát hành công khai. Bạn không thể truy cập vào "dấu vết kiểu cũ" bằng đường liên kết "Truy cập vào phiên bản dấu vết kiểu cũ" nữa.

Quyền truy cập vào Cộng đồng Apigee từ trình đơn Trợ giúp trên 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 trên 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 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 đã cải tiến chung cho nhiều khu vực 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à việc dọn dẹp thông báo lỗi.

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

Trên trang Người dùng trong tổ chức trong giao diện người dùng quản lý (Quản trị > Người dùng trong tổ chức), tên vai trò hiện có siêu liên kết, cho phé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 tin nhắn

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 khi phần tử <Path> được sử 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 các đ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.

Yêu cầu Java 1.7.

Với SNI (phần mở rộng 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 thiết lập cấu hình dành riêng cho Edge. Nếu môi trường của bạn được định cấu hình cho SNI phía nam (theo mặc định là đám mây Edge), thì Edge sẽ hỗ trợ SNI đó.

Edge tự động trích xuất tên máy chủ từ URL yêu cầu và thêm tên máy chủ đó 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ạ bên dưới:

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

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

Chúng tôi đã thêm trường "Thuật toán chữ ký" mới vào thông tin chi tiết về chứng chỉ SSL. Bạn có thể xem trường này 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 hiển thị "sha1WithRSAEncryption" hoặc "sha256WithRSAEncryption", tuỳ thuộc vào loại thuật toán băm dùng để tạo chứng chỉ.

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ị > Chứng chỉ SSL) cho biết thời điểm các chứng chỉ SSL sắp 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.

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

Theo mặc định, Edge sẽ gửi mã trạng thái Lỗi 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 chính sách Bảo vệ 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 bạn đặt thuộc tính org features.isPolicyHttpStatusEnabled thành true, hành vi sau đây sẽ xảy ra:

• Yêu cầu: Khi một chính sách bảo vệ chống mối đe doạ được đính kèm vào bất kỳ luồng yêu cầu nào, 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 có chính sách bảo vệ chống mối đe doạ được đính kèm vào bất kỳ luồng phản hồi nào, 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ụ trên đám mây phải liên hệ với Nhóm hỗ trợ Apigee để đặt tài sản 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 Private Cloud hằng quý tiếp theo.

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

Cá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 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 có trong bản phát hành này.

Giai đoạn phát hành rộng rãi của SmartDocs

SmartDocs sẽ chuyển từ giai đoạn thử nghiệm beta sang giai đoạn phát hành công khai. 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ả tính năng nhập theo tệp hoặc URL, bao gồm cả tính năng hỗ trợ đối tượng bảo mật được đặt 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 tính năng 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 dành cho nhà phát triển, có sẵn thông qua 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 "security" (bảo mật) của quy trình xác thực được xác định ở cấp 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 bất kỳ thông tin xác thực ứng dụng SmartDocs nào được định cấu hình trước.

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

Để biết tài liệu về SmartDocs, hãy xem bài viết Sử dụng SmartDocs để ghi lại 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 dành cho 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 theo tên nội bộ để khắc phục sự cố và quản lý API.

Dịch vụ Analytics

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

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

Theo mặc định, 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ý, bạn sẽ không thể truy cập vào dữ liệu cũ hơn 6 tháng kể 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 Nhóm hỗ trợ Apigee.

Xoá phiên bản cũ của báo cáo tuỳ chỉnh khỏi giao diện người dùng quản lý

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

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 (mục Mức độ tương tác của nhà phát triển) đã được cải tiến để mang lại hiệu suất tốt 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 đô la nhất định trong gói giá theo số lượng hoặc gói giá 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á kỳ tính phí định kỳ và kỳ tính phí theo cơ sở tổng hợp

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

• Kỳ thanh toán 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ỳ.
• Khoảng thời gian cơ sở tổng hợp, được xác định trên thẻ giá cho các gói theo số lượng hoặc gói, 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 một gói giá có cả phí định kỳ khác 0 và thẻ giá theo nhóm phòng hoặc theo gói, thì thời hạn phí định kỳ sẽ được áp dụng cho cả hai. Ví dụ: nếu có phí định kỳ hằng tháng, thì các gói 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ó khoản phí định kỳ nào, thì 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 thẻ 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 một tháng sau ngày 19.

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 giá.

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

Các 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 về 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 Apigee Edge for Private Cloud có thể đặt cờ bằng lệnh gọi API sau đây và thông tin xác thực 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 tuỳ chỉnh trong lệnh gọi API được mã hoá URL.

Quy trình nâng cấp SmartDocs

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

Mọi trang SmartDocs đã được xuất bản trong cổng thông tin dành 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 mọi thay đổi đối với trang hiện có hoặc trang mới.

Xin lưu ý rằng mặc dù bạn có thể hiển thị và xuất bản SmartDocs bên trong cổng thông tin dành 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 cạnh 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ả 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ừ phiên bản SmartDocs thử nghiệm lên phiên bản phát hành công khai

1. Cập nhật và kiểm thử bản phát hành 15.05.27 trong môi trường phát triển hoặc kiểm thử 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 tệp JSON SmartDocs và nhập vào mô hình mới bằng tệp đính kèm.
3. Thiết lập 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 trước trong trang cài đặt mô hình (Content > SmartDocs) bằng cách nhấp vào Settings (Cài đặt) trong cột Operations (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 các 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. Kết xuất 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 phiên bản chính thức 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ó câu hỏi hoặc thắc mắc 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 về tính năng trong tương lai

Phần này xem trước các thay đổi và điểm cải tiến dự kiến về 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: Theo mặc định, phần tử <ExcludeErrorResponse> trong chính sách bộ nhớ đệm phản hồi là sai. Đ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. Tức 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 các 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.

Giải pháp hiện tại: Đối với Private Cloud 4.15.07.00 trở về trước, nếu chỉ muốn lưu các phản hồi có Mã trạng thái từ 200 đến 205 vào bộ nhớ đệm, 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.

> 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