Skip to main content

Resetting an OVHcloud Managed Kubernetes cluster

Stephanie R.
Updated

Learn how to reset your OVHcloud Managed Kubernetes cluster via the OVHcloud Control Panel and the API.

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.

MKS_clusterList.png

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

MKS_serviceTab.png

 

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.

MKS_serviceTab_resetCluster.PNG

 

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.

MKS_serviceTab_resetCluster_message.PNG

 

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

For more information and tutorials, please see our other Managed Kubernetes or Platform as a Service guides. You can also explore the guides for other OVHcloud products and services.

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.

Related articles