steampipe mod

Steampipe mod management.

Mods provide an easy way to share Steampipe queries, controls, and benchmarks. Find mods using the public registry at hub.steampipe.io.

Usage

steampipe mod [command]

Available Commands:

CommandDescription
initInitialize the current directory with a mod.sp file
installInstall one or more mods and their dependencies
listList currently installed mods
uninstallUninstall a mod and its dependencies
update Update one or more mods and their dependencies
FlagDescription
--dry-runShow which mods would be installed/updated/uninstalled without modifying them (default false).
--mod-locationSets the Steampipe workspace working directory. If not specified, the workspace directory will be set to the current working directory. See STEAMPIPE_MOD_LOCATION for details.
--pruneRemove unused mods and dependencies when doing mod update and mod install (default true).

Examples

List installed mods:

steampipe mod list

Install a mod and add the require statement to your mod.sp:

steampipe mod install github.com/turbot/steampipe-mod-aws-compliance

Install an exact version of a mod and update the require statement to your mod.sp. This may upgrade or downgrade the mod if it is already installed:

steampipe mod install github.com/turbot/steampipe-mod-aws-compliance@0.1

Install a version of a mod using a semver constraint and update the require statement to your mod.sp. This may upgrade or downgrade the mod if it is already installed:

steampipe mod install github.com/turbot/steampipe-mod-aws-compliance@'^1'

Install all mods specified in the mod.sp and their dependencies:

steampipe mod install

Preview what steampipe mod install will do, without actually installing anything:

steampipe mod install --dry-run

Update a mod to the latest version allowed by its current constraint:

steampipe mod update github.com/turbot/steampipe-mod-aws-compliance

Update all mods specified in the mod.sp and their dependencies to the latest versions that meet their constraints, and install any that are missing:

steampipe mod update

Uninstall a mod:

steampipe mod uninstall github.com/turbot/steampipe-mod-azure-compliance

Preview uninstalling a mod, but don't uninstall it:

steampipe mod uninstall github.com/turbot/steampipe-mod-gcp-compliance --dry-run