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.
Truy cập vào tài liệu Apigee X.
thông tin

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

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 có các tính năng mới sau:

○ Hỗ trợ LDAP cho SSO
○ Hỗ trợ triển khai HTTP
○ Phân tích có thể cắm
○ Hỗ trợ giá đỡ Cassandra
○ Hỗ trợ IPv6
○ Cài đặt đơn giản cho trải nghiệm New Edge
○ Loại trừ các giao dịch INVALID_TSC (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 phần Tính năng mới.

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

Phiên bản Apigee Edge cho Đám mây riêng tư này có những vấn đề sau đây ảnh hưởng đến khả năng tương thích ngược:

     
  • Do bản sửa lỗi cho vấn đề 132443137 (như mô tả trong ghi chú phát hành Cloud công khai 19.03.01), Trình xử lý thông báo hiện bỏ qua các 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 tiêu đề X-Apigee-* và thay thế các tiêu đề đó bằng những tiêu đề được hỗ trợ.

  • Tên của tệp nhật ký Cassandra đã thay đổi. Hiện tại, bạn có thể:

    /opt/apigee/var/log/apigee-cassandra/system.log
Bản phát hành có trong gói

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

○ Edge:
   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
○ Portal:
   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
Các thành phần bị loại bỏ Không có
Ngừng sử dụng

Với việc phát hành phiên bản 4.19.06, những nội dung sau đây sẽ không được dùng nữa:

  • 4.18.01: Phiên bản 4.18.01 của Apigee Edge cho Đám mây riêng hiện không được dùng nữa.

Để biết thêm thông tin, hãy xem bài viết Các thay đổi về việc ngừng cung cấp, ngừng hoạt động và CPS của Apigee.

Sửa lỗi

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

○ UseStringDeduplication chưa được đặt (140270474)
○ Lỗi MP (111445518)
○ Lỗi Cassandra với JMX (113342838)
○ Nâng cấp 13 nút (138931337)
○ Các proxy có cùng tên (119802562)
○ Không tải được kho khoá (118851790)
○ Phân tích không thành công (110988191)
○ Sao lưu không thành công (110785400)
○ Yêu cầu HEAD đối với 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 Các bản sửa lỗi.

Lỗi đã biết

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

○ Mint ban đầu không đánh giá các giao dịch (141628497)
○ Rò rỉ bộ nhớ máy chủ Mint rating (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)
○ Sao lưu Trình xử lý thông báo không sao lưu đúng tập hợp tệp (121095148)
○ DataAccessExceptions trong cấu hình nhiều trung tâm dữ liệu (76087166)
○ Chính sách MessageLogging bao gồm 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ác giải pháp, hãy xem phần Các vấn đề đã biết.

Lộ trình nâng cấp

Bảng sau đây cho biết các lựa chọn 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ừ 4.19.01 → 4.19.06
Từ 18/4/2005 Nâng cấp trực tiếp từ 4.18.05 → 4.19.06
Từ ngày 1/18/4 Nâng cấp trực tiếp từ 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 trong bản phát hành Edge UI, Edge Management và Portal được liệt kê trong phần Các bản phát hành được bao gồm.

Ngoài những điểm cải tiến sau, bản phát hành này còn có nhiều điểm cải tiến về khả năng sử dụng, hiệu suất, tính 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 các proxy API. Mặc dù chế độ này hoạt động rất hiệu quả đối với hầu hết các lượt cài đặt, nhưng các cấu trúc liên kết lớn có nhiều MP có thể gặp phải tình trạng 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 hoạt động triển khai lớn hơn nên sử dụng HTTP thay vì RPC để triển khai. Hiện tại, chúng tôi đã hỗ trợ việc bật các lượt triển khai HTTP.

Để biết thêm thông tin, hãy xem phần Bật tính năng triển khai HTTP.

Giá đỡ Cassandra

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

Để biết thêm thông tin, hãy xem phần Hỗ trợ giá đỡ Cassandra.

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ông báo 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 lựa chọn.

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

Cài đặt phiên bản đơn giản của Microsoft Edge mới

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

Để biết thêm thông tin, hãy xem bài viết Cài đặt phiên bản Edge mới.

Hỗ trợ IdP LDAP

Quy trình xác thực người dùng bằng giao diện người dùng Edge và các lệnh gọi API quản lý Edge hiện hỗ trợ LDAP ngoài SAML. Tính năng 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ề quy trình xác thực IDP bên ngoài.

Hỗ trợ IPv6

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

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

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

Giờ đây, bạn có thể loại trừ các giao dịch INVALID_TSC khỏi việc được thêm vào cơ sở dữ liệu 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 từ các thuộc tính máy chủ.

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

Bản phát hành này có những thay đổi sau đây đối với phần mềm được hỗ trợ:

Đã thêm thông tin hỗ trợ Không đượ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

Để xem danh sách đầy đủ các nền tảng được hỗ trợ, hãy xem bài viết Phần mềm được hỗ trợ và các 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 đã được khắc phục trong bản phát hành này. Ngoài ra, bản phát hành này còn bao gồm tất cả các bản sửa lỗi trong bản phát hành Edge UI, Edge Management và Portal như trong phần Các bản phát hành được bao gồm.

ID vấn đề Mô tả
140270474

Chưa đặt UseStringDeduplication

UseStringDeduplication không được thiết lập cho các thành phần edge-message-processor trong môi trường phát hành công khai.
111445518

Lỗi MP

Trình xử lý thư liên tục ghi thông báo lỗi sau đây cứ 5 phút một lần:
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 Cassandra với JMX

Các 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

Các bản nâng cấp của bản 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 các proxy có cùng tên, thì proxy thứ hai được tạo sẽ ghi đè proxy đầu tiên. Điều này chỉ xảy ra khi những người dùng khác không nhìn thấy proxy còn lại.
118851790

Không tải được kho khoá

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

Analytics không thành công

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

Lỗi sao lưu

ZooKeeper, Cassandra và OpenLDAP thỉnh thoảng không sao lưu dữ liệu đúng cách kèm theo lỗi sau: File changed as we read it.
79993247

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

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

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

Việc thực thi lệnh sao lưu/khôi phục apigee-postgres hiện 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

Việc đặ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ác ký tự đặc biệt sẽ không thành công.

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

Mint không đánh giá các giao dịch ban đầu

Ban đầu, Edge for Private Cloud không đánh giá các giao dịch khi bạn bật tính năng kiếm tiền lần đầu cho một tổ chức. Quy định này áp dụng cho cả tổ chức mới và tổ chức hiện có.

API bật tính năng kiếm tiền sẽ phản hồi bằng mã nhận dạng công việc và 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 xử lý bằng tính năng kiếm tiền và sẽ không được đánh giá. Những 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ông báo (MP). Bạn có thể thực hiện việc này bằng cách làm như sau:
apigee-service edge-message-processor restart

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

137865184

Rò rỉ bộ nhớ máy chủ xếp hạng Mint

Khi một phiên bản Qpid mới được đăng ký trong một mxgroup, các hàng đợi sẽ được tạo mà không có người dùng, dẫn đến việc độ sâu hàng đợi tăng lên cho đến khi sử dụng hết 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 để cài đặt apigee-sso

Khi cài đặt apigee-sso và sử dụng tệp metadata.xml thay vì URL, nếu tệp metadata.xml không có dòng mới (CRLF) ở cuối tệp, thì tệp metadata.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 CRLF vào cuối tệp metadata.xml

    HOẶC

  • 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

Bản sao lưu của Trình xử lý thông báo không sao lưu đúng bộ tệp

Giải pháp:

Chạy quy trình sao lưu lần thứ hai và quy trình này sẽ sao lưu đúng bộ tệp.

76087166

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

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

DataAccessException: Error while accessing datastore;
Please retry later

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

Xin lưu ý rằng trạng thái dự kiến là Máy chủ quản lý sẽ 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

Giải pháp tạm thời là huỷ đăng ký các loại nút Cassandra sau đây trong trung tâm dữ liệu không hoạt động, sau đó đăng ký lại chúng 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 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 của tài khoản Apigee.
    • MS_IPMS_PORT là địa chỉ IP và số cổng của Máy chủ quản lý.
    • REGION là tên của trung tâm dữ liệu nơi Máy chủ quản lý được đặt.
    • GATEWAY_POD là tên nhóm, theo mặc định là "gateway". Tuy nhiên, có thể bạn đã đổi tên thành một 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 các giá trị kms-datastore, dc-datastorekeyvaluemap-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"

    Phản hồ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"
    }

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

  2. Lặp lại bước một cho từng loại nút Cassandra: kms-datastore, dc-datastorekeyvaluemap-datastore. Hãy nhớ ghi lại các 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 UUID mà bạn đã thu thập ở 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

Xin lưu ý rằng các thao tác này đăng ký và huỷ đăng ký các nút từ Zookeeper và không ảnh hưởng đến cụm Cassandra. Để biết thêm thông tin về các lệnh này, hãy xem phần Cập nhật thông tin đă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 báo được ghi nhật ký. Khi FormatMessage=false, thông báo được ghi nhật ký không được bao gồm bất kỳ thông tin nào 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 những 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 cho Đám mây riêng tư 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