All Products
Search
Document Center

Container Service for Kubernetes:OSS volumes

Last Updated:Jun 25, 2026

You can use Alibaba Cloud OSS volumes in ACK clusters.

ACK supports only static persistent volumes for OSS. Dynamically provisioned volumes are not supported. You can use static persistent volumes by creating persistent volumes (PVs) and persistent volume claims (PVCs).

Important

Only the CentOS 7 and Alibaba Cloud Linux 2 operating systems are supported. These operating systems are no longer maintained. You must migrate FlexVolume to CSI before you upgrade the node operating system. For more information about the migration, see Migrate FlexVolume to CSI.

Prerequisites

Before you use a static persistent volume for OSS, you must create a bucket in the OSS console. For more information, see Create a bucket in the console.

Usage notes

Note the following when configuring a static persistent volume for OSS:

  • OSS provides shared storage and can be used by multiple pods simultaneously.

  • bucket: Only buckets can be mounted. Subdirectories or files within a bucket cannot be mounted.

  • url: The OSS Endpoint, which is the domain name used to access OSS. If the node and the bucket are in the same region, use an internal network address.

  • akId: Your AccessKey ID.

  • akSecret: Your AccessKey secret.

  • otherOpts: Custom parameters for mounting OSS. Use the format -o *** -o ***.

  • Do not use the subpath configuration for OSS volumes.

  • When you use volumes, you must assign a unique PV name to each application.

Important notes

  • OSS volumes are Filesystem in Userspace (FUSE) file systems mounted using ossfs. They are suitable for read-only scenarios, such as reading configuration files, videos, and images.

  • ossfs is not suitable for write-intensive application scenarios. If your application writes files to storage, use NAS volumes.

  • You can adjust configuration parameters to optimize ossfs performance for caching and permissions. For more information, see FAQ, ossfs/README-CN.md, and FAQ.