本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文，但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况，请以原始 英文 版本为准，且原始英文版本为权威文本。

UI Server-Side Pagination

UI server-side pagination is not intended for use in production at this time. This feature is considered highly experimental. SUSE customers should consult SUSE Support before activating this feature.

UI server-side pagination caching provides an optional SQLite-backed cache of Kubernetes objects to improve performance. This unlocks sorting, filtering and pagination features used by the UI to restrict the amount of resources it fetches and stores in browser memory. These features are primarily used to improve list performance for resources with high counts.

This feature creates file system based caches in the rancher pods of the upstream cluster, and in the cattle-cluster-agent pods of the downstream clusters. In most environments, disk usage and I/O should not be significant. However, you should monitor activity after you enable caching.

SQLite-backed caching persists copies of any cached Kubernetes objects to disk. See Encrypting SQLite-backed Caching if this is a security concern.

Enabling UI Server-Side Pagination

  1. In the upper left corner, click ☰ > Global Settings > Feature Flags.

  2. Find ui-sql-cache and select ⋮ > Activate > Activate.

  3. Wait for Rancher to restart. This also restarts agents on all downstream clusters.

  4. In the upper left corner, click ☰ > Global Settings > Performance.

  5. Go to Server-side Pagination and check the Enable Server-side Pagination option.

  6. Click Apply.

  7. Reload the page with the browser button (or the equivalent keyboard combination, typically CTRL + R on Windows and Linux, and ⌘ + R on macOS).

Encrypting SQLite-backed Caches

UI server-side pagination persists copies of any cached Kubernetes objects to disk. If you’re concerned about the safety of this data, you can encrypt all objects before they are persisted to disk, by setting the environment variable CATTLE_ENCRYPT_CACHE_ALL to true in rancher pods in the upstream cluster and cattle-cluster-agent pods in the downstream clusters.

Secrets and security Tokens are always encrypted regardless of the above setting.

Known Limitations of UI Server-Side Pagination

This initial release improves the performance of Pods, Secrets, Nodes and ConfigMaps in the Cluster Explorer pages, and most resources in the Explorer’s More Resources section.

Pages can’t be automatically refreshed. You can manually refresh table contents by clicking the Refresh button.