Skip to main content

podman_volume resource

Use the podman_volume Chef InSpec audit resource to test the properties of a volume on Podman.

Availability

Install

This resource is distributed with Chef InSpec and is automatically available for use.

Syntax

Use the podman_volume Chef InSpec audit resource to test the properties of a volume on Podman.

describe podman_volume("my_volume") do  it { should exist }  its("name") { should eq "my_volume" }  its("driver") { should eq "local" }  its("mountpoint") { should eq "/var/home/core/.local/share/containers/storage/volumes/my_volume/_data" }  its("created_at") { should eq "2022-07-14T13:21:19.965421792+05:30" } end 

where:

  • 'name', 'driver', 'mountpoint', and 'created_at' are properties of this resource to fetch the respective value of the podman volume.
  • exist is a matcher of this resource.

Properties

Properties of the resources: name, driver, mountpoint, created_at, labels, scope, options, mount_count, needs_copy_up, and needs_chown.

name

The name property returns the name of the volume.

its("name") { should eq "my_volume" } 

driver

The driver property returns the value for the volume’s driver environment.

its("driver") { should eq "local" } 

mountpoint

The mountpoint property returns the value for the volume’s mount path.

its("mountpoint") { should eq "/var/home/core/.local/share/containers/storage/volumes/my_volume/_data" } 

created_at

The created_at property returns the creation date of the volume.

its("created_at") { should eq "2022-07-14T13:21:19.965421792+05:30" } 

labels

The labels property returns the labels associated with the volume.

its("labels") { should eq({}) } 

scope

The scope property returns the scope of the volume.

its("scope") { should eq "local" } 

options

The options property returns the options associated with the volume.

its("options") { should eq({}) } 

mount_count

The mount_count property returns the MountCount value from the volume’s inspect information.

its("mount_count") { should eq 0 } 

needs_copy_up

The needs_copy_up property returns the NeedsCopyUp value from the volume’s inspect information.

its("needs_copy_up") { should eq true } 

needs_chown

The needs_chown property returns the NeedsChown value from the volume’s inspect information.

its("needs_chown") { should eq true } 

Matchers

For a full list of available matchers, see our Universal Matchers page.

This resource has the following special matchers.

exist

The exist matcher tests if the volume is available on Podman.

it { should exist } 

Examples

Test if a volume exists on Podman and verifies volume properties

describe podman_volume("my_volume") do  it { should exist }  its("name") { should eq "my_volume" }  its("driver") { should eq "local" }  its("mountpoint") { should eq "/var/home/core/.local/share/containers/storage/volumes/my_volume/_data" }  its("created_at") { should eq "2022-07-14T13:21:19.965421792+05:30" }  its("labels") { should eq({}) }  its("scope") { should eq "local" }  its("options") { should eq({}) }  its("mount_count") { should eq 0 }  its("needs_copy_up") { should eq true }  its("needs_chown") { should eq true } end 

Thank you for your feedback!

×