Creating a hostPath PersistentVolume
Create a hostPath PersistentVolume.
A hostPath volume mounts a file or directory from the host node's file system into your pod. For more information about hostPath volume, see Types of Volumes .
A hostPath PersistentVolume must be used only in a single-node cluster. Kubernetes does not support hostPath on a multi-node cluster currently.
You can create a hostPath PersistentVolume by using the management console.
To view a list of persistent volumes in your IBM® Cloud Private cluster, from the navigation menu, click Platform > Storage.
Required user type or access level: Cluster administrator
Creating a hostPath PersistentVolume by using the Create PersistentVolume dialog box
To create a hostPath PersistentVolume:
- From the navigation menu, click Platform > Storage.
- Click Create PersistentVolume.
-
Enter the PersistentVolume details.
To create a hostPath PersistentVolume, specify the following parameters:
General tab
- Name - (required) Provide a name for the PersistentVolume.
- Capacity - (required) Provide the storage capacity.
- Access mode - (optional) Select
ReadWriteOnce
- Reclaim policy - (optional) Select
Retain
orRecycle
. -
Storage Type - (required) Select
Host path
.Label tab
Attach a label to the PersistentVolume. A label is a key and value pair. For example:
type=local
. This parameter is optional.Parameters tab
- Parameters for storage. Parameters are supplied as key and value pairs. For hostPath, you must specify:
- A path
- Key: - path
- Value: - the location of the file or directory on your cluster's node. For example:
/tmp/data
- A path
- Click Create.
Creating a hostPath PersistentVolume by using the "Create resource" window
- From the dashboard, click Create resource.
-
Copy and paste a YAML or JSON file into the "Create resource" window. For more information about creating a PersistentVolume by using a YAML file, see Create a PersistentVolume .
A simple YAML might look like this example:
kind: PersistentVolume apiVersion: v1 metadata: name: hostpath2 labels: type: local spec: capacity: storage: 1Gi accessModes: - ReadWriteOnce reclaimPolicy: - Recycle hostPath: path: "/tmp/data1"
-
Click Create.
After the deployment completes, a new hostPath PersistentVolume is displayed in the PersistentVolume list. Review the status of the PersistentVolume. The PersistentVolume must have a status of Available
.