Kubernetes Deployment

Scaffolds a Kubernetes deployment with raw manifests and an optional Helm chart. Includes Deployment, Service, and ConfigMap resources with production-grade defaults: resource limits, liveness and readiness probes, non-root security context, configurable replicas, and namespace awareness. Optionally adds Ingress, HorizontalPodAutoscaler, a Helm chart for parameterized deploys, and a GitHub Actions CI/CD workflow.

Name	`k8s-deploy`
Version	`0.1.0`
Category	infrastructure
License	Apache-2.0
Persona	engineering
Tags	kubernetes, k8s, deployment, helm, infrastructure
Source	`templates/k8s-deploy`

Render it

Three front doors, one catalog. Pick whichever suits the caller.

# CLI
npx @nanohype/sdk render k8s-deploy --out ./my-app

# SDK
import { LocalSource, renderTemplate } from "@nanohype/sdk";
const result = await renderTemplate(source, "k8s-deploy", variables);

# MCP — from an agent
get_template({ name: "k8s-deploy" })

Prerequisites

Tool	Version	Why
`kubectl`	—	Kubernetes CLI for applying manifests and managing clusters
`helm` (optional)	`>=3.0`	Helm CLI for chart-based deployments (only needed if Helm chart is included)

Variables

Required

ProjectName string: Kebab-case project name, used as resource names and labels Must be lowercase kebab-case starting with a letter.

Optional

Description string — defaults to Kubernetes deployment: Short project description for README and chart metadata
Namespace string — defaults to default: Kubernetes namespace for all resources
Replicas string — defaults to 2: Number of pod replicas
IncludeIngress bool — defaults to true: Include Ingress resource for external HTTP routing
IncludeHpa bool — defaults to true: Include HorizontalPodAutoscaler for auto-scaling
IncludeHelm bool — defaults to true: Include Helm chart for parameterized deployments
IncludeCi bool — defaults to true: Include GitHub Actions deploy workflow

What it produces

19 files. Placeholder names such as __APP_NAME__ are what the renderer substitutes into.

.env.example
.github/workflows/deploy.yml
.gitignore
chart/Chart.yaml
chart/templates/_helpers.tpl
chart/templates/configmap.yaml
chart/templates/deployment.yaml
chart/templates/hpa.yaml
chart/templates/ingress.yaml
chart/templates/service.yaml
chart/templates/serviceaccount.yaml
chart/values.yaml
k8s/configmap.yaml
k8s/deployment.yaml
k8s/hpa.yaml
k8s/ingress.yaml
k8s/namespace.yaml
k8s/service.yaml
README.md

Composes with

Pairs with go-service
Pairs with ts-service
Pairs with go-cli
Nests inside monorepo

Composites that use it

AI Chatbot — Full-stack AI chatbot with agentic loop, HTTP service, authentication, evaluation harness, and deployment..
AI Web Application — Full-stack web application with Next.js frontend, RAG pipeline, authentication, database, and deployment..
Background Processor — Async job processing service with queue, database, storage, observability, and deployment.
Document Intelligence — Document search and question-answering system with RAG pipeline, HTTP service, file storage, database, and deployment..
Enterprise AI Infrastructure — Full enterprise AI stack with agents, tool servers, safety guardrails, evaluation, prompt management, observability, and Kubernetes deployment..
Go Microservice — Go HTTP service with observability and deployment.
Identity-Aware Spring Boot Microservice — Spring Boot 4 microservice on JDK 25 with identity enforced at both the service-mesh edge (Istio RequestAuthentication + AuthorizationPolicy) and the application boundary (Spring Security OAuth 2.0 resource server) — defense in depth against the same OIDC issuer.
Internal Tool — CLI tool or browser extension backed by MCP servers for internal team use..
Multi-Agent System — Multi-agent architecture with A2A protocol peers, MCP tool servers, and an orchestrating agent.
Production API Service — Production-grade TypeScript API service with auth, database, caching, rate limiting, background jobs, observability, and deployment..
RAG-Powered Agent — AI agent that uses retrieval-augmented generation as a tool.
Spring Boot Microservice — Java Spring Boot 4 HTTP service on JDK 25 with a Kubernetes deployment and an optional Grafana + Prometheus + Loki observability stack.