For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.us.ovhcloud.com/en/public-cloud/managed-kubernetes/reset-cluster.md.
  • English

Resetting an OVHcloud Managed Kubernetes cluster

View as Markdown

OVHcloud Managed Kubernetes service provides you with Kubernetes clusters without the hassle of installing or operating them.

During a reset, all data in the ETCD will be deleted (pods, deployments, services, secrets, CRDs, etc.). Similarly, load balancers and all PVCs (Persistent Volume Claim) with their PCI cinder volumes will be deleted. Nodes will be either deleted or reinstalled (depending on the option you set during the reset).

The whole cluster configuration is reset, but some values can be defined (optional):

  • workerNodesPolicy: reinstall|delete
  • minor_version: for ex. 1.25
  • updatePolicy: "ALWAYS_UPDATE" by default
  • customization: API Server & kube proxy configuration
  • privateNetworkId: private network openstack UUID
  • privateNetworkConfiguration: true|false
  • defaultVrackGateway: gateway IP
  • kubeProxyMode: ipvs|iptables

 

Requirements

 

Instructions

Reset a Kubernetes cluster on the OVHcloud Control Panel

Step 1 - Ask for cluster reset on the OVHcloud Control Panel

Log in to the OVHcloud Control Panel, go to the Public Cloud section, and select the Public Cloud project concerned.

Click Managed Kubernetes Service in the left-hand menu and select your Cluster's name.

List - Reset cluster

In the Service tab, click Reset your cluster in the Management panel.

Service tab - Reset cluster - step 2

 

Step 2 - Choose the type of reset you want

You have two options on the reset menu: Delete and Reinstall.

  • Choosing Delete nodes means that the current cluster nodes are deleted, and the cluster is reinitialized to an empty state.
  • Choosing Keep and reinstall nodes means that the cluster is reinitialized without destroying the nodes.

You can also choose the minor version of the cluster and the private network attached to it.

Click the Confirm button to continue.

Service tab - Reset cluster

 

Step 3 - Wait for the resetting to end

Depending on the chosen reset type, the process can take several minutes. During that time, a message in the OVHcloud Control Panel warns you that the cluster is resetting.

Service tab message

 

Reset a Kubernetes cluster through the API

Access the OVHcloud API

Log in to the OVHcloud API and navigate to the /kubernetes section.

If you go to the Kubernetes section of the API Explorer, you will see the available endpoints:

 

API endpoints

Input:

{
  "name": "my-test-cluster",
  "updatePolicy": "ALWAYS_UPDATE",
  "version": "1.34"
}

Result:

null

By default, if you don't specify it, the workerNodesPolicy option will be equivalent to delete. If you want your Nodes reinstalled, rather than deleted, you have to specify "workerNodesPolicy": "reinstall".

You should receive a response with null content. This message will be improved in the future with the same information you have after a Kubernetes cluster creation.

Result:

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
  "region": "US-EAST-VA-1",
  "name": "my-test-cluster",
  "url": "xxxxxx.c1.va1.k8s.ovh.us",
  "nodesUrl": "xxxxxx.nodes.c1.va1.k8s.ovh.us",
  "version": "1.34.2",
  "nextUpgradeVersions": [],
  "kubeProxyMode": "iptables",
  "customization": {
    "apiServer": {
      "admissionPlugins": {
        "enabled": [
          "AlwaysPullImages",
          "NodeRestriction"
        ],
        "disabled": []
      }
    }
  },
  "status": "REDEPLOYING",
  "updatePolicy": "ALWAYS_UPDATE",
  "isUpToDate": true,
  "controlPlaneIsUpToDate": true,
  "privateNetworkId": null,
  "createdAt": "2023-03-21T10:53:35Z",
  "updatedAt": "2023-03-22T09:16:34Z"
}

 

Go further

Browse all the Managed Kubernetes Service (MKS) guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Managed Kubernetes on the OVHcloud US website.

If you need training or technical assistance to implement our solutions, contact your sales representative or click on this link to get a quote and ask our Professional Services experts for a custom analysis of your project.