Skip to content

Outline Online EmptyDir volume restrictions and workaround. #1529

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
adellape merged 1 commit into from
Feb 17, 2016
Merged

Outline Online EmptyDir volume restrictions and workaround. #1529

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion dev_guide/new_app.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -214,7 +214,7 @@ link:../install_config/install/docker_registry.html#securing-the-registry[secure
with SSL],
endif::[]
ifdef::openshift-dedicated[]
secured with SSL,
secured with SSL,
endif::[]
cluster administrators must ensure that the Docker daemon on the
OpenShift nodes is run with the `--insecure-registry` flag pointing to that
Expand Down Expand Up @@ -542,3 +542,16 @@ labels for all objects here.
====
To see all of the configuration options, click the "Show advanced build and deployment options" link.
====

ifdef::openshift-online[]
== Troubleshooting
`*EmptyDir*` volumes are disabled in OpenShift Online at present. In some situations new-app will automatically create or use templates which contain `*EmptyDir*` volumes. In this scenario you will need to use `oc edit` to modify the relevant PodSpec and replace the use of `*EmptyDir*` volumes with a `*PersistentVolumeClaim*`.

When this situations occurs, the error will surface as an event with a message similar to:

----
Error creating: Pod "redis-1-" is forbidden: unable to validate against any security context constraint: [spec.containers[0].securityContext.volumes: invalid value 'emptyDir', Details: EmptyDir volumes are not allowed to be used]
----

To correct the issue, identify the relevant object containing an `emptyDir` volume with `oc export`, and use `oc edit` to replace it with a persistent volume claim. For more information, see documentation on link:./persistent_volumes.html[persistent volumes].
endif::[]
7 changes: 7 additions & 0 deletions dev_guide/volumes.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,13 @@ single machine. Administrators may also allow you to request a
link:persistent_volumes.html[persistent volume] that is automatically attached
to your pods.

ifdef::openshift-online[]
[NOTE]
====
`*EmptyDir*` volumes are disabled in OpenShift Online at present, you will need to use persistent volume claims instead for the time being.
====
endif::[]

You can use the CLI command `oc volume` to link:#adding-volumes[add],
link:#updating-volumes[update], or link:#removing-volumes[remove] volumes and
volume mounts for any object that has a pod template like
Expand Down