Enhanced FileOrCreate description (#19442)

Signed-off-by: wawa0210 <xiaozhang0210@hotmail.com>
2020-03-16 13:56:36 +08:00
parent 26d8e0c539
commit 72129e2a0e
1 changed files with 32 additions and 0 deletions
@@ -605,6 +605,38 @@ spec:
      type: Directory
 ```

+{{< caution >}}
+It should be noted that the `FileOrCreate` mode does not create the parent directory of the file. If the parent directory of the mounted file does not exist, the pod fails to start. To ensure that this mode works, you can try to mount directories and files separately, as shown below.
+{{< /caution >}}
+
+#### Example Pod FileOrCreate
+
+```yaml
+apiVersion: v1
+kind: Pod
+metadata:
+  name: test-webserver
+spec:
+  containers:
+  - name: test-webserver
+    image: k8s.gcr.io/test-webserver:latest
+    volumeMounts:
+    - mountPath: /var/local/aaa
+      name: mydir
+    - mountPath: /var/local/aaa/1.txt
+      name: myfile
+  volumes:
+  - name: mydir
+    hostPath:
+      # Ensure the file directory is created.
+      path: /var/local/aaa
+      type: DirectoryOrCreate
+  - name: myfile
+    hostPath:
+      path: /var/local/aaa/1.txt
+      type: FileOrCreate
+```
+
 ### iscsi {#iscsi}

 An `iscsi` volume allows an existing iSCSI (SCSI over IP) volume to be mounted