volume_tar
----------

Description
===========

    * Verify and install tar content in a docker volume spectified by the environment variable OPENSVC_VOL_PATH, automatically set by the fs.docker driver provisioner.
    * Paths are relative to the volume head
    * Verify tar archive is extracted on check action                                                                                                                          
    * Extract tar archive on fix action                                                                                                                                        
    * Immutable boolean is used to know if extracted tar content can be modified on filesystem                                                                                 
    

Example rule
============

::

    {
        "path": "/home/user/bin",
        "ref": "/some/path/to/file.tar",
        "immutable": "true"
    }

Form definition
===============

::

    
    Desc: |
      A volume_tar rule, fed to the 'tar' compliance object to extract archive inside docker volume. For tar files, a reference content must be specified or pointed through an URL.
    Css: comp48
    
    Outputs:
      -
        Dest: compliance variable
        Class: file
        Type: json
        Format: dict
    
    Inputs:
      -
        Id: ref
        Label: Tar uri
        DisplayModeLabel: ref
        LabelCss: fa-map-marker
        Help: "Examples:
            /path/to/reference_file.tar
            safe://safe.uuid.8dc85529a2b13b4b.626172.tar
            http://server/path/to/reference_file.tar
            https://server/path/to/reference_file.tar
            ftp://server/path/to/reference_file.tar
            ftp://login:pass@server/path/to/reference_file.tar"
        Type: string
      -
        Id: path
        Label: Install path
        DisplayModeLabel: path
        LabelCss: fa-map-marker
        Mandatory: Yes
        Help: path to install the tar reference content to.
        Type: string
      -
        Id: immutable
        Label: Immutable
        DisplayModeLabel: immutable
        LabelCss: fa-lock
        Mandatory: Yes
        Help: "On : extracted tar archive must not be modified on filesystem
               Off: extracted tar archive contents on filesystem can be modified"
        Type: boolean