LightYear
/Docs
DocsComputeDeploy a Managed Kubernetes Cluster

Deploy a Managed Kubernetes Cluster

Provision a production-ready Kubernetes cluster on LightYear Cloud and deploy your first workload.

advanced
12 min read
LightYear Team
Updated April 24, 2026
kubernetesk8scontainersorchestration
Ready to get started?

Overview

LightYear Managed Kubernetes (LMK) provisions a fully managed control plane with worker nodes running on high-performance GPU or CPU instances.

Prerequisites

  • LightYear account with sufficient wallet balance
  • kubectl installed locally
  • helm installed locally (optional)

Step 1 — Create a Cluster

  1. Navigate to Kubernetes → Create Cluster.
  2. Choose a Kubernetes version (1.29 recommended).
  3. Select a region.
  4. Configure the node pool:
    • Node plan: vcpu-4-8gb (minimum) or GPU plan
    • Node count: 3 (for HA)
  5. Click Deploy Cluster.

Provisioning takes 3–5 minutes.

Step 2 — Download kubeconfig

>_BASH
$# From the cluster detail page, download kubeconfig.yaml
$export KUBECONFIG=~/kubeconfig.yaml
$kubectl get nodes

Expected output:

NAME STATUS ROLES AGE VERSION node-pool-1a Ready <none> 2m v1.29.2 node-pool-1b Ready <none> 2m v1.29.2 node-pool-1c Ready <none> 2m v1.29.2

Step 3 — Deploy a Sample Application

YAML
# nginx-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.25
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: nginx-lb
spec:
  type: LoadBalancer
  selector:
    app: nginx
  ports:
  - port: 80
    targetPort: 80
>_BASH
$kubectl apply -f nginx-deployment.yaml
$kubectl get svc nginx-lb

Step 4 — GPU Workloads on Kubernetes

Install the NVIDIA device plugin:

>_BASH
$kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/v0.14.3/nvidia-device-plugin.yml

Request GPU in your pod spec:

YAML
resources:
  limits:
    nvidia.com/gpu: 1

Scaling Node Pools

>_BASH
$# Scale via control panel: Kubernetes → [Cluster] → Node Pools → Edit

Upgrading Kubernetes

LightYear supports in-place minor version upgrades. Go to Kubernetes → [Cluster] → Upgrade.

Was this article helpful?

Your cookie choices for this website

This site uses cookies and related technologies, as described in our privacy policy, for purposes that may include site operation, analytics, and enhanced user experience. You may choose to consent to our use of these technologies, or manage your own preferences. Cookie policy