Single-Node Kubernetes Setup

This guide provides instructions for setting up a single-node Kubernetes cluster using k3s.

Prerequisites

Hardware Requirements

• 4 Cores

• 16 GB RAM

• 50GB disk space

• Static private IP address

Operating System Requirements

• Any Linux distribution with systemd

Installation

1. Install k3s

# Install k3s
curl -sfL https://get.k3s.io | sh -

# Wait for service
sudo systemctl status k3s

2. Configure Access

# Set KUBECONFIG
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
sudo chmod 644 /etc/rancher/k3s/k3s.yaml

# Verify access
kubectl get nodes

Deploy Observo Site

1. Get Configuration

1. Access Observo dashboard

2. Navigate to Settings → Sites

3. Download helm configuration file

2. Modify Configuration

Update the following in your helm values file:

global:
  pushSource:
    loadBalancerEnabled: false
  
metrics-server:
  enabled: false

3. Deploy Site

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.12.0/cert-manager.crds.yaml
helm upgrade --install -n observo-client observo-site \
    oci://public.ecr.aws/e4z0a1h1/observo-site \
    --create-namespace \
    --values=/path/to/downloaded_config.yaml

Configure Host Access

1. Install nginx

sudo apt install nginx-full
sudo apt install nginx-extras

2. Get Service IP

# Get data-plane service IP
kubectl get services -n observo-client data-plane-gateway-service

3. Configure nginx

# Create stream configuration directory
sudo mkdir -p /etc/nginx/conf.d/stream

# Create configuration file
sudo tee /etc/nginx/conf.d/stream/tcp-proxy.conf << 'EOF'
stream {
    map $server_port $destination_port {
        default 10001; 
        ~^(\d+)$ $1; 
    }

    server {
        listen 10001-10050;
        proxy_pass <data-plane-gateway-service-cluster-ip>:$destination_port;
        proxy_connect_timeout 1s;
    }
} 
EOF

4. Update nginx Configuration

# Edit main nginx configuration
sudo tee -a /etc/nginx/nginx.conf << 'EOF'
include /etc/nginx/conf.d/stream/*.conf;
EOF

# Restart nginx
sudo systemctl restart nginx

Verify Installation

1. Check Components

# Check pods
kubectl get pods -n observo-client

# Check services
kubectl get svc -n observo-client

2. Test Connectivity

# Test HTTP endpoint
curl -v http://localhost:10001/health

# Test UDP endpoint
nc -zu localhost 10001

Troubleshooting

Common Issues

Pod Startup Issues

# Check pod status
kubectl describe pod -n observo-client <pod-name>

# Check logs
kubectl logs -n observo-client <pod-name>

Network Issues

# Check nginx configuration
sudo nginx -t

# Check nginx logs
sudo tail -f /var/log/nginx/error.log

Next Steps

• Multi-node setup

• Cleanup guide

Additional Resources

• Helm Values Reference