Skip to content

Commit 8beb386

Browse files
committed
Main guide proofreading + Reducing images size
1 parent 3ca2670 commit 8beb386

File tree

9 files changed

+57
-96
lines changed

9 files changed

+57
-96
lines changed

pages/public_cloud/containers_orchestration/managed_kubernetes/premium/guide.en-gb.md

Lines changed: 57 additions & 96 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: MKS Premium Plan Beta
2+
title: MKS Premium Plan
33
excerpt: 'Features and limitations of the MKS Premium Plan in Beta version'
4-
updated: 2025-04-29
4+
updated: 2025-04-30
55
---
66

77
<style>
@@ -26,7 +26,7 @@ updated: 2025-04-29
2626
</style>
2727

2828
> [!primary]
29-
> This document describes the features and 'how-to' for the Managed Kubernetes Service Premium Plan currently in beta version. For additional details on the Managed Kubernetes Service Standard plan, refer to the [following documentation](/pages/public_cloud/containers_orchestration/managed_kubernetes/known-limits).
29+
> This document describes the features and "how-to" for the Managed Kubernetes Service Premium Plan currently in beta version. For additional details on the Managed Kubernetes Service Standard plan, refer to the [following documentation](/pages/public_cloud/containers_orchestration/managed_kubernetes/known-limits).
3030
3131
## Standard vs Premium comparison
3232

@@ -42,7 +42,7 @@ updated: 2025-04-29
4242

4343
In order to help you make the best use of our new Managed Kubernetes Service (MKS) Premium Plan, we have listed some limitations and guidelines related to specific features.
4444

45-
This list is subject to change as new features will be introduced during the Beta period, planned for the end of summer 2025.
45+
This list is subject to change as new features will be introduced during the Beta period. The end of the Beta phase and General Availability are planned for the end of summer 2025.
4646

4747
### Cluster upgrade
4848

@@ -69,7 +69,7 @@ The configuration of the [API server admission plugins](/pages/public_cloud/cont
6969
To enable IP filtering on the API server, the IP of the gateway in the cluster's OpenStack subnet should be specified.
7070
This allows worker nodes to communicate with the API server.
7171

72-
Retrieve the gateway IP of your cluster's gateway in the Manager, or by using the following command:
72+
Retrieve the gateway IP of your cluster's gateway in the [OVHcloud Control Panel](/links/manager), or by using the following command:
7373

7474
```bash
7575
openstack router show ROUTER_ID -c external_gateway_info
@@ -81,12 +81,10 @@ Changing the Security Policy after the cluster creation is not supported yet.
8181

8282
### Anti-affinity
8383

84-
8584
This feature allows worker nodes to be deployed on different hypervisors (physical servers) within the same availability zone, guaranteeing better fault tolerance. It is currently supported on the MKS Premium Plan (region EU-WEST-PAR).
8685

8786
We recommend using multiple Availability Zones (AZs) instead by using node pool to spread worker nodes between AZ.
8887

89-
9088
### Ports
9189

9290
The OpenStack security group for worker nodes is the `default` one. It allows all egress and ingress traffic by default on your private network.
@@ -114,79 +112,110 @@ The following ranges are used by the cluster, and should not be used elsewhere o
114112
10.3.0.0/16 # Subnet used by services
115113
```
116114

117-
118115
These ranges will be configurable in a future version.
119116

120117
## Getting started
121118

122119
### Prerequisites
123120

124-
To create a MKS Premium cluster a private network and subnet with an attached [OVHcloud Gateway](/links/public-cloud/gateway) (an OpenStack router) is mandatory. Before starting the cluster creation process, please make sure that you have an existing subnet that meets these requirements or create a new one accordingly.
121+
To create an MKS Premium cluster, a private network and subnet with an attached [OVHcloud Gateway](/links/public-cloud/gateway) (an OpenStack router) is mandatory. Before starting the cluster creation process, please make sure that you have an existing subnet that meets these requirements or create a new one accordingly.
122+
123+
If you want to use an use an existing subnet:
125124

126-
If you want to use an use an existing subnet, if :
127-
- **The Subnet's GatewayIP is already used by an OVHcloud Gateway**, nothing needs to be done. The current OVHcloud Gateway (OpenStack Router) will be used.
128-
- **The subnet does not have an IP reserved for a Gateway**, you will have to provide or create a compatible subnet. Three options are available:
129-
- Edit an existing subnet to reserve an IP for a Gateway : please refer to the [Update a subnet properties](/pages/public_cloud/public_cloud_network_services/configuration-04-update_subnet) documentation and then create a gateway ([Creating a private network with Gateway](/links/public-cloud/gateway))
125+
- **If the Subnet's GatewayIP is already used by an OVHcloud Gateway**, nothing needs to be done. The current OVHcloud Gateway (OpenStack Router) will be used.
126+
- **If the subnet does not have an IP reserved for a Gateway**, you will have to provide or create a compatible subnet. Two options are available:
127+
- Edit an existing subnet to reserve an IP for a Gateway: please refer to the [Update a subnet properties](/pages/public_cloud/public_cloud_network_services/configuration-04-update_subnet) documentation, then create a gateway ([Creating a private network with Gateway](/links/public-cloud/gateway))
130128
- Provide another compatible subnet: a subnet with an existing OVHcloud Gateway ([Creating a private network with Gateway](/links/public-cloud/gateway))
131-
- **The GatewayIP is already assigned to a non-OVHcloud Gateway (OpenStack Router)**.
129+
- **If the GatewayIP is already assigned to a non-OVHcloud Gateway (OpenStack Router)**.
132130
- Provide another compatible subnet: a subnet with an existing OVHcloud Gateway ([Creating a private network with Gateway](/links/public-cloud/gateway))
133-
134-
>[!primary]
131+
132+
> [!primary]
135133
> Please remember to avoid the MKS Reserved IP ranges (cf above) for your networkd CIDR
136134
137-
>[!primary]
138-
> Using the OVHcloud Control Panel, make sur to check the "Declare the first address of a CIDR given as the default gateway (DHCP option 3)" and "Assign a Gateway and connect to the private network" boxes at network creation
135+
> [!primary]
136+
> Using the OVHcloud Control Panel, make sure to check the `Declare the first address of a CIDR given as the default gateway (DHCP option 3)` and `Assign a Gateway and connect to the private network` boxes at network creation.
137+
>
139138
> ![network-creation](images/network-creation.png){.thumbnail}
139+
>
140140
141141
### Create a MKS Premium cluster
142+
142143
The following methods are supported to create an MKS Premium cluster:
143144

144145
> [!tabs]
145146
> Using the OVHcloud Control Panel
146147
>>
147-
>> Log in to the [OVHcloud Control Panel](/links/manager), go to the `Public Cloud`{.action} universe and select the Public Cloud project where you want to deploy the cluster.
148+
>> Log in to the [OVHcloud Control Panel](/links/manager), go to `Public Cloud`{.action} and select the Public Cloud project where you want to deploy the cluster.
148149
>>
149150
>> Access the OVHcloud Managed Kubernetes Service by clicking on `Managed Kubernetes Service`{.action} under Containers & Orchestration in the left-hand menu and click on `Create a cluster`{.action}.
151+
>>
150152
>> ![Create a cluster](images/creating-a-cluster1.png){.thumbnail}
151153
>>
152154
>> Enter a name for your cluster.
155+
>>
153156
>> ![Enter a name](images/creating-a-cluster2.png){.thumbnail}
154-
>> Select '3-AZ Region' as deployment mode
157+
>>
158+
>> Select '3-AZ Region' as deployment mode.
159+
>>
155160
>> ![Deployment mode](images/creating-a-cluster3.png){.thumbnail}
161+
>>
156162
>> Select 'Paris (EU-WEST-PAR)' as location.
163+
>>
157164
>> ![Location](images/creating-a-cluster4.png){.thumbnail}
158-
>> Select `Premium`{.action} plan and click Next.
165+
>>
166+
>> Select the `Premium`{.action} plan and click `Next`{.action}.
167+
>>
159168
>> ![Plan](images/creating-a-cluster5.png){.thumbnail}
169+
>>
160170
>> Choose the minor version of Kubernetes and the Security Policy.
171+
>>
161172
>> > [!primary]
162173
>> > We recommend to always use the lastest stable version.
163174
>> > Please read our [End of life / end of support](/pages/public_cloud/containers_orchestration/managed_kubernetes/eos-eol-policies) page to understand our version policy.
175+
>>
164176
>> ![Version](images/creating-a-cluster6.png){.thumbnail}
165-
>> >
177+
>>
166178
>> Select a private network for your cluster.
179+
>>
167180
>> ![Version](images/creating-a-cluster7.png){.thumbnail}
181+
>>
168182
>> Select a private subnet for your cluster.
183+
>>
169184
>> ![Version](images/creating-a-cluster8.png){.thumbnail}
185+
>>
170186
>> (Optional) Now you can configure your nodepools. A node pool is a group of nodes sharing the same configuration, allowing you a lot of flexibility in your cluster management. Enter a name and select the instance flavor.
187+
>>
171188
>> ![Version](images/creating-a-cluster9.png){.thumbnail}
189+
>>
172190
>> Select the Availability Zone for your node pool.
191+
>>
173192
>> ![Version](images/creating-a-cluster10.png){.thumbnail}
193+
>>
174194
>> Define the size of your first node pool.
195+
>>
175196
>> You can enable the `Autoscaling`{.action} feature for the cluster. Define the minimum and maximum pool size in that case.
197+
>>
176198
>> ![Version](images/creating-a-cluster12.png){.thumbnail}
177-
>> Click Add node pool.
199+
>>
200+
>> Click `Add node pool`{.action}.
201+
>>
178202
>> ![Version](images/creating-a-cluster13.png){.thumbnail}
179-
>> If you want to create a nodepool on each Availability Zone you can repeat this operation by click on 'Add node pool' again and change the AZ parameter.
203+
>>
204+
>> If you want to create a nodepool on each Availability Zone you can repeat this operation by clicking the `Add node pool`{.action} button again and changing the AZ parameter.
205+
>>
180206
>> Finally, click the `Confirm cluster`{.action} button.
207+
>>
181208
>> ![Version](images/creating-a-cluster14.png){.thumbnail}
209+
>>
182210
>> The cluster creation is now in progress. It should be available within a few minutes in your OVHcloud Control Panel.
183-
> Using terraform
211+
>>
212+
> Using Terraform
184213
>>
185214
>> Refer to the [dedicated documentation](/pages/public_cloud/containers_orchestration/managed_kubernetes/creating-a-cluster-through-terraform) to create a Managed Kubernetes cluster.
186215
>>
187-
>> Here is a sample terraform file that creates an MKS Premium cluster and three nodepools on three different availability zones in the `EU-WEST-PAR` region.
216+
>> Here is a sample Terraform file that creates an MKS Premium cluster and three nodepools on three different availability zones in the `EU-WEST-PAR` region.
188217
>>
189-
>> ```
218+
>> ```bash
190219
>> terraform {
191220
>> required_providers {
192221
>> ovh = {
@@ -238,78 +267,10 @@ The following methods are supported to create an MKS Premium cluster:
238267
>> value = ovh_cloud_project_kube.my_kube_cluster.kubeconfig
239268
>> sensitive = true
240269
>> }
241-
242270
>> ```
243271
244-
245-
## Getting started
246-
247-
The following methods are supported to create an MKS Premium cluster:
248-
249-
### Using Terraform
250-
251-
Refer to the [dedicated documentation](/pages/public_cloud/containers_orchestration/managed_kubernetes/creating-a-cluster-through-terraform) to create a Managed Kubernetes cluster.
252-
253-
Here is a sample Terraform file that creates an MKS Premium cluster and three nodepools on three different availability zones in the `EU-WEST-PAR` region.
254-
255-
```
256-
terraform {
257-
required_providers {
258-
ovh = {
259-
source = "ovh/ovh"
260-
}
261-
}
262-
}
263-
264-
provider "ovh" {
265-
endpoint = "ovh-eu"
266-
application_key = "<your_access_key>"
267-
application_secret = "<your_application_secret>"
268-
consumer_key = "<your_consumer_key>"
269-
}
270-
271-
resource "ovh_cloud_project_kube" "my_kube_cluster" {
272-
service_name = var.service_name
273-
name = "lgr-terraform-test-3az"
274-
region = "EU-WEST-PAR"
275-
version = "1.31"
276-
private_network_id = "<OpenStack Network Id>"
277-
nodes_subnet_id = "<Openstack Subnet Id>"
278-
}
279-
resource "ovh_cloud_project_kube_nodepool" "node_pool_a" {
280-
service_name = var.service_name
281-
kube_id = ovh_cloud_project_kube.my_kube_cluster.id
282-
name = "my-pool-a-1"
283-
flavor_name = "b3-8"
284-
availability_zones = ["eu-west-par-a"]
285-
desired_nodes = 1
286-
}
287-
resource "ovh_cloud_project_kube_nodepool" "node_pool_b" {
288-
service_name = var.service_name
289-
kube_id = ovh_cloud_project_kube.my_kube_cluster.id
290-
name = "my-pool-b-1"
291-
flavor_name = "b3-8"
292-
availability_zones = ["eu-west-par-b"]
293-
desired_nodes = 1
294-
}
295-
resource "ovh_cloud_project_kube_nodepool" "node_pool_c" {
296-
service_name = var.service_name
297-
kube_id = ovh_cloud_project_kube.my_kube_cluster.id
298-
name = "my-pool-c-1"
299-
flavor_name = "b3-8"
300-
availability_zones = ["eu-west-par-c"]
301-
desired_nodes = 1
302-
}
303-
output "kubeconfig_file" {
304-
value = ovh_cloud_project_kube.my_kube_cluster.kubeconfig
305-
sensitive = true
306-
}
307-
308-
```
309-
310-
311272
## Go further
312273
313274
- 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 assisting you on your specific use case of your project.
314275
315-
- Join our [community of users on Discord](https://discord.com/channels/850031577277792286/1366761790150541402)!
276+
- Join our [community of users on Discord](https://discord.gg/ovhcloud)!
52.1 KB
Loading
9.75 KB
Loading
92.2 KB
Loading
32.4 KB
Loading
51.2 KB
Loading
174 KB
Loading
140 KB
Loading
185 KB
Loading

0 commit comments

Comments
 (0)