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.
Truy cập vào tài liệu 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 Đám mây riêng.

Kể từ bản phát hành hằng quý trước của Edge for Private Cloud (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
• Đá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 từng bước, 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 khác của Edge, rồi nâng cấp lê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 cho Đám mây riêng tư nào 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 của Cassandra:
   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 nhóm 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ả phải 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 bất kỳ tệp *.db nào ở đị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ả cá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.
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ả 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 nhóm tệp .db nếu bạn đang chạy Cassandra 2.0.

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

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

Các tập lệnh apigee-upgrade.sh và apigee-uninstall.sh hiện 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 sẽ nâng cấp hoặc gỡ cài đặt tất cả các thành phần trên nút. (OPDK-1377, OPDK-1175)

Khôi phục phiên bản cũ

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ể dùng tập lệnh apigee-rollback.sh để khôi phục phiên bản trước khi 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 về 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 lựa chọn, chẳng hạn như --help. Giờ đây, các tuỳ chọn này chỉ chấp nhậ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. Điều này đảm bảo rằng SmartDocs được cài đặt ở vị trí dự kiến. Trước đây, những 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

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 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 loại bỏ hỗ trợ cho JDK 1.6. (OPDK-1187)

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

Apigee Edge cho Đám mây riêng đã 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 đó, 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ệ tốt hơn các mã thông báo OAuth trong trường hợp vi phạm 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 các 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 cho 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 thao tác 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 vận hành 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 mộ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 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 đã bị ngừng hoạt động. Tổng số phần tử có trong tất cả cá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 hoạt động 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ớ có sẵn, đượ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 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 "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 thiện về khả năng sử dụng, bao gồm cả chế độ xem toàn diện hơn về các luồng và điểm cuối có điều kiện trên trang Tổng quan, tất cả cấu hình trên trang Phát triển, việc thêm các luồng, điểm cuối và chính sách có điều kiện một cách trực quan hơn, chế độ xem XML đầy đủ 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ề Xoá thông tin OAuth phiên bản 2.0

Chính sách mới "Xoá thông tin OAuth phiên bản 2.0" cho phép bạn xoá mã thông báo truy cập OAuth phiên bản 2 và mã uỷ quyền. Chính sách này thay thế chức năng mà trước đây API quản lý cung cấp. Để 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 phiên bản 1.0" cho phép bạn xoá mã thông báo yêu cầu, mã thông báo 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à trước đây được cung cấp bởi API quản lý. Để 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 truy cập đã được cải thiện để 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 chặn khi địa chỉ IP nằm 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 đề (hãy liên hệ với Nhóm hỗ trợ để thiết lập tính năng này.enableMultipleXForwardCheckForACL), một phần tử <ValidateBasedOn> mới trong chính sách 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 Thực thể truy cập

Chính sách Access Entity (Thực thể truy cập) cấp quyền truy cập vào các thực thể mới sau đây: 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 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 bộ sưu tậ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ụ > Bộ sưu tập số liệu phân tích tuỳ chỉnh), biến bộ thu thập (số liệu thống kê) "Tên" phải là chữ thường. Nếu bạn nhập tên bằng chữ in 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 Dấu vết 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ừ giai đoạn thử nghiệm sang giai đoạn cung cấp công khai. 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 cũ của dấu vết" nữa.

Quyền truy cập vào Cộng đồng Apigee thông qua 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 thông qua 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à những đ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ý được 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 mà thông báo lỗi xuất hiện. (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 nữa. (MGMT-2242)

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

Chúng tôi đã cải thiện một số 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à việc dọn dẹp thông báo lỗi.

Siêu liên kết 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 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 bằng siêu liên kết, giúp bạn nhanh chóng chuyển đến các trang vai trò. (MGMT-1055)

Các 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 đầy đủ hơn về URL cho các điểm cuối đích và máy chủ đích:

• 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ử HTTPTargetConnection <LoadBalancer> 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 đích). Nếu bạn muốn sử dụng SNI, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.

Bạn phải dùng 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 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 hướng nam (Đám mây biên theo 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 máy chủ đó vào yêu cầu bắt tay SSL. Ví dụ: nếu máy chủ lưu trữ đích 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 tại 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

Một 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 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ừ một kho khoá hoặc kho tin cậy). Trường này cho biết "sha1WithRSAEncryption" hoặc "sha256WithRSAEncryption", tuỳ thuộc vào loại thuật toán băm được 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 chứng chỉ SSL 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 trình đơn thả xuống mới về thời gian hết hạn.

Lỗi cấu hình biện pháp 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 đượ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 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 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 có 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 Cloud phải liên hệ với Nhóm hỗ trợ Apigee Edge để thiết lập thuộc tính tổ chức. Khách hàng sử dụng Edge Private Cloud sẽ có thể sử dụng tính năng này trong bản phát hành Private Cloud theo quý tiếp theo.

Đã cập nhật giản đồ cho các điểm cuối, proxy và 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 theo 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 có 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 beta 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 về thiết kế trực quan trong các mẫu tạo SmartDocs.
• Cải thiện khả năng sử 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ó 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 máy khách ở cấp mẫu. Các bản sửa đổi mới sẽ không còn đặt lại bất kỳ thông tin xác thực ứng dụng khách SmartDocs nào được định cấu hình trước.

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

Để biết tài liệu về SmartDocs, hãy xem phần 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ý

Các ứ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ị (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ụ Analytics

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 quản lý hoặc API, theo mặc định, bạn sẽ không truy cập được dữ liệu cũ hơn 6 tháng so với 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 Edge.

Phiên bản cũ của báo cáo tuỳ chỉnh sẽ bị xoá 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 hiện không còn trong giao diện người dùng quản lý nữa.

Hiệu suất của tiện ích Tương tác với nhà phát triển

Chúng tôi đã cải thiện tiện ích phễu trên trang tổng quan phân tích chính (mục Mức độ tương tác của nhà phát triể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ề Kế hoạch giá giú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 về số tiền nhất định trong kế hoạch giá theo gói hoặc theo dải số 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á các kỳ tính phí định kỳ và cơ sở tổng hợp

Trong một gói giá, có thể có 2 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 kế hoạch 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 bảng giá cho các gói theo Bậc hoặc Gói, xác định thời điểm sử dụng gói được đặt lạ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à thẻ giá theo dải số lượng hoặc thẻ giá theo gói đều có trong một gói giá, thì khoảng thời gian tính 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 thẻ 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 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 sẽ không còn được dùng nữa và sẽ bị xoá khỏi tính năng kiếm tiền trong 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 thẻ giá.

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

Chính sách ghi nhận 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 và giờ đây, bạn có thể đưa những thuộc tính giao dịch tuỳ chỉnh đó vào báo cáo doanh thu tóm tắt. 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 sử dụng 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 tuỳ chỉnh trong lệnh gọi API được mã hoá 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 công khai yêu cầu bạn nâng cấp SmartDocs trong cổng thông tin dành cho nhà phát triển.

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 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 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 Edge của Apigee. Mọi thay đổi mà bạn thực hiện đối với một mô hình API trong Edge sẽ giống nhau trên tất cả các môi trường Pantheon của bạn (tương tự như cách các 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 beta của SmartDocs 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 SmartDocs JSON và nhập vào mô hình mới bằng cách sử dụng tệp đính kèm.
3. Đặt các thuộc tính bảo mật cho bản sửa đổi của mô hình. Trên trang Nội dung > SmartDocs > model, hãy chọn Security Settings (Chế độ cài đặt bảo mật).
   
4. Kiểm tra mọi hoạt động 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 để lập tài liệu về 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 sản xuất của bạn lên bản phát hành ngày 27/5/15.

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 tốt nhất.

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

Phần này xem trước những thay đổi và điểm cải tiến dự kiến của 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 (sẽ được 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 theo mặc định là sai. Điều này có nghĩa là theo mặc định, các phản hồi có mã trạng thái HTTP có thể có (bao gồm cả 3xx) sẽ đượ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 vào bộ nhớ đệm các phản hồi cho tất cả mã trạng thái, bạn sẽ cần đặt phần tử <ExcludeErrorResponse> thành true một cách rõ ràng.

Giải pháp tạm thời 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 chỉ muốn lưu phản hồi vào bộ nhớ đệm 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.

Các lỗi đã được khắc phục

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