Các vấn đề đã biết với Apigee

Khi biến luồng cachehit được sử dụng sau chính sách LookupCache, do cách các điểm gỡ lỗi được gửi cho hành vi không đồng bộ, LookupPolicy sẽ điền sẵn đối tượng DebugInfo trước khi lệnh gọi lại được thực thi, dẫn đến lỗi.

Giải pháp: Lặp lại quy trình (thực hiện lệnh gọi thứ hai) ngay sau lệnh gọi đầu tiên.

Việc đặt PurgeChildEntries trong chính sách InvalidateCache chỉ nên xoá các giá trị phần tử KeyFragment mà còn xoá toàn bộ bộ nhớ đệm.

Giải pháp: Sử dụng chính sách KeyValueMapOperations để lặp lại việc tạo phiên bản bộ nhớ đệm và bỏ qua việc cần phải vô hiệu hoá bộ nhớ đệm.

Điều này có thể xảy ra, ví dụ: khi các lần chạy đồng thời của quy trình triển khai CI/CD xảy ra bằng các bản sửa đổi khác nhau. Để tránh vấn đề này, hãy tránh triển khai proxy API hoặc SharedFlows trước khi quá trình triển khai hiện tại hoàn tất.

Giải pháp: Tránh triển khai proxy API hoặc SharedFlow đồng thời.

• Apigee Edge hỗ trợ Bản đặc tả OpenAPI 3.0 khi bạn tạo bản đặc tả bằng trình chỉnh sửa bản đặc tả và phát hành API bằng SmartDocs trên cổng thông tin, mặc dù một số tính năng chưa được hỗ trợ.

  Ví dụ: các tính năng sau đây trong Quy cách OpenAPI 3.0 chưa được hỗ trợ:

  • Các thuộc tính allOf để kết hợp và mở rộng giản đồ
  • Tham chiếu từ xa

  Nếu một tính năng không được hỗ trợ được tham chiếu trong Quy cách OpenAPI, thì trong một số trường hợp, các công cụ sẽ bỏ qua tính năng đó nhưng vẫn hiển thị tài liệu tham khảo API. Trong các trường hợp khác, một tính năng không được hỗ trợ sẽ gây ra lỗi khiến bạn không thể hiển thị thành công tài liệu tham khảo API. Trong cả hai trường hợp, bạn sẽ cần sửa đổi Thông số kỹ thuật OpenAPI để tránh sử dụng tính năng không được hỗ trợ cho đến khi tính năng đó được hỗ trợ trong bản phát hành trong tương lai.

  Lưu ý: Vì trình chỉnh sửa thông số kỹ thuật ít hạn chế hơn SmartDocs khi hiển thị tài liệu tham khảo API, nên bạn có thể nhận được kết quả khác nhau giữa các công cụ.

• Khi sử dụng tính năng Thử API này trong cổng thông tin, tiêu đề Accept sẽ được đặt thành application/json bất kể giá trị được đặt cho consumes trong Thông số kỹ thuật OpenAPI.
• 138438484: Không hỗ trợ nhiều máy chủ.

• Hiện tại, chúng tôi không hỗ trợ việc nhiều người dùng cập nhật cùng lúc trang web (chẳng hạn như chỉnh sửa trang, giao diện, CSS hoặc tập lệnh).
• Nếu xoá một trang tài liệu tham khảo API khỏi cổng thông tin, bạn sẽ không thể tạo lại trang đó; bạn cần xoá và thêm lại sản phẩm API rồi tạo lại tài liệu tham khảo API.
• Khi định cấu hình chính sách bảo mật nội dung, có thể mất đến 15 phút để các thay đổi được áp dụng đầy đủ.
• Khi tuỳ chỉnh giao diện cổng thông tin, có thể mất đến 5 phút để các thay đổi được áp dụng đầy đủ.

• Tính năng Tìm kiếm sẽ được tích hợp vào cổng thông tin tích hợp trong một bản phát hành trong tương lai.

Khi bạn cập nhật Edge cho Private Cloud từ phiên bản 4.51.00, 4.52.00 hoặc 4.52.01 lên 4.52.02, hãy dự kiến tác động bổ sung đối với thời gian chạy và API quản lý.

Ảnh hưởng này xảy ra sau khi các nút Cassandra được cập nhật và kéo dài cho đến khi tất cả các nút máy chủ quản lý và trình xử lý thông báo được cập nhật.

Khi điều này xảy ra, bạn có thể sẽ thấy tác động ở một trong những khía cạnh sau:

• API thời gian chạy làm mới mã thông báo OAuth
• API quản lý liệt kê ứng dụng của nhà phát triển
• API quản lý liệt kê sản phẩm

Apigee sẽ phát hành tài liệu cập nhật sửa đổi cho Edge for Private Cloud 4.52.02 để giải quyết vấn đề này.

Vấn đề này chỉ ảnh hưởng đến những người đang sử dụng MINT hoặc đã bật MINT trong các lượt cài đặt Edge cho Private Cloud.

Thành phần bị ảnh hưởng: edge-message-processor

Vấn đề: Nếu đã bật tính năng kiếm tiền và đang cài đặt phiên bản 4.52.01 dưới dạng cài đặt mới hoặc nâng cấp từ các phiên bản Private Cloud trước đó, bạn sẽ gặp sự cố với trình xử lý thông báo. Số lượng luồng đang mở sẽ tăng dần, dẫn đến tình trạng cạn kiệt tài nguyên. Bạn sẽ thấy trường hợp ngoại lệ sau trong system.log của trình xử lý thông báo cạnh:

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread

Gần đây, chúng tôi phát hiện một lỗ hổng từ chối dịch vụ (DoS) trong nhiều cách triển khai giao thức HTTP/2 (CVE-2023-44487), bao gồm cả Apigee Edge cho đám mây riêng. Lỗ hổng này có thể dẫn đến tình trạng từ chối dịch vụ đối với chức năng quản lý API Apigee. Để biết thêm thông tin, hãy xem Bản tin bảo mật của Apigee GCP-2023-032.

Các thành phần bộ định tuyến và máy chủ quản lý của Edge for Private Cloud được hiển thị trên Internet và có thể dễ bị tấn công. Mặc dù HTTP/2 được bật trên cổng quản lý của các thành phần dành riêng cho Edge khác của Edge cho đám mây riêng tư, nhưng không có thành phần nào trong số đó được hiển thị trên Internet. Trên các thành phần không phải Edge, chẳng hạn như Cassandra, Zookeeper và các thành phần khác, HTTP/2 sẽ không được bật. Bạn nên làm theo các bước sau để giải quyết lỗ hổng Edge cho đám mây riêng:

• Các bước dành cho Edge for Private Cloud phiên bản 4.51.00.11 trở lên
• Các bước cho các phiên bản Edge for Private Cloud cũ hơn 4.51.00.11

Hãy làm theo các bước sau nếu bạn đang sử dụng Edge Private Cloud phiên bản 4.51.00.11 trở lên:

1. Cập nhật máy chủ quản lý:

   1. Trên mỗi nút máy chủ quản lý, hãy mở /opt/apigee/customer/application/management-server.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần máy chủ quản lý:

      apigee-service edge-management-server restart

2. Cập nhật trình xử lý thông báo:

   1. Trên mỗi nút trình xử lý thông báo, hãy mở /opt/apigee/customer/application/message-processor.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-message-processor restart

3. Cập nhật bộ định tuyến:

   1. Trên mỗi nút bộ định tuyến, hãy mở /opt/apigee/customer/application/router.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-router restart

4. Cập nhật QPID:

   1. Trên mỗi nút QPID, hãy mở /opt/apigee/customer/application/qpid-server.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-qpid-server restart

5. Cập nhật Postgres:

   1. Trên mỗi nút Postgres, hãy mở /opt/apigee/customer/application/postgres-server.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-postgres-server restart

Hãy làm theo các bước sau nếu bạn đang sử dụng các phiên bản Edge for Private Cloud cũ hơn 4.51.00.11:

1. Cập nhật máy chủ quản lý:

   1. Trên mỗi nút máy chủ quản lý, hãy mở /opt/apigee/customer/application/management-server.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần máy chủ quản lý:

      apigee-service edge-management-server restart

2. Cập nhật trình xử lý thông báo:

   1. Trên mỗi nút trình xử lý thông báo, hãy mở /opt/apigee/customer/application/message-processor.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-message-processor restart

3. Cập nhật bộ định tuyến:

   1. Trên mỗi nút bộ định tuyến, hãy mở /opt/apigee/customer/application/router.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-router restart

4. Cập nhật QPID:

   1. Trên mỗi nút QPID, hãy mở /opt/apigee/customer/application/qpid-server.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-qpid-server restart

5. Cập nhật Postgres:

   1. Trên mỗi nút Postgres, hãy mở /opt/apigee/customer/application/postgres-server.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thông báo:

      apigee-service edge-postgres-server restart

Apigee-postgresql gặp vấn đề khi nâng cấp từ Edge for Private Cloud phiên bản 4.50 hoặc 4.51 lên phiên bản 4.52. Các vấn đề này chủ yếu xảy ra khi số lượng bảng lớn hơn 500.

Bạn có thể kiểm tra tổng số bảng trong Postgres bằng cách chạy truy vấn SQL bên dưới:

select count(*) from information_schema.tables

Giải pháp: Khi Cập nhật Apigee Edge 4.50.00 hoặc 4.51.00 lên 4.52.00, hãy nhớ thực hiện bước sơ bộ trước khi nâng cấp Apigee-postgresql.

149245401: Chế độ cài đặt nhóm kết nối LDAP cho JNDI được định cấu hình thông qua tài nguyên LDAP không được phản ánh và chế độ mặc định của JNDI gây ra các kết nối dùng một lần mỗi lần. Do đó, các kết nối đang được mở và đóng mỗi lần sử dụng một lần, tạo ra một số lượng lớn kết nối mỗi giờ với máy chủ LDAP.

Giải pháp:

Để thay đổi các thuộc tính của nhóm kết nối LDAP, hãy làm theo các bước sau để đặt thay đổi chung trên tất cả các chính sách LDAP.

1. Tạo tệp thuộc tính cấu hình nếu chưa có:

   /opt/apigee/customer/application/message-processor.properties

2. Thêm nội dung sau vào tệp (thay thế các giá trị của thuộc tính Java Naming and Directory Interface (JNDI) (Giao diện thư mục và đặt tên Java) dựa trên yêu cầu cấu hình tài nguyên LDAP).

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. Đảm bảo tệp /opt/apigee/customer/application/message-processor.properties thuộc quyền sở hữu của apigee:apigee.
4. Khởi động lại từng trình xử lý thông báo.

Để xác minh rằng các thuộc tính JNDI của nhóm kết nối đang có hiệu lực, bạn có thể thực hiện một tcpdump để quan sát hành vi của nhóm kết nối LDAP theo thời gian.

139051927: Độ trễ xử lý proxy cao được tìm thấy trong Trình xử lý thông báo đang ảnh hưởng đến tất cả Proxy API. Các triệu chứng bao gồm độ trễ 200-300 mili giây trong thời gian xử lý so với thời gian phản hồi API thông thường và có thể xảy ra ngẫu nhiên ngay cả khi TPS thấp. Điều này có thể xảy ra khi có hơn 50 máy chủ mục tiêu mà trình xử lý thông báo tạo kết nối.

Nguyên nhân gốc rễ: Các trình xử lý thông báo lưu giữ một bộ nhớ đệm liên kết URL máy chủ mục tiêu với đối tượng HTTPClient cho các kết nối đi đến máy chủ mục tiêu. Theo mặc định, chế độ cài đặt này được đặt thành 50, có thể quá thấp đối với hầu hết các trường hợp triển khai. Khi một lượt triển khai có nhiều tổ hợp org/env trong một chế độ thiết lập và có tổng số máy chủ mục tiêu vượt quá 50, các URL máy chủ mục tiêu sẽ liên tục bị xoá khỏi bộ nhớ đệm, gây ra độ trễ.

Xác thực: Để xác định xem việc xoá URL máy chủ mục tiêu có gây ra vấn đề về độ trễ hay không, hãy tìm kiếm từ khoá "onEvict" hoặc "Eviction" trong system.logs của Trình xử lý thông báo. Sự hiện diện của các URL này trong nhật ký cho biết rằng các URL máy chủ mục tiêu đang bị xoá khỏi bộ nhớ đệm HTTPClient vì kích thước bộ nhớ đệm quá nhỏ.

Giải pháp: Đối với Edge for Private Cloud phiên bản 19.01 và 19.06, bạn có thể chỉnh sửa và định cấu hình bộ nhớ đệm HTTPClient, /opt/apigee/customer/application/message-processor.properties:

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

Sau đó, hãy khởi động lại trình xử lý thông báo. Thực hiện các thay đổi tương tự cho tất cả trình xử lý thông báo.

Giá trị 500 là một ví dụ. Giá trị tối ưu cho chế độ thiết lập của bạn phải lớn hơn số lượng máy chủ mục tiêu mà trình xử lý thông báo sẽ kết nối. Việc đặt thuộc tính này cao hơn sẽ không gây ra tác dụng phụ nào và chỉ ảnh hưởng đến thời gian xử lý yêu cầu proxy của trình xử lý thông báo.

Lưu ý: Edge for Private Cloud phiên bản 50.00 có chế độ cài đặt mặc định là 500.

157933959: Việc chèn và cập nhật đồng thời vào cùng một bản đồ giá trị khoá (KVM) trong phạm vi tổ chức hoặc cấp môi trường sẽ gây ra dữ liệu không nhất quán và mất nội dung cập nhật.

Lưu ý: Giới hạn này chỉ áp dụng cho Edge cho đám mây riêng. Edge cho đám mây công khai và kết hợp không có giới hạn này.

Để khắc phục trong Edge for Private Cloud, hãy tạo KVM ở phạm vi apiproxy.