Skip to main content

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​