Skip to content

Commit 3e6739c

Browse files
author
tcpdumpfbacke
committed
Proof duplication
1 parent 827f0ad commit 3e6739c

File tree

15 files changed

+8829
-1028
lines changed

15 files changed

+8829
-1028
lines changed

pages/public_cloud/containers_orchestration/managed_kubernetes/managing-nodes/guide.de-de.md

Lines changed: 673 additions & 74 deletions
Large diffs are not rendered by default.

pages/public_cloud/containers_orchestration/managed_kubernetes/managing-nodes/guide.en-asia.md

Lines changed: 673 additions & 74 deletions
Large diffs are not rendered by default.

pages/public_cloud/containers_orchestration/managed_kubernetes/managing-nodes/guide.en-au.md

Lines changed: 673 additions & 74 deletions
Large diffs are not rendered by default.

pages/public_cloud/containers_orchestration/managed_kubernetes/managing-nodes/guide.en-ca.md

Lines changed: 673 additions & 74 deletions
Large diffs are not rendered by default.

pages/public_cloud/containers_orchestration/managed_kubernetes/managing-nodes/guide.en-gb.md

Lines changed: 40 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
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
55
---
66

77
## Objective
@@ -10,27 +10,28 @@ The OVHcloud Managed Kubernetes service provides you with production-ready Kuber
1010

1111
This guide covers one of the first steps after ordering a cluster: managing nodes and node pools.
1212

13-
Depending on your preferred workflow, you can manage them through :
13+
Depending on your preferred workflow, you can manage them through:
1414

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`.
1818

1919
We will walk you through each method to help you efficiently scale and manage your Kubernetes infrastructure.
2020

2121
## Requirements
2222

23-
- An OVHcloud Managed Kubernetes cluster
23+
- You have an OVHcloud Managed Kubernetes cluster.
2424
- 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.
2525

26-
## Nodes and node pools
26+
### On nodes and node pools
2727

28+
> [!tabs]
2829
> Via the OVHcloud Control Panel
2930
>> In your OVHcloud Managed Kubernetes cluster, nodes are grouped in node pools (group of nodes sharing the same configuration).
3031
>>
3132
>> 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.
3233
>>
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).
3435
>>
3536
> Via the OVHcloud API
3637
>> 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
4546
>>
4647
>> 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.
4748
>>
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.
4950
>>
5051
>> After creation, the `desiredNodes`, `minNodes`, `maxNodes`, `autoscale` and `template` properties can also be edited at any time.
5152
>>
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.
5354
>>
5455
> Via the NodePools CRD
5556
>> 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
6162
6263
## Instructions
6364

64-
Before you start:
65-
65+
> [!tabs]
6666
> 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.
6868
>>
6969
>> ![Access to the administration UI](images/managing_nodes-01.png){.thumbnail}
7070
>>
@@ -76,19 +76,19 @@ Before you start:
7676
>>
7777
>> - **APIServer access**: You can add IPv4 ranges in order to restrict access to your cluster’s APIServer.
7878
>>
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 control plane.
8080
>>
8181
> 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.
8383
>>
8484
>> Log in to the API Explorer using your OVH NIC.
8585
>>
8686
>> ![Log in to the API Explorer](images/kubernetes-quickstart-api-ovh-com-001.png){.thumbnail}
8787
>>
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.
8989
>>
9090
> 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.
9292
>>
9393
>> 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.
9494
>>
@@ -206,16 +206,17 @@ Before you start:
206206
>>
207207
>> Be aware that `maxNodes` is set by default to 5 when `antiAffinity` is enabled.
208208
>>
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).
210210
>> To customers developing they own autoscaling scripts, we strongly encourage you to define `minNodes` and `maxNodes`.
211211
>>
212212
213213
### Getting your cluster information
214214
215+
> [!tabs]
215216
> 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.
217218
>>
218-
>> ![cluster informations via the OVHcloud Control Panel](images/cluster_informations_manager.png)
219+
>> ![cluster information via the OVHcloud Control Panel](images/cluster_informations_manager.png)
219220
>>
220221
> Via the OVHcloud API
221222
>> 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:
266267
267268
### Listing node pools
268269
270+
> [!tabs]
269271
> 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}.
271273
>>
272274
>> ![List nodes pools via manager](images/list_node_pools_manager.png){.thumbnail}
273275
>>
@@ -330,12 +332,13 @@ Before you start:
330332
331333
### Getting information on a node pool
332334
335+
> [!tabs]
333336
> 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}.
335338
>>
336339
>> ![List nodes pools](images/list_node_pools_manager.png){.thumbnail}
337340
>>
338-
>> You can also view the nodes that make up a node pool, by clicking on the `name of one of them`{.action}.
341+
>> You can also view the nodes that make up a node pool, by clicking on the name of one of them.
339342
>>
340343
> Via the OVHcloud API
341344
>> Use the `GET /cloud/project/{serviceName}/kube/{kubeId}/nodepool/{nodePoolId}` API endpoint to get information on a specific node pool:
@@ -386,7 +389,7 @@ Before you start:
386389
>> ```
387390
>>
388391
> Via the NodePools CRD
389-
>> Use this command :
392+
>> Use this command:
390393
>>
391394
>> ```bash
392395
>> kubectl get nodepool <nodepool-name> -o yaml
@@ -411,7 +414,7 @@ Before you start:
411414
>>
412415
>> > [!primary]
413416
>> >
414-
>> > To learn more about the flavors of the current OVHcloud range, [refer to this page](https://www.ovhcloud.com/en-gb/public-cloud/prices/).
417+
>> > To learn more about the flavors of the current OVHcloud range, [refer to this page](/links/public-cloud/public-cloud).
415418
>> >
416419
>>
417420
> Via the OVHcloud API
@@ -507,7 +510,7 @@ Before you start:
507510
>>
508511
>> > [!primary]
509512
>> >
510-
>> > `antiAffinity`, `flavor` and `name` fields will not be editable after creation.
513+
>> > `antiAffinity`, `flavor` and `name` fields will not be editable after creation.
511514
>> > You cannot change the `monthlyBilled` field from true to false.
512515
>>
513516
>> Then apply it to your cluster:
@@ -540,6 +543,7 @@ Before you start:
540543
541544
### Updating the node pool
542545
546+
> [!tabs]
543547
> Via the OVHcloud Control Panel
544548
>> #### Configuring a node pool
545549
>>
@@ -590,17 +594,19 @@ Before you start:
590594
>> > It is not possible to update/change the following parameters: `antiAffinity`, `flavorName` and `name`.
591595
>>
592596
> Via the NodePools CRD
593-
>> To upsize or downsize your node pool, you can simply edit the YAML file and re-apply it.
597+
>> To upsize or downsize your node pool, you can simply edit the YAML file and re-apply it.
594598
>> For example, raise the `desiredNodes` to 5 in `new-nodepool.yaml` and apply the file:
595599
>>
596600
>> ```console
597601
>> $ kubectl apply -f new-nodepool.yaml
598602
>> nodepool.kube.cloud.ovh.com/my-new-node-pool configured
603+
>> ```
599604
>>
600605
>> > [!primary]
601606
>> >
602607
>> > `antiaffinity`, `flavor` and `name` fields can't be edited.
603608
>>
609+
>> ```console
604610
>> $ kubectl get nodepools
605611
>> NAME FLAVOR AUTOSCALED MONTHLY BILLED ANTIAFFINITY DESIRED CURRENT UP-TO-DATE AVAILABLE MIN MAX AGE
606612
>> my-new-node-pool b2-7 false false false 5 3 3 0 100 3s
@@ -651,6 +657,7 @@ Before you start:
651657
652658
### Deleting a node pool
653659
660+
> [!tabs]
654661
> Via the OVHcloud Control Panel
655662
>> In the *Node pools* tab, click on the `...`{.action} button in the row of the node pool concerned, then select `Delete pool`{.action}.
656663
>>
@@ -680,10 +687,10 @@ Before you start:
680687
681688
## Go further
682689
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).
684691
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).
686693
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 for assisting 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 for a custom analysis of your project.
688695
689-
- Join our community of users on <https://community.ovh.com/en/>.
696+
Join our [community of users](/links/community).

0 commit comments

Comments
 (0)