Configuring ephemeral storage

You are viewing documentation for a release that is no longer supported. The latest supported version of version 3 is [3.11]. For the most recent version 4, see [4]

You are viewing documentation for a release that is no longer supported. The latest supported version of version 3 is [3.11]. For the most recent version 4, see [4]

Overview

OKD can be configured to allow management of ephemeral storage of pod and container working data. While containers have been able to utilize writable layers, logs directories, and EmptyDir volumes, this storage has been subject to a number of limitations, as discussed here.

Ephemeral storage management permits administrators to limit the resources consumed by individual pods and containers, and for pods and containers to specify requests and limits on their use of such ephemeral storage. This is a technology preview for OKD 3.10 and is disabled by default.

This technology preview does not change any of the mechanisms for making local storage available in OKD; the existing mechanisms, root directory or runtime directory, still apply. This technology preview only provides a mechanism for managing the use of this resource.

Enabling ephemeral storage

To enable ephemeral storage:

  1. Edit or create the master configuration file on all masters, /etc/origin/master/master-config.yaml by default, and add LocalStorageCapacityIsolation=true in the apiServerArguments and controllerArguments sections:

    1. apiServerArguments:
    2.    feature-gates:
    3.    - LocalStorageCapacityIsolation=true
    4. ...
    6.  controllerArguments:
    7.    feature-gates:
    8.    - LocalStorageCapacityIsolation=true
    9. ...

  2. Edit the ConfigMap for all nodes to enable the LocalStorageCapacityIsolation on the command line. You can identify the ConfigMaps that need to be edited as follows:

    1. $ oc get cm -n openshift-node
    2. NAME                  DATA      AGE
    3. node-config-compute   1         52m
    4. node-config-infra     1         52m
    5. node-config-master    1         52m

    For each of these maps, node-config-compute, node-config-infra, and node-config-master, you need to add the feature gate:

    1. oc edit cm node-config-master -n openshift-node

    If there is already a feature-gates: declaration, add the following text to the list of feature gates:

    1. ,LocalStorageCapacityIsolation=true

    If there is no feature-gates: declaration, add the following section:

    1.   feature-gates:
    2.   - LocalStorageCapacityIsolation=true

  3. Repeat for node-config-compute, node-config-infra, and any other ConfigMaps.

  4. Restart OKD and delete the container running the apiserver.

Omitting any of these steps may result in ephemeral storage management not being enabled.