Skip to main content
Version: 4.1.0

How to Clean Up Storage Volumes

Storage volumes are sometimes left behind when compute instances are removed. Fix Inventory can find and delete these unused storage volumes.

Fix Inventory's cleanup-volumes infrastructure app can find and delete these orphaned storage volumes.

Prerequisites​

This guide assumes that you have already installed and configured Fix Inventory to collect your cloud resources.

Directions​

  1. Execute the following command in Fix Inventory Shell to open the Fix Inventory Worker configuration for editing:

    > config edit fix.worker
  2. Enable cleanup by modifying the fixworker section of the configuration as follows:

    fixworker:
    # Enable cleanup of resources
    cleanup: true
    # Do not actually cleanup resources, just create log messages
    cleanup_dry_run: false
    # How many cleanup threads to run in parallel
    cleanup_pool_size: 16

    When cleanup is enabled, marked resources will be deleted as a part of the collect_and_cleanup workflow, which runs each hour by default.

    tip

    Set cleanup_dry_run to true to simulate cleanup without actually deleting resources.

  3. Use the app install command to install the cleanup-volumes app:

    > app install cleanup-volumes
    info

    Fix Inventory will create a default config fix.apps.cleanup_volumes.

  4. Execute the following command in Fix Inventory Shell to open the infrastructure app configuration for editing:

    > config edit fix.apps.cleanup_volumes
  5. Update the configuration with the desired volume age threshold:

    cleanup_volumes configuration
    min_age: 14d
  6. Run the app using the app run command:

    > app run cleanup-volumes
    tip

    Add the optional --dry-run flag to see what commands the app would perform, without actually executing them.

  7. Create an event-based job to run the app automatically:

    > jobs create --name "Clean Up Storage Volumes" --wait-for-event cleanup_plan 'app run cleanup_volumes'
    info

    The cleanup-volumes infrastructure app will now run each time Fix Inventory emits the cleanup_plan event. The post_cleanup_plan event is emitted in the cleanup phase of the collect_and_cleanup workflow.

Each time the cleanup-volumes infrastructure app runs, unused storage volumes will be flagged for removal during the next cleanup run.

Further Reading​