< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

Configure External Persistent Storage

This section explains how to configure an external persistent storage system for the KubeSphere cluster in a production environment. A persistent storage system is used to create volumes for storing application data in KubeSphere. If an external persistent storage system is not configured, KubeSphere will default to using the local storage system of the cluster nodes. If your KubeSphere cluster does not require external persistent storage, you can skip this section.

Note

The configuration of external persistent storage for KubeSphere is only supported in scenarios where Kubernetes and KubeSphere are installed together. If you install KubeSphere on an existing Kubernetes cluster, KubeSphere will use the existing persistent storage configuration of the Kubernetes cluster.

How to Install Storage Systems

When installing KubeSphere, different storage systems can be installed as plugins. KubeKey will create a configuration file (default is config-sample.yaml) that contains all the necessary parameters to define different resources, including storage plugins. To have KubeKey install these storage systems as expected, you must provide the necessary configurations for these storage systems to KubeKey.

Generally, there are two ways to have KubeKey apply the configuration of the storage systems.

  1. Directly input the necessary parameters under the addons field in config-sample.yaml.

  2. Create a separate configuration file for the plugin, listing all necessary parameters, and configure the file path in config-sample.yaml so that KubeKey can reference the path during the installation process.

For more information, see Plugins.

Default Storage Class

  • KubeKey supports installing different storage plugins and storage classes. Regardless of which storage system you install, you can specify whether it should be set as the default storage class in its configuration file.

  • If you install multiple storage plugins, only one of them can be set as the default storage class. Otherwise, KubeKey will not be able to identify which storage class to use.

Configure Cloud Storage Devices

Learn how to configure cloud storage devices for the KubeSphere cluster in a production environment.

Configure NeonSAN CSI

Learn how to configure NeonSAN CSI for the KubeSphere cluster in a production environment.

Configure NFS

Learn how to configure Network File System (NFS) for the KubeSphere cluster in a production environment.

Configure Open-Source Storage Systems

Learn how to configure open-source storage systems for KubeSphere clusters in production environments.