Skip to content

Commit e6fb945

Browse files
authored
[Updated] Deploy a Linode Kubernetes Engine Cluster Using Terraform (#7281)
* [Updated] Deploy a Linode Kubernetes Engine Cluster Using Terraform * add region table for LKE Enterprise * copy edits, added data source info, relocated enterprise section * update enterprise k8s version value
1 parent 02dfc1f commit e6fb945

File tree

1 file changed

+66
-5
lines changed
  • docs/guides/kubernetes/deploy-lke-cluster-using-terraform

1 file changed

+66
-5
lines changed

docs/guides/kubernetes/deploy-lke-cluster-using-terraform/index.md

Lines changed: 66 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,17 @@ slug: deploy-lke-cluster-using-terraform
33
title: "Deploy a Linode Kubernetes Engine Cluster Using Terraform"
44
description: "In this tutorial, you'll deploy a Kubernetes cluster using the Linode Kubernetes Engine (LKE) and Terraform."
55
published: 2020-05-05
6-
modified: 2023-02-09
6+
modified: 2025-05-30
77
authors: ['Linode']
88
contributors: ['Linode']
99
license: "[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)"
1010
keywords: ['kubernetes','terraform','infrastructure as code','container orchestration']
1111
tags: ["linode platform","kubernetes","automation","managed hosting"]
1212
image: deploy-lke-cluster-with-terraform.png
1313
external_resources:
14+
- '[LKE Product Documentation](https://techdocs.akamai.com/cloud-computing/docs/linode-kubernetes-engine)'
15+
- '[LKE Enterprise Product Documentation](https://techdocs.akamai.com/cloud-computing/docs/lke-enterprise)'
1416
- '[Setting Up a Private Docker Registry with Linode Kubernetes Engine and Object Storage](/docs/guides/how-to-setup-a-private-docker-registry-with-lke-and-object-storage/)'
15-
- '[Deploying a Static Site on Linode Kubernetes Engine](/docs/guides/how-to-deploy-a-static-site-on-linode-kubernetes-engine/)'
1617
- '[Linode Provider Terraform Documentation](https://www.terraform.io/docs/providers/linode/index.html)'
1718
aliases: ['/kubernetes/how-to-deploy-an-lke-cluster-using-terraform/','/guides/how-to-deploy-an-lke-cluster-using-terraform/','/products/compute/kubernetes/guides/deploy-cluster-using-terraform/']
1819
---
@@ -202,8 +203,8 @@ You will now need to define the values you would like to use in order to create
202203
203204
```file {title="~/terraform/lke-cluster/terraform.tfvars"}
204205
label = "example-lke-cluster"
205-
k8s_version = "1.26"
206-
region = "us-west"
206+
k8s_version = "1.32"
207+
region = "us-central"
207208
pools = [
208209
{
209210
type : "g6-standard-2"
@@ -212,7 +213,67 @@ You will now need to define the values you would like to use in order to create
212213
]
213214
```
214215
215-
Terraform will use the values in this file to create a new Kubernetes cluster with one node pool that contains three 4 GB nodes. The cluster will be located in the `us-west` data center (Dallas, Texas, USA). Each node in the cluster's node pool will use Kubernetes version `1.25` and the cluster will be named `example-lke-cluster`. You can replace any of the values in this file with your own preferred cluster configurations.
216+
Terraform will use the values in this file to create a new Kubernetes cluster with one node pool that contains three 4 GB nodes. The cluster will be located in the `us-central` data center (Dallas, Texas, USA). Each node in the cluster's node pool will use Kubernetes version `1.32` and the cluster will be named `example-lke-cluster`. You can replace any of the values in this file with your own preferred cluster configurations.
217+
218+
### LKE Enterprise Clusters
219+
220+
[LKE Enterprise](https://techdocs.akamai.com/cloud-computing/docs/lke-enterprise) is Akamai's enterprise-grade managed Kubernetes offering and has a specific set of requirements and recommendations for successful deployment:
221+
222+
- **Plan type**: [Premium CPU](https://www.linode.com/pricing/#compute-premium) plans are highly recommended for LKE Enterprise clusters to accommodate production-level enterprise workloads that require high network performance.
223+
224+
- **Enterprise tier values**: To deploy an LKE Enterprise cluster using Terraform, you must use the `linode_lke_cluster` resource, a valid enterprise Kubernetes version (`k8s_version`), and the [`tier`](https://registry.terraform.io/providers/linode/linode/latest/docs/resources/lke_cluster) argument must be [assigned the value](#assign-values-to-your-input-variables) `"enterprise"`. For example:
225+
226+
```file
227+
resource "linode_lke_cluster" "{{< placeholder "test" >}}" {
228+
label = "lke-e-cluster"
229+
region = "us-lax"
230+
k8s_version = "v1.31.8+lke1"
231+
tags = ["{{< placeholder "test" >}}"]
232+
tier = "enterprise"
233+
234+
pool {
235+
type = "g7-premium-2"
236+
count = 3
237+
tags = ["{{< placeholder "test" >}}"]
238+
}
239+
}
240+
```
241+
Make sure to replace all {{< placeholder "test" >}} label values with your own.
242+
243+
To get a list of valid enterprise `k8s_version` values, specify the `enterprise` tier using the `linode_lke_versions` [data source](https://registry.terraform.io/providers/linode/linode/latest/docs/data-sources/lke_versions):
244+
245+
```command
246+
data "linode_lke_versions" "example_enterprise" {tier = "enterprise"}
247+
248+
output "example_enterprise_output" {
249+
value = data.linode_lke_versions.example_enterprise
250+
}
251+
252+
output "example_enterprise_output_first_version" {
253+
value = data.linode_lke_versions.example_enterprise.versions[0]
254+
}
255+
```
256+
257+
- **Availability**: As of this writing, LKE Enterprise is in limited availability and only deployable in the below regions:
258+
259+
| Region | Region ID |
260+
| -- | -- |
261+
| **Amsterdam, NL** | nl-ams |
262+
| **Chennai, IN** | in-maa |
263+
| **Chicago, IL** | us-ord |
264+
| **London, UK** | eu-west |
265+
| **Los Angeles, CA** | us-lax |
266+
| **Miami, FL** | us-mia |
267+
| **Milan, IT** | it-mil |
268+
| **Osaka, JP** | jp-osa |
269+
| **Paris, FR** | fr-par |
270+
| **São Paulo, BR** | br-gru |
271+
| **Seattle, WA** | us-sea |
272+
| **Singapore Expansion, SP** | sg-sin-2 |
273+
| **Stockholm, SE** | se-sto |
274+
| **Washington, DC** | us-iad |
275+
276+
A full list of regions and region IDs can be found on our [Availability](https://www.linode.com/global-infrastructure/availability/) page.
216277
217278
## Deploy your Kubernetes Cluster
218279

0 commit comments

Comments
 (0)