Stay organized with collections
Save and categorize content based on your preferences.
Delete your stateless workloads using standard Kubernetes deletion
methodologies.
Before you begin
To run commands against the pre-configured bare metal Kubernetes cluster, make sure you have the
following resources:
Locate the Kubernetes cluster name, or ask your Platform
Administrator what the cluster name is.
Sign in and generate the
kubeconfig file for the Kubernetes cluster if you don't have one.
Use the kubeconfig path of the Kubernetes cluster to replace
CLUSTER_KUBECONFIG in these instructions.
To get the required permissions to delete stateless workloads, ask your
Organization IAM Admin to grant you the Namespace Admin role (namespace-admin)
in your project namespace.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis guide explains how to delete stateless workloads in a user cluster using standard Kubernetes deletion methods.\u003c/p\u003e\n"],["\u003cp\u003eYou must have the user cluster name and its kubeconfig file to perform the deletion operations.\u003c/p\u003e\n"],["\u003cp\u003eYou will need Namespace Admin permissions granted by your Organization IAM Admin to delete stateless workloads.\u003c/p\u003e\n"],["\u003cp\u003eTo delete a specific Deployment, you will use the \u003ccode\u003ekubectl delete deployment\u003c/code\u003e command, providing your cluster's kubeconfig and the deployment name.\u003c/p\u003e\n"]]],[],null,["# Delete stateless workloads\n\nDelete your stateless workloads using standard Kubernetes deletion\nmethodologies.\n\nBefore you begin\n----------------\n\nTo run commands against the pre-configured bare metal Kubernetes cluster, make sure you have the\nfollowing resources:\n\n1. Locate the Kubernetes cluster name, or ask your Platform\n Administrator what the cluster name is.\n\n2. [Sign in and generate](/distributed-cloud/hosted/docs/latest/appliance/application/ao-user/iam/sign-in#kubernetes-cluster-kubeconfig) the\n kubeconfig file for the Kubernetes cluster if you don't have one.\n\n3. Use the kubeconfig path of the Kubernetes cluster to replace\n \u003cvar translate=\"no\"\u003eCLUSTER_KUBECONFIG\u003c/var\u003e in these instructions.\n\nTo get the required permissions to delete stateless workloads, ask your\nOrganization IAM Admin to grant you the Namespace Admin role (`namespace-admin`)\nin your project namespace.\n\nDelete a deployment\n-------------------\n\nTo delete a `Deployment` object, run: \n\n kubectl --kubeconfig \u003cvar translate=\"no\"\u003eCLUSTER_KUBECONFIG\u003c/var\u003e \\\n -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \\\n delete deployment \u003cvar translate=\"no\"\u003eDEPLOYMENT_NAME\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eCLUSTER_KUBECONFIG\u003c/var\u003e: the kubeconfig file for the\n Kubernetes cluster.\n\n- \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e: the project namespace of the container\n workload.\n\n- \u003cvar translate=\"no\"\u003eDEPLOYMENT_NAME\u003c/var\u003e: the name of the deployment to\n delete."]]