`destroy`

Remove all previously applied resources in a package from the cluster

destroy removes all files belonging to a package from the cluster.

Synopsis #

$$kpt live destroy [PKG_PATH | -]$$

Args #

$$PKG_PATH | -: Path to the local package which should be deleted from the cluster. It must contain a Kptfile or a ResourceGroup manifest with inventory metadata. Defaults to the current working directory. Using '-' as the package path will cause kpt to read resources from stdin.$$

Flags #

$$--dry-run: It true, kpt will print the resources that will be removed from the cluster, but no resources will be deleted. --inventory-policy: Determines how to handle overlaps between the package being currently applied and existing resources in the cluster. The available options are: * strict: If any of the resources already exist in the cluster, but doesn't belong to the current package, it is considered an error. * adopt: If a resource already exist in the cluster, but belongs to a different package, it is considered an error. Resources that doesn't belong to other packages are adopted into the current package. The default value is `strict`. --output: Determines the output format for the status information. Must be one of the following: * events: The output will be a list of the status events as they become available. * json: The output will be a list of the status events as they become available, each formatted as a json object. * table: The output will be presented as a table that will be updated inline as the status of resources become available. The default value is ‘events’. --show-status-events: The output will include the details on the reconciliation status for all resources. Default is `false`. Does not apply for the `table` output format.$$

Examples #

# remove all resources in the current package from the cluster.
$ kpt live destroy
Last modified June 16, 2025: Move docs to hugo (#4215) (2f0d4026)