Kubernetes Web Application

This example demonstrates how to deploy a complete web application to Kubernetes using Conjure's k8s-web-app bundle from the conjure-get-started repository. The bundle generates Deployment, Service, and Ingress manifests configured for your application.

The k8s-web-app bundle provides:

• Deployment - Manages pod replicas with resource limits and health checks
• Service - Exposes the application within the cluster
• Ingress - Configures external access with optional TLS

• Kubernetes cluster (local or cloud)
• kubectl configured to access your cluster
• Conjure installed

Create .conjure.yaml in your project directory:

bundles_source: remote
bundles_remote_url: https://raw.githubusercontent.com/WizardOpsTech/conjure-get-started/master
templates_source: remote
templates_remote_url: https://raw.githubusercontent.com/WizardOpsTech/conjure-get-started/master

Note

Using the remote repository means you don't need to maintain bundle files locally. Conjure will download and cache them automatically.

List available bundles from the remote repository:

conjure list bundles --config .conjure.yaml

You should see the k8s-web-app bundle listed:

Available Bundles:

  k8s-web-app
    Description: Complete Kubernetes web application with Deployment, Service, and Ingress
    Type: kubernetes
    Latest: 1.0.0

Create a values file for rapid development iteration.

Create values-dev.yaml:

# Development configuration
app_name: myapp
namespace: dev
image: myapp:dev

template_overrides:
  deployment.yaml.tmpl:
    replicas: 1
    container_port: 8080
    cpu_request: 50m
    cpu_limit: 200m
    memory_request: 64Mi
    memory_limit: 256Mi

  service.yaml.tmpl:
    service_type: ClusterIP
    service_port: 8080
    cotnainer_port: 8080

  ingress.yaml.tmpl:
    hostname: myapp.dev.local
    enable_tls: false
    tls_secret_name: myapp-staging-tls 

Generate and deploy:

# Generate manifests
conjure bundle k8s-web-app \
  --config .conjure.yaml \
  -o ./manifests \
  -f values-dev.yaml

# Create namespace if it doesn't exist
kubectl create namespace dev --dry-run=client -o yaml | kubectl apply -f -

# Deploy to Kubernetes
kubectl apply -f ./manifests/ --namespace=dev

# Verify deployment
kubectl get all --namespace=dev
kubectl rollout status deployment/myapp --namespace=dev

Create a production-ready configuration with high availability and resource guarantees.

Create values-production.yaml:

# Production configuration
app_name: myapp
namespace: production
image: ghcr.io/myorg/myapp:1.0.0

template_overrides:
  deployment.yaml.tmpl:
    replicas: 10
    container_port: 8080
    cpu_request: 500m
    cpu_limit: 2000m
    memory_request: 1Gi
    memory_limit: 4Gi

  service.yaml.tmpl:
    service_type: LoadBalancer
    service_port: 80
    container_port: 8080

  ingress.yaml.tmpl:
    hostname: myapp.example.com
    enable_tls: true
    tls_secret_name: myapp-production-tls

Generate and deploy:

# Generate manifests
conjure bundle k8s-web-app \
  --config .conjure.yaml \
  -o ./manifests \
  -f values-production.yaml

# Review manifests before deploying
cat ./manifests/*.yaml

# Create namespace
kubectl create namespace production --dry-run=client -o yaml | kubectl apply -f -

# Deploy to Kubernetes
kubectl apply -f ./manifests/ --namespace=production

# Monitor rollout
kubectl rollout status deployment/myapp --namespace=production --timeout=10m

# Verify service
kubectl get service myapp --namespace=production
kubectl get ingress myapp --namespace=production

Manage multiple environments using different values files.

Project structure:

my-app/
├── .conjure.yaml
└── environments/
    ├── dev.yaml
    ├── staging.yaml
    └── production.yaml

Override specific values using --var flags:

conjure bundle k8s-web-app \
  --config .conjure.yaml \
  -o ./manifests \
  -f values-production.yaml \
  --var "replicas=15" \
  --var "image=ghcr.io/myorg/myapp:1.1.0" \

template_overirdes: is used to define specific values for specific templates in a bundle. Anything in a values file outside of tempaltes_values: is considered a shared value common to all templates in a bundle. Use template_overrides in values files to configure individual templates:

app_name: myapp
namespace: production
image: myapp:1.0.0

template_overrides:
  deployment.yaml.tmpl:
    replicas: 5
    container_port: 3000
    cpu_limit: 1000m

  service.yaml.tmpl:
    service_type: LoadBalancer
    service_port: 443
    container_porT: 8081

  ingress.yaml.tmpl:
    hostname: myapp.example.com
    enable_tls: true
    tls_secret_name: myapp-tls

Update the image version and redeploy:

# Update image in values file or use --var
conjure bundle k8s-web-app \
  --config .conjure.yaml \
  -o ./manifests \
  -f values-production.yaml \
  --var "image=ghcr.io/myorg/myapp:1.1.0" \

# Apply changes
kubectl apply -f ./manifests/ --namespace=production

# Watch rollout
kubectl rollout status deployment/myapp --namespace=production