All Products
Search
Document Center

Container Service for Kubernetes:Mount OSS buckets as volumes in ACK clusters

Last Updated:Oct 21, 2026

Mount OSS buckets as statically provisioned volumes in ACK clusters with persistent volumes (PVs) and persistent volume claims (PVCs).

ACK clusters support only statically provisioned OSS volumes. Mount an OSS bucket with a persistent volume (PV) and a persistent volume claim (PVC).

Important

Only CentOS 7 and Alibaba Cloud Linux 2 are supported, both of which have reached their end of maintenance (EOM). Upgrade from FlexVolume to Container Storage Interface (CSI) first, then upgrade the node operating system.

Prerequisites

An OSS bucket is created.

Usage notes

Configuration notes for statically provisioned OSS volumes:

  • An OSS bucket can be shared by multiple pods.

  • bucket: Only buckets can be mounted. Subdirectories or files within a bucket are not supported.

  • url: The OSS bucket endpoint. Use the internal endpoint if the bucket and node are in the same region.

  • akId: Your AccessKey ID.

  • akSecret: Your AccessKey Secret.

  • otherOpts: Custom mount parameters. Format: -o *** -o ***.

  • To mount an OSS bucket, do not specify subpath.

  • Create a PV for each application.

Usage notes for OSSFS

  • OSSFS mounts OSS as a Filesystem in Userspace (FUSE) file system. This method is suitable for read operations, such as reading configuration files, videos, and images.

  • OSSFS is not suitable for write operations. For write operations, use File Storage NAS (NAS) file systems instead.

  • Adjust parameters to optimize OSSFS caching and permission management. See FAQ about OSSFS, ossfs/README-CN.md, and FAQ.