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 đá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 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 New Edge được đơn giản hoá
○ Loại trừ 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

Chúng tôi đã giới thiệu các vấn đề sau đây ảnh hưởng đến khả năng tương thích ngược trong phiên bản Apigee của ứng dụng Apigee Edge for Private Cloud:

     
  • Do đã khắc phục 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 sẽ 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 tiêu đề được hỗ trợ.

  • Tên của 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 bao gồm

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










19.03.0119.02.1919.02.0419.01.2319.01.1418.12.0418.08.3118.07.31
○1}








19.07.0819.05.2319.05.0819.04.1819.03.2019.02.2719.02.2119.02.0419.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 nội dung sau không được dùng nữa:

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

Để biết thêm thông tin, hãy xem phần Apigee ngừng sử dụng, ngừng hoạt động và thay đổi CPS.

Sửa lỗi

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

7.19 sao lưu .
19 3









HEAD

Để biết thêm thông tin về từng bản sửa lỗi này, hãy xem phần Bả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:

○ 2 141628497 (141628497) (141628497) (141628497)
○Thiết lập thông báo lỗi máy chủ xếp hạng Mint (137865184)
○ Định dạng tệp siêu dữ liệu cho chế độ cài đặt apigee-sso (135616498)
○ ○ ○ apigee-monit không được hỗ trợ trên bộ xử lý Amazon Linux 1 (1223770980)



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

Nâng cấp lộ trình

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

From 4.19.01 Trực tiếp nâng cấp từ 4.19.01 → 4.19.06
Từ 4.18.05 Trực tiếp nâng cấp từ 4.18.05 → 4.19.06
Từ 1/4/2001 Trực tiếp nâng cấ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 Giao diện người dùng Edge, Quản lý cạnh và Cổng thông tin có trong Bản phát hành đi kèm.

Ngoài các tính năng nâng cao sau đây, bản phát hành này cũng có nhiều tính năng nâng cao về khả năng hữu dụng, 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 các lượt cài đặt, nhưng các cấu trúc liên kết lớn hơn có nhiều MP có thể bị hết thời gian chờ khi một số lượng lớn lệnh gọi đồng thời được thực hiện qua RPC.

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

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

Giá đỡ Cassandra giá đỡ

Apigee hiện cung cấp hướng dẫn chung để mở rộng quy mô hoạt động của Cassandra bằng cách giúp Cassandra nhận biết được giá trị của Apigee Edge dành cho đám mây riêng tư.

Để biết thêm thông tin, hãy xem bài viết 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 Bộ 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 bài viết Ghi dữ liệu phân tích vào tệp.

Cài đặt phiên bản New Edge được đơn giản hoá

Quá 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 Trải nghiệm Edge mới.

Hỗ trợ IDP đối với LDAP

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) cùng với Ngôn ngữ đánh dấu xác nhận bảo mật (SAML). Hỗ trợ LDAP bao gồm cả phương thức liên kết trực tiếp và 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ả lệnh gọi API thời gian chạy đến Apigee Edge dành cho đám mây riêng tư đều sử dụng IPv4. Bạn có thể thêm tính năng 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 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ừ việc thêm các giao dịch INVALID_TSC 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 Thuộc tính máy chủ kiếm tiền.

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ợ

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

Các nền tảng sau không còn được hỗ trợ với bản phát hành này:

  • 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 phầ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 Đám mây riêng tư đã đượ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 bao gồm tất cả các bản sửa lỗi 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ó trong Bản phát hành đi kèm.

ID vấn đề Nội dung mô tả
140270474

Chưa đặt UseStringDeduplicate

UseStringDeduplication không được thiết lập cho các thành phần edge-message-processor trong môi trường sản xuất.
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 đây 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

Thất bại của 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

Việc nâng cấp 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 hai người dùng trong cùng một tổ chức đã tạo các proxy có cùng tên, thì người dùng thứ hai được tạo sẽ ghi đè proxy đầu tiên. Điều này chỉ xảy ra khi nhiều người dùng không thể thấy proxy kia.
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à 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

Phân tích 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ừ Cổng vi mô, đã được đặt thành một ngày trong tương lai.
110785400

Không sao lưu được

ZooKeeper, Cassandra và OpenLDAP không sao lưu được dữ liệu đúng cách với lỗi sau: File changed as we read it.
79993247

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

HEAD yêu cầu đến mục tiêu 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

Giờ đây, việc thực thi sao lưu/khôi phục apigee-postgres 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 sys

Việc đặt lại mật khẩu quản trị viên hệ thống cho Máy chủ quản lý 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 đề Nội dung mô tả
141628497

Ban đầu, Mint chưa xếp hạng các giao dịch

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

API hỗ trợ kiếm tiền phản hồi bằng mã công việc và sau khi hoàn tất, trạng thái của công việc sẽ cho biết trạng thái 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ý hoạt động kiếm tiền và sẽ không được xếp hạng. 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 tạm thời:

Khởi động lại mọi Bộ xử lý thư (MP) bằng cách 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 MP sẽ khiến Edge tải cấu hình từ ZooKeeper khi khởi động. Điều này xảy ra mỗi lần khởi động lại, nghĩa là sự cố chỉ xảy ra ở giai đoạn đầu.

137865184

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

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

Giải pháp tạm thời:

Không nội dung nào.
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 bao gồm dòng mới (CRLF) ở cuối tệp, thì tệp metadata.xml không được đọc toàn bộ.

Giải pháp tạm thời:

Để 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 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 tạm thời:

Không nội dung nào.
121095148

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

Giải pháp tạm thời:

Chạy quá trình sao lưu lần thứ hai và quá trình này sẽ 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 một kho dữ liệu không còn 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à Máy chủ quản lý có thể không khởi động vì máy chủ này đang cố kết nối với các nút Cassandra trong cả dc-1 và dc-2. DataAccessExceptions xảy ra nếu nút Cassandra bị hỏ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ông báo sẽ 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à để Máy chủ quản lý không kết nối với các thành phần của kho dữ liệu trên các khu vực.

Giải pháp

Cách giải quyết là huỷ đăng ký các loại nút Cassandra sau đây trong trung tâm dữ liệu không sử dụng được, rồi đăng ký lại các loại nút đó 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 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 đặt Máy chủ quản lý.
    • GATEWAY_POD là tên nhóm, theo mặc định là "cổng vào". Tuy nhiên, bạn có thể đã đổi tên thành tên khác, vì vậy hãy kiểm tra cách triển khai.
    • 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 có đị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ẽ sử dụng các nút 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 lưu ý đến những 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 mỗi mã nhận dạng duy nhất (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

Lưu ý rằng các thao tác này sẽ đăng ký và huỷ đăng ký các nút khỏi Zookeeper và không tác độ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 yêu cầu đăng ký kho dữ liệu.

68722102

Chính sách về Ghi nhật ký thư bao gồm cả 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 lại. Khi FormatMessage=false, tin nhắn được ghi lại không được chứa bất kỳ thông tin nào do Apigee tạo ra. 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 tạm thời:

Không nội dung nào.

Bước tiếp theo

Để bắt đầu với Edge for 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