clusterctl delete

The clusterctl delete command deletes the provider components from the management cluster.

The operation is designed to prevent accidental deletion of user created objects. For example:

clusterctl delete --infrastructure aws

Deletes the AWS infrastructure provider components, while preserving the namespace where the provider components are hosted and the provider’s CRDs.

Warning

KNOWN BUG:

Deleting an infrastructure component from a namespace that share the same prefix with other namespaces (e.g. foo and foo-bar) will result in erroneous deletion of cluster scoped objects such as ClusterRole and ClusterRoleBindings that share the same namespace prefix.

This is true if the prefix before a dash - is same. That is, namespaces such as foo and foobar are fine however namespaces such as foo and foo-bar are not.

For example,

Init an infrastructure provider in namespace foo and foo-bar.

clusterctl init --infrastructure aws --watching-namespace foo --target-namespace foo
clusterctl init --infrastructure aws --watching-namespace foo-bar --target-namespace foo-bar

Delete infrastructure components from namespace foo

clusterctl delete --infrastructure aws --namespace foo

ClusterRole and ClusterRoleBindings for both the namespaces are deleted.

See issue 3119 for more details.

If you want to delete all the providers in a single operation , you can use the --all flag.

clusterctl delete --all

The Cluster API Book

clusterctl delete