Recipes list View as markdown
 Recipes list Markdown
"Hello World" Examples Kubernetes

Zerops k8s showcase

Run upstream Kubernetes inside a single Zerops project — nested kubeadm cluster, Calico CNI, Gateway API ingress, and profile-specific add-ons (Istio/Longhorn/Headlamp on Full, Traefik/Longhorn on Production, Traefik-only on Staging). Cluster lifecycle is driven by zerops-recipe-apps/zerops-k8s GitHub Actions after the project import.

Lightweight project core
Single dedicated container with balancers (L3/L7), logger and statistics services
k8scp1
Docker

Container

4Dedicated Cores

8 GBRAM

20 GBDisk (SSD)

k8sworker1
Docker

Container

4Dedicated Cores

8 GBRAM

50 GBDisk (SSD)

k8sworker2
Docker

Container

4Dedicated Cores

8 GBRAM

50 GBDisk (SSD)

k8sedge
Golang

Containers

1Shared Core

0.5 GBRAM

1 GBDisk (SSD)

k8sbackups
Object storage

External

25 GBSize

14Shared Cores

25 GBRAM

122 GBDisk (SSD)

25 GBObject storage

$95.85

Per month for
Resources cost
add
FreePer month for
Lightweight pkg.
Post-import deploymentAccessOperations

Post-import deployment

  1. Import one profile (creates Zerops services with startWithoutCode; no nested cluster yet).
  2. Fork or clone zerops-recipe-apps/zerops-k8s.
  3. Configure repository secrets and variables (ZEROPS_TOKEN, ZEROPS_PROJECT_ID, ZEROPS_CLIENT_ID, K8S_PROFILE, age backup keys for Full/Production).
  4. Run Deploy Zerops Kubernetes with the same profile as the import.

Access

Connect the Zerops VPN. The Kubernetes API, Headlamp (Full only), and demo ingress use a project-local VRRP VIP (https://<derived-vrrp-vip>:6443). Retrieve kubeconfig and Headlamp tokens from sensitive Zerops project variables after a successful deploy run — never from repository files.

Operations

Use the profile-aware workflows in the automation repo: maintenance, upgrade, resize, backup, restore drill, destroy. See docs/operations.md.

Related platform & services docs

PlatformRouting & Domains ScalingEnvironment VariablesCLI (zcli)
DockerTech overview Configuration Examples
GolangBuild & DeployCustomize Runtime

Related Recipes

More recipes with similar technologies and categories.

"Hello World" ExamplesGolang

Go Hello World

Go recipe for Zerops — a minimal HTTP server backed by PostgreSQL, showcasing idempotent database migrations, environment-variable-driven configuration, and the complete set of Zerops infrastructure patterns across six ready-to-deploy environment configurations.

"Hello World" ExamplesJava

Java Hello World

Java Hello World recipe running on Zerops, backed by a PostgreSQL database. Built with Spring Boot, the recipe demonstrates the full Zerops integration pattern: idempotent schema migration, database-backed health check, and ready-made environment configurations spanning the entire development lifecycle.

"Hello World" ExamplesSolid

SolidStart SSR Hello World

A server-rendered SolidStart application running on Zerops, backed by a PostgreSQL database. The app demonstrates SolidStart's Nitro-powered SSR pipeline — self-contained server bundle with idempotent database migrations on every deploy.

"Hello World" ExamplesAstro

Astro SSR Hello World

A minimal Astro SSR application with a server-rendered health check page that connects to a PostgreSQL database, runs idempotent migrations, and queries live data — demonstrating the full Zerops SSR integration pattern.