You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/public_cloud/containers_orchestration/managed_kubernetes/managing-nodes/guide.en-gb.md
+40-33Lines changed: 40 additions & 33 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
-
title: Managing nodes and node pools
3
-
excerpt: 'Learn how to manage nodes and node pools in your Managed Kubernetes cluster using the OVHcloud Control Panel, the OVHcloud API, and the NodePools Custom Resource Definition (CRD)'
4
-
updated: 2025-05-02
2
+
title: How to manage nodes and node pools on an OVHcloud Managed Kubernetes cluster
3
+
excerpt: Learn how to manage nodes and node pools using the OVHcloud Control Panel, the OVHcloud API, and the NodePools Custom Resource Definition (CRD)
4
+
updated: 2025-05-27
5
5
---
6
6
7
7
## Objective
@@ -10,27 +10,28 @@ The OVHcloud Managed Kubernetes service provides you with production-ready Kuber
10
10
11
11
This guide covers one of the first steps after ordering a cluster: managing nodes and node pools.
12
12
13
-
Depending on your preferred workflow, you can manage them through:
13
+
Depending on your preferred workflow, you can manage them through:
14
14
15
-
- The [OVHcloud Control Panel](https://www.ovh.com/auth?onsuccess=https%3A%2F%2Fwww.ovh.com%2Fmanager%2Fpublic-cloud&ovhSubsidiary=gb)
16
-
- The [OVHcloud API](https://api.ovh.com/)
17
-
- The `NodePools` Custom Resource Definition (CRD) via `kubectl`
15
+
- The [OVHcloud Control Panel](/links/manager).
16
+
- The [OVHcloud API](/links/api).
17
+
- The `NodePools` Custom Resource Definition (CRD) via `kubectl`.
18
18
19
19
We will walk you through each method to help you efficiently scale and manage your Kubernetes infrastructure.
20
20
21
21
## Requirements
22
22
23
-
-An OVHcloud Managed Kubernetes cluster
23
+
-You have an OVHcloud Managed Kubernetes cluster.
24
24
- If you plan to manage node pools using the `NodePools` CRD, make sure you have the [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/){.external} command-line tool installed. You can find [detailed installation instructions](https://kubernetes.io/docs/tasks/tools/install-kubectl/){.external} on the official Kubernetes website.
25
25
26
-
##Nodes and node pools
26
+
### On nodes and node pools
27
27
28
+
> [!tabs]
28
29
> Via the OVHcloud Control Panel
29
30
>> In your OVHcloud Managed Kubernetes cluster, nodes are grouped in node pools (group of nodes sharing the same configuration).
30
31
>>
31
32
>> When you order a new cluster, it is created with a default node pool. Refer to our guide on [creating a cluster](/pages/public_cloud/containers_orchestration/managed_kubernetes/creating-a-cluster) for more information.
32
33
>>
33
-
>> In this guide we explain how to do some basic operations with nodes and node pools using the Public Cloud section of the [OVHcloud Control Panel](https://www.ovh.com/auth?onsuccess=https%3A%2F%2Fwww.ovh.com%2Fmanager%2Fpublic-cloud&ovhSubsidiary=gb).
34
+
>> In this guide we explain how to do some basic operations with nodes and node pools using the Public Cloud section of the [OVHcloud Control Panel](/links/manager).
34
35
>>
35
36
> Via the OVHcloud API
36
37
>> In your OVHcloud Managed Kubernetes cluster, nodes are grouped in node pools (group of nodes sharing the same configuration).
@@ -45,11 +46,11 @@ We will walk you through each method to help you efficiently scale and manage yo
45
46
>>
46
47
>> Setting the `template` property will allow you to define some specs (annotations, finalizers, labels, taints, schedulability) that will be applied to each node under this node pool.
47
48
>>
48
-
>> Finally `monthlyBilled` boolean ensures that all nodes in a node pool will be spawned in monthly billing mode and therefore benefit from the monthly discount.
49
+
>> Finally the boolean `monthlyBilled` ensures that all nodes in a node pool will be spawned in monthly billing mode and therefore benefit from the monthly discount.
49
50
>>
50
51
>> After creation, the `desiredNodes`, `minNodes`, `maxNodes`, `autoscale` and `template` properties can also be edited at any time.
51
52
>>
52
-
>> In this guide we explain how to do some basic operations with nodes and node pools using the [OVHcloud API](https://api.ovh.com/): adding nodes to an existing node pool, creating a new node pool, etc.
53
+
>> In this guide we explain how to do some basic operations with nodes and node pools using the [OVHcloud API](/links/manager): adding nodes to an existing node pool, creating a new node pool, etc.
53
54
>>
54
55
> Via the NodePools CRD
55
56
>> In your OVHcloud Managed Kubernetes cluster, nodes are grouped in node pools (group of nodes sharing the same configuration).
@@ -61,10 +62,9 @@ We will walk you through each method to help you efficiently scale and manage yo
61
62
62
63
## Instructions
63
64
64
-
Before you start:
65
-
65
+
> [!tabs]
66
66
> Via the OVHcloud Control Panel
67
-
>> Access our administration UI for your OVHcloud Managed Kubernetes clusters by clicking on `Managed Kubernetes Service`{.action} in the left-hand menu in the Public Cloud section of the [OVHcloud Control Panel](https://www.ovh.com/auth?onsuccess=https%3A%2F%2Fwww.ovh.com%2Fmanager%2Fpublic-cloud&ovhSubsidiary=gb). In the table, select a cluster by clicking on the cluster name.
67
+
>> Access our administration UI for your OVHcloud Managed Kubernetes clusters by clicking on `Managed Kubernetes Service`{.action} in the left-hand menu in the Public Cloud section of the [OVHcloud Control Panel](/links/manager). In the table, select a cluster by clicking on the cluster name.
68
68
>>
69
69
>> {.thumbnail}
70
70
>>
@@ -76,19 +76,19 @@ Before you start:
76
76
>>
77
77
>> -**APIServer access**: You can add IPv4 ranges in order to restrict access to your cluster’s APIServer.
78
78
>>
79
-
>> -**Audit Logs**: Here, you will find the logs for your Kubernetes cluster’s control-plane.
79
+
>> -**Audit Logs**: Here, you will find the logs for your Kubernetes cluster’s controlplane.
80
80
>>
81
81
> Via the OVHcloud API
82
-
>> To simplify things, we are using the [API Explorer](https://api.ovh.com/), which allows to explore, learn and interact with the API in an interactive way.
82
+
>> To simplify things, we are using the [API Explorer](/links/api), which allows to explore, learn and interact with the API in an interactive way.
83
83
>>
84
84
>> Log in to the API Explorer using your OVH NIC.
85
85
>>
86
86
>> {.thumbnail}
87
87
>>
88
-
>> If you go to the [Cloud section](https://api.ovh.com/console/#/cloud) of the API Explorer, you will see the available `/cloud/project/{serviceName}/kube` endpoint.
88
+
>> If you go to the [Cloud section of the API Explorer](/links/api), you will see the available `/cloud/project/{serviceName}/kube` endpoint.
89
89
>>
90
90
> Via the NodePools CRD
91
-
>> Kubernetes [Custom Resources](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) are extensions of the Kubernetes API. Like the default Kubernetes resources, the Custom Resources are endpoints in the Kubernetes API that store collections of API objects of a certain kind. Custom Resources allows to easily extend Kubernetes by adding new features and behaviors.
91
+
>> Kubernetes [Custom Resources](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) are extensions of the Kubernetes API. Like the default Kubernetes resources, the Custom Resources are endpoints in the Kubernetes API that store collections of API objects of a certain kind. Custom Resources allows to easily extend Kubernetes by adding new features and behaviors.
92
92
>>
93
93
>> The simplest way to add a Custom Resource to Kubernetes is to define a [`CustomResourceDefinition` (CRD)](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/#customresourcedefinitions) with the resource schema.
94
94
>>
@@ -206,16 +206,17 @@ Before you start:
206
206
>>
207
207
>> Be aware that `maxNodes` is set by default to 5 when `antiAffinity` is enabled.
208
208
>>
209
-
>> To configure cluster autoscaling based on node pools, follow documentations [Configuring the cluster autoscaler](/pages/public_cloud/containers_orchestration/managed_kubernetes/configuring-cluster-autoscaler) and [Cluster autoscaler example](/pages/public_cloud/containers_orchestration/managed_kubernetes/cluster-autoscaler-example).
209
+
>> To configure cluster autoscaling based on node pools, follow the documentation [Configuring the cluster autoscaler](/pages/public_cloud/containers_orchestration/managed_kubernetes/configuring-cluster-autoscaler) and [Cluster autoscaler example](/pages/public_cloud/containers_orchestration/managed_kubernetes/cluster-autoscaler-example).
210
210
>> To customers developing they own autoscaling scripts, we strongly encourage you to define `minNodes` and `maxNodes`.
211
211
>>
212
212
213
213
### Getting your cluster information
214
214
215
+
> [!tabs]
215
216
> Via the OVHcloud Control Panel
216
-
>> Go to your Public Cloud project in the OVHcloud Control Panel and click on the `Managed Kubernetes Service`{.action}, then click on the `name of the relevant cluster`{.action}.
217
+
>> Go to your Public Cloud project in the OVHcloud Control Panel and click on the `Managed Kubernetes Service`{.action}, then click on the name of the relevant cluster.
217
218
>>
218
-
>>
219
+
>>
219
220
>>
220
221
> Via the OVHcloud API
221
222
>> The `GET /cloud/project/{serviceName}/kube/{kubeId}` API endpoint provides important information about your OVHcloud Managed Kubernetes cluster, including its status and URL.
@@ -266,8 +267,9 @@ Before you start:
266
267
267
268
### Listing node pools
268
269
270
+
> [!tabs]
269
271
> Via the OVHcloud Control Panel
270
-
>> Go to your Public Cloud project in the OVHcloud Control Panel and click on the `Managed Kubernetes Service`{.action}, then click on the `name of the relevant cluster`{.action} and `Node pools`{.action}.
272
+
>> Go to your Public Cloud project in the OVHcloud Control Panel and click on the `Managed Kubernetes Service`{.action}, then click on the name of the relevant cluster and `Node pools`{.action}.
271
273
>>
272
274
>>{.thumbnail}
273
275
>>
@@ -330,12 +332,13 @@ Before you start:
330
332
331
333
### Getting information on a node pool
332
334
335
+
> [!tabs]
333
336
> Via the OVHcloud Control Panel
334
-
>> Go to your Public Cloud project in the OVHcloud Control Panel and click on the `Managed Kubernetes Service`{.action}, then click on the `name of the relevant cluster`{.action} and `Node pools`{.action}.
337
+
>> Go to your Public Cloud project in the OVHcloud Control Panel and click on the `Managed Kubernetes Service`{.action}, then click on the name of the relevant cluster and `Node pools`{.action}.
>> In the *Node pools* tab, click on the `...`{.action} button in the row of the node pool concerned, thenselect`Delete pool`{.action}.
656
663
>>
@@ -680,10 +687,10 @@ Before you start:
680
687
681
688
## Go further
682
689
683
-
To have an overview of OVHcloud Managed Kubernetes service, you can go to the [OVHcloud Managed Kubernetes page](https://www.ovhcloud.com/en-gb/public-cloud/kubernetes/).
690
+
To have an overview of the OVHcloud Managed Kubernetes service, visit the [OVHcloud Managed Kubernetes page](/links/public-cloud/kubernetes).
684
691
685
-
To deploy your first application on your Kubernetes cluster, we invite you to follow our guide to [configuring default settings for`kubectl`](/pages/public_cloud/containers_orchestration/managed_kubernetes/configuring-kubectl-on-an-ovh-managed-kubernetes-cluster) and [deploying a Hello World application](/pages/public_cloud/containers_orchestration/managed_kubernetes/deploying-hello-world).
692
+
To deploy your first application on your Kubernetes cluster, we invite you to follow our guides to [configure default settings for`kubectl`](/pages/public_cloud/containers_orchestration/managed_kubernetes/configuring-kubectl-on-an-ovh-managed-kubernetes-cluster) and to [deploy a Hello World application](/pages/public_cloud/containers_orchestration/managed_kubernetes/deploying-hello-world).
686
693
687
-
- If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/en-gb/professional-services/) to get a quote and ask our Professional Services experts forassisting you on your specific use case of your project.
694
+
If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts fora custom analysis of your project.
688
695
689
-
- Join our community of users on <https://community.ovh.com/en/>.
0 commit comments