.. _user/services/structure/resources/volume:

*************
Cybus::Volume
*************

A volume represents a storage space and can be associated to :ref:`containers
<user/services/structure/resources/container>`.

.. note:: |feature_not_on_kubernetes|

The life-time of the storage volume is as follows: If it does not exist upon enabling
the service, the volume will be newly created by Connectware. Subsequently,
it will neither be deleted nor truncated by Connectware, neither on
disabling the service nor on any other occasion. It needs to be deleted
manually. The idea is that it will stay between services being installed,
enabled, disabled and removed.

Commissioning files can additionally specify *files* as :ref:`Cybus::File
<user/services/structure/resources/file>` resources which should be created
inside volumes.

Example
=======

.. code-block:: yaml
  :linenos:

  myVolume:
    type: Cybus::Volume