Delete stateful workloads

Delete your stateful workloads using standard Kubernetes deletion methodologies.

Before you begin

To complete the tasks in this document, you must request the necessary permissions and prepare your environment.

Request IAM roles

To create, delete, edit, or view stateful workloads in a Kubernetes cluster, ask your Organization IAM Admin to grant you the Namespace Admin (namespace-admin) role. This role is bound to your project namespace.

Prepare your environment

To run commands against the pre-configured bare metal Kubernetes cluster, make sure you have the following resources:

  1. Locate the Kubernetes cluster name, or ask your Platform Administrator what the cluster name is.

  2. Sign in and generate the kubeconfig file for the Kubernetes cluster if you don't have one.

  3. Use the kubeconfig path of the Kubernetes cluster to replace CLUSTER_KUBECONFIG in these instructions.

Delete a StatefulSet resource

Delete a StatefulSet resource if you no longer have a use for its associated stateful container workloads.

  1. To delete a StatefulSet resource, run:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
    -n NAMESPACE \
    delete statefulset STATEFULSET_NAME

    Replace the following:

    • CLUSTER_KUBECONFIG: the kubeconfig file for the Kubernetes cluster.

    • NAMESPACE: the project namespace of the container workload.

    • STATEFULSET_NAME: the name of the StatefulSet object to delete.

    When deleting a StatefulSet resource, all of its pods are also deleted. If you prefer to only delete the StatefulSet resource and not its pods, include the --cascade=orphan parameter.

  2. Delete the associated service:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
    delete service SERVICE_NAME

    Replace the following variables:

    • CLUSTER_KUBECONFIG: the kubeconfig file for the Kubernetes cluster.

    • SERVICE_NAME: the name of the Service object to delete.