4.19.06 Ghi chú phát hành của Edge dành cho đám mây riêng tư

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X.
thông tin

Phần này mô tả phiên bản 4.19.06 của Edge dành cho bản phát hành tính năng riêng tư trên đám mây.

Tóm tắt về bản phát hành

Bảng sau đây tóm tắt các thay đổi trong bản phát hành này:

Tính năng mới

Bản phát hành này bao gồm các tính năng mới sau đây:

○ Hỗ trợ LDAP cho SSO
○ Hỗ trợ triển khai HTTP
○ Số liệu phân tích có thể cắm
○ Hỗ trợ giá Cassandra
○ Hỗ trợ IPv6
○ Cài đặt trải nghiệm Edge mới được đơn giản hoá
○ Loại trừ INVALID_TSC giao dịch (Kiếm tiền)

Để biết thêm thông tin về từng tính năng mới này, hãy xem Tính năng mới.

Khả năng tương thích ngược

Phiên bản này đã có các vấn đề sau đây ảnh hưởng đến khả năng tương thích ngược của Apigee Edge cho Private Cloud:

     
  • Do đã khắc phục vấn đề 132443137 (như mô tả trong ngày 19.03.01 Ghi chú phát hành của Cloud), Giờ đây, Trình xử lý thư bỏ qua tiêu đề bắt đầu bằng X-Apigee-*. Do đó, bạn phải tái cấu trúc mọi mã sử dụng X-Apigee-* tiêu đề rồi thay thế các tiêu đề đó bằng tiêu đề được hỗ trợ.

  • Tên của các tệp nhật ký Cassandra đã thay đổi. Bây giờ là:

    /opt/apigee/var/log/apigee-cassandra/system.log
Bản phát hành được đưa vào

Kể từ bản phát hành trước đây của Edge dành cho tính năng đám mây riêng tư, các bản phát hành sau đã xảy ra và được đưa vào bản phát hành này:

○ Cạnh:
19.07.23 (Giao diện người dùng)
19.03.01
19.02.19
19.02.04
19.01.23
19.01.14
18.12.04
18.08.31
18.07.31
○ Cổng thông tin:
19.07.08
19.05.23
19.05.08
19.04.18
19.03.20
19.02.27
19.02.21
19.02.04
19.01.16
Nghỉ hưu Không có
Ngừng sử dụng

Với bản phát hành 4.19.06, các tính năng sau không được dùng nữa:

  • 4.18.01: Phiên bản 4.18.01 của Apigee Edge cho Private Cloud hiện không còn được dùng nữa.

Để biết thêm thông tin, hãy xem Việc ngừng sử dụng Apigee, ngừng sử dụng và CPS thay đổi.

Sửa lỗi

Bản phát hành này bao gồm các bản sửa lỗi sau:

○ Sử dụng chuỗi tính năng trùng lặp không được đặt (140270474)
○ Lỗi MP (111445518)
○ Lỗi Cassandra với JMX (113342838)
○ Nâng cấp 13 nút (138931337)
○ Proxy có cùng tên (119802562)
○ Kho khoá không tải (118851790)
○ Số liệu phân tích không thành công (110988191)
○ Lỗi sao lưu (110785400)
HEAD yêu cầu đến Node.js (79993247)
○ sao lưu/khôi phục apigee-postgres (70291825)
○ Đặt lại mật khẩu quản trị viên hệ thống (65737520)

Để biết thêm thông tin về từng bản sửa lỗi này, hãy xem phần Sửa lỗi.

Lỗi đã biết

Bản phát hành này bao gồm các vấn đề đã biết sau đây:

○ Ban đầu, Mint không xếp hạng các giao dịch (141628497)
○ Rò rỉ bộ nhớ máy chủ phân loại của Mint (137865184)
○ Định dạng tệp siêu dữ liệu để cài đặt apigee-sso (135616498)
apigee-monit không được hỗ trợ trên Amazon Linux 1 (122370980)
○ Tính năng sao lưu Trình xử lý tin nhắn không sao lưu đúng nhóm tệp (121095148)
○ DataAccessExceptions trong các cấu hình đa trung tâm dữ liệu (76087166)
○ Chính sách MessageLogging bao gồm cả thông tin bổ sung trong thông điệp nhật ký (68722102)

Để biết thêm thông tin về từng vấn đề đã biết này, bao gồm cả cách giải quyết, hãy xem Các vấn đề đã biết.

Nâng cấp đường dẫn

Bảng sau đây cho thấy các lộ trình nâng cấp cho bản phát hành này:

Từ 4/19/01 Nâng cấp trực tiếp từ phiên bản 4.19.01 → 4.19.06
Từ 4.18.05 Nâng cấp trực tiếp từ phiên bản 4.18.05 → 4.19.06
Từ 4.18.01 Nâng cấp trực tiếp từ phiên bản 4.18.01 → 4.19.06

Tính năng mới

Phần này liệt kê các tính năng mới trong bản phát hành này. Ngoài ra, bản phát hành này bao gồm tất cả các tính năng có trong bản phát hành Giao diện người dùng Edge, Quản lý cạnh và Cổng thông tin được liệt kê trong Bản phát hành đi kèm.

Ngoài các cải tiến sau đây, bản phát hành này cũng có nhiều tính hữu dụng, nâng cao hiệu suất, bảo mật và độ ổn định.

Hỗ trợ triển khai HTTP

Theo mặc định, Edge sử dụng RPC để triển khai proxy API. Mặc dù chế độ này hoạt động rất hiệu quả đối với hầu hết quá trình cài đặt, những lời xin lỗi lớn hơn với nhiều nghị sĩ có thể gặp phải sự cố hết thời gian chờ khi một số lượng lớn các lệnh gọi đồng thời được thực hiện thông qua RPC.

Do đó, Apigee khuyến nghị các quy trình triển khai lớn nên sử dụng HTTP thay vì RPC cho triển khai. Hiện đã hỗ trợ bật tính năng triển khai HTTP.

Để biết thêm thông tin, hãy xem bài viết Bật HTTP triển khai.

Hỗ trợ giá Cassandra

Hiện tại, Apigee cung cấp hướng dẫn chung giúp mở rộng quy mô hoạt động của Cassandra bằng cách làm cho Cassandra trên Apigee Edge để nhận biết giá đỡ Private Cloud.

Để biết thêm thông tin, hãy xem Hệ thống hỗ trợ giá casandra.

Số liệu phân tích có thể cắm

Theo mặc định, dữ liệu phân tích do Trình xử lý thư thu thập sẽ được tải lên Qpid và Postgres để xử lý. Sau đó, bạn có thể xem dữ liệu phân tích trong giao diện người dùng Edge.

Với Bản phát hành tính năng này, bạn có thể định cấu hình Trình xử lý thông báo để ghi dữ liệu phân tích vào ổ đĩa hoặc bạn có thể chọn sử dụng cả hai tuỳ chọn.

Để biết thêm thông tin, hãy xem Ghi dữ liệu phân tích vào một tệp.

Đơn giản hoá việc cài đặt phiên bản New Edge

Việc cài đặt phiên bản Edge mới đã được đơn giản hoá bằng tập lệnh mới.

Để biết thêm thông tin, hãy xem phần Cài đặt Trải nghiệm Edge mới.

Hỗ trợ nhà cung cấp danh tính cho LDAP

Việc xác thực người dùng bằng lệnh gọi API quản lý Edge và giao diện người dùng Edge hiện hỗ trợ Giao thức truy cập thư mục hạng nhẹ (LDAP) trong bổ sung cho SAML. Hỗ trợ LDAP bao gồm cả phương thức liên kết trực tiếp và phương thức liên kết gián tiếp.

Để biết thêm thông tin, hãy xem bài viết Tổng quan về gói Xác thực IDP.

Hỗ trợ IPv6

Theo mặc định, tất cả các lệnh gọi API trong thời gian chạy tới Apigee Edge dành cho Private Cloud đều sử dụng IPv4. Bạn có thể thêm IPv6 hỗ trợ cho Bộ định tuyến với thuộc tính mới.

Để biết thêm thông tin, hãy xem phần Sử dụng IPv6 trên Bộ định tuyến.

Loại trừ INVALID_TSC giao dịch (Kiếm tiền)

Giờ đây, bạn có thể loại trừ không cho INVALID_TSC giao dịch được thêm vào Postgres khi sử dụng tính năng Kiếm tiền.

Để biết thêm thông tin, hãy xem bài viết Kiếm tiền thuộc tính máy chủ.

Phần mềm được hỗ trợ

Bản phát hành này bao gồm các thay đổi sau đối với phần mềm được hỗ trợ:

Đã thêm dịch vụ hỗ trợ Không còn được hỗ trợ nữa

Bản phát hành này hỗ trợ thêm các nền tảng sau:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Bản phát hành này không còn hỗ trợ các nền tảng sau:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

Để biết danh sách đầy đủ các nền tảng được hỗ trợ, hãy xem Các phiên bản phần mềm và phiên bản được hỗ trợ.

Sửa lỗi

Phần này liệt kê các lỗi trên Đám mây riêng tư đã được khắc phục trong bản phát hành này. Ngoài ra, đây là bản phát hành bao gồm tất cả các bản sửa lỗi trong giao diện người dùng Edge, giao diện Quản lý Edge và bản phát hành Cổng thông tin được thể hiện trong Bản phát hành đi kèm.

ID vấn đề Mô tả
140270474

UseStringDeDuplicate không được đặt

UseStringDeduplication không phải là đang thiết lập cho các thành phần edge-message-processor trong phiên bản chính thức môi trường xung quanh.
111445518

Lỗi MP

Bộ xử lý thông báo liên tục ghi lại thông báo lỗi sau mỗi 5 phút:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Lỗi của Casandra với JMX

Thao tác Cassandra không hoạt động khi tính năng xác thực JMX được bật
138931337

Nâng cấp 13 nút

Nâng cấp các cài đặt 13 nút từ 17.09, 18.01 và 18.05 không thành công.
119802562

Các proxy có cùng tên

Nếu 2 người dùng trong cùng một tổ chức tạo proxy có cùng tên, miền thứ hai được tạo sẽ thay thế miền đầu tiên. Điều này chỉ xảy ra khi những người dùng khác nhau không thể thấy proxy khác.
118851790

Kho khoá không tải

Khi có hơn 100 kho khoá cho một tổ chức/môi trường, kho khoá và không tải được phần tham chiếu trong Giao diện người dùng Edge. Thay vào đó, giao diện người dùng cho thấy lỗi Internal Error (Error Fetching Keystores).
110988191

Analytics không thành công

Analytics không thành công cho một môi trường khi được cung cấp cùng với dữ liệu từ Microgateway đặt thành một ngày trong tương lai.
110785400

Lỗi sao lưu

ZooKeeper, Cassandra và OpenLDAP liên tục gặp lỗi sao lưu đúng cách dữ liệu của họ với lỗi sau: File changed as we read it.
79993247

HEAD yêu cầu đến Node.js

Các yêu cầu HEAD đến một đích Node.js có thể bị treo, khiến các kết nối đang chờ xử lý.
70291825

sao lưu/khôi phục apigee-postgres

Việc thực thi tính năng sao lưu/khôi phục apigee-postgres giờ đây sẽ sao lưu dữ liệu cho tất cả các thành phần.
65737520

Đặt lại mật khẩu quản trị viên hệ thống

Đặt lại mật khẩu quản trị viên hệ thống cho Máy chủ quản lý có chứa đặc biệt ký tự nào sẽ bị lỗi.

Vấn đề đã biết

Bảng sau đây liệt kê các vấn đề đã biết trong bản phát hành này:

ID vấn đề Mô tả
141628497

Ban đầu, Min không xếp hạng các giao dịch

Edge dành cho Đám mây riêng tư không đánh giá các giao dịch khi ban đầu bạn bật tính năng kiếm tiền cho một tổ chức. Điều này áp dụng cho các tổ chức mới và hiện tại.

API bật tính năng kiếm tiền sẽ phản hồi bằng mã công việc. Sau khi hoàn tất, trạng thái của công việc sẽ cho biết thành công. Tuy nhiên, mọi lệnh gọi API kiếm tiền được thực hiện ban đầu sẽ không được tính năng kiếm tiền xử lý và không được xếp hạng. Các giao dịch này sẽ chỉ xuất hiện trong số liệu phân tích thông thường.

Giải pháp:

Khởi động lại mọi Trình xử lý thư (MP). Bạn có thể thực hiện việc này bằng các thao tác sau:
apigee-service edge-message-processor restart

Sau khi bật tính năng kiếm tiền, việc khởi động lại các tệp MP sẽ khiến Edge tải cấu hình từ ZooKeeper khi khởi động. Vấn đề này xảy ra mỗi lần khởi động lại, có nghĩa là vấn đề chỉ xảy ra ban đầu.

137865184

Rò rỉ bộ nhớ của máy chủ phân loại đúc

Khi một thực thể Qpid mới được đăng ký trong một mxgroup, hàng đợi sẽ tạo mà không có thực thể tiêu thụ, dẫn đến việc chiều sâu của hàng đợi tăng lên cho đến khi sử dụng tất cả tài nguyên có sẵn.

Giải pháp:

Không có.
135616498

Định dạng tệp siêu dữ liệu cho lượt cài đặt apigee-sso

Khi cài đặt apigee-sso và sử dụng tệp siêu dữ liệu.xml thay vì URL, nếu tệp siêu dữ liệu.xml không có một dòng mới (CRLF) ở cuối tệp, thì tệp siêu dữ liệu.xml sẽ không được đọc toàn bộ.

Giải pháp:

Để giải quyết vấn đề này, bạn có thể làm theo một trong những cách sau:

  • Thêm một CRLF vào cuối tệp siêu dữ liệu.xml

    OR

  • Sử dụng vị trí dựa trên URL cho siêu dữ liệu
122370980

apigee-monit không được hỗ trợ trên Amazon Linux 1

Giải pháp:

Không có.
121095148

Tính năng sao lưu Trình xử lý thư không sao lưu đúng nhóm tệp

Giải pháp:

Hãy chạy tính năng sao lưu lần thứ hai và sao lưu đúng nhóm tệp.

76087166

DataAccessException trong nhiều cấu hình trung tâm dữ liệu

Trong nhiều cấu hình trung tâm dữ liệu, nếu không thể sử dụng một kho dữ liệu, thì bạn có thể thấy lỗi sau đây:

DataAccessException: Error while accessing datastore;
Please retry later

Kết quả là Máy chủ quản lý có thể không khởi động vì máy chủ này đang cố gắng kết nối với Cassandra các nút trong cả dc-1 và dc-2. DataAccessExceptions xảy ra nếu một nút Cassandra là xuống. Điều này cũng có thể dẫn đến gián đoạn lưu lượng truy cập API, trong đó Trình xử lý thư báo cáo DataAccessExceptions trong khi cố gắng truy xuất KVM.

Lưu ý rằng trạng thái dự kiến là khi Máy chủ quản lý không kết nối với các thành phần kho dữ liệu trên các khu vực.

Giải pháp

Cách khắc phục là huỷ đăng ký các loại nút Cassandra sau đây trong những trung tâm dữ liệu không hoạt động rồi đăng ký lại sau khi các nút Cassandra hoạt động trở lại:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Cách huỷ đăng ký và đăng ký lại các loại nút Cassandra này:

  1. Lấy mã nhận dạng duy nhất (UUID) của các nút Cassandra bằng cách sử dụng lệnh curl sau:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Trong trường hợp:

    • ADMIN_EMAILADMIN_PW là thông tin đăng nhập Apigee của bạn tài khoản.
    • MS_IPMS_PORT là địa chỉ IP và cổng của Máy chủ quản lý số.
    • REGION là tên của trung tâm dữ liệu trong đó Máy chủ quản lý vị trí.
    • GATEWAY_POD là tên của nhóm, theo mặc định là "cổng vào". Bạn có thể có đã đổi tên thành tên khác, vì vậy hãy kiểm tra quá trình triển khai của bạn.
    • CASSANDRA_NODE_TYPE là một trong số kms-datastore, dc-datastore, và keyvaluemap-datastore.

    Ví dụ:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    Câu trả lời sử dụng định dạng sau:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Ví dụ:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Ghi lại các giá trị của trường uUID trong phản hồi. Bạn sẽ dùng những thông tin này để huỷ đăng ký các nút.

  2. Lặp lại bước 1 cho từng loại nút Cassandra: kms-datastore, dc-datastorekeyvaluemap-datastore. Hãy nhớ lưu ý đến Mã nhận dạng duy nhất (UUID) được trả về.
  3. Huỷ đăng ký các nút bằng lệnh sau:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Trong đó UUID là UUID được trả về trong phản hồi của lệnh trước.

  4. Lặp lại bước 3 cho từng mã nhận dạng duy nhất (UUID) bạn đã thu thập được ở bước 1 và 2.
  5. Đăng ký lại các nút bằng lệnh sau:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Lưu ý rằng các thao tác này sẽ đăng ký và huỷ đăng ký các nút cho Zookeeper và không có bất kỳ tác động đến cụm Cassandra. Để biết thêm thông tin về các lệnh này, hãy xem Cập nhật hoạt động đăng ký kho dữ liệu.

68722102

Chính sách MessageLogging bao gồm thông tin bổ sung trong thông điệp nhật ký

Phần tử FormatMessage của chính sách MessageLogging kiểm soát định dạng của thông điệp đã ghi nhật ký. Khi FormatMessage=false, tin nhắn đã ghi nhật ký không được chứa thông tin do Apigee tạo. Tuy nhiên, ngay cả khi bạn đặt FormatMessage=false, thông điệp nhật ký vẫn bao gồm các thông tin sau:

  • Điểm ưu tiên
  • Dấu thời gian

Giải pháp:

Không có.

Bước tiếp theo

Để bắt đầu sử dụng Edge dành cho Private Cloud 4.19.06, hãy sử dụng các đường liên kết sau:

Cài đặt mới:
Tổng quan mới về việc cài đặt
Cài đặt hiện tại:
Đường dẫn nâng cấp