Namespaces

The cluster has 31 namespaces spanning production applications, development environments, infrastructure services, and specialized workloads.

Namespace Inventory

Application Namespaces

NamespacePurposeEnvironmentsKey Services
stiqSTIQ SaaS platform (production)prodAPI, app, admin
stiq-devSTIQ developmentdevAPI, app, admin
stiq-stagingSTIQ stagingstagingAPI, app, admin
glamhubGlamHub content platform (production)prodAstro, Directus, Umami, N8N, Ollama, Qdrant
glamhub-devGlamHub developmentdevMirrors prod stack
corestationCoreStation fire dept SaaS (production)prodAPI, app, admin
corestation-devCoreStation developmentdevAPI, app, admin
corestation-stagingCoreStation stagingstagingAPI, app, admin
idpIDP identity platform (production)prodAPI, app
idp-devIDP developmentdevAPI, app
kelseyKelsey Farm Equipment (production)prodApp, API
aegisAegis VPN (production)prodVPN, API
aegis-devAegis VPN developmentdevVPN, API

Infrastructure Namespaces

NamespacePurposeKey Components
kube-systemCore K3s componentsTraefik, CoreDNS, metrics-server
kube-node-leaseNode heartbeat leasesLease objects
kube-publicPublic cluster infoConfigMaps
defaultDefault namespace(should be empty)
authentikSSO/OIDC providerAuthentik server, worker, Redis, PostgreSQL
vaultSecrets managementHashiCorp Vault
registryContainer registryHarbor core, database, Redis, Trivy
devtroncdCI/CD GitOps platformDevtron, ArgoCD, PostgreSQL
monitoringObservability stackPrometheus, Grafana, Loki, AlertManager
cert-managerTLS automationcert-manager controller, webhook, cainjector
longhorn-systemDistributed storageLonghorn manager, driver, UI
linkerdService meshLinkerd control plane, proxies

Specialized Namespaces

NamespacePurposeKey Components
ai-mlML/AI workloadsMLflow, Ollama
gpu-operatorGPU managementNVIDIA GPU Operator, device plugin
jupyterhubNotebook serverJupyterHub, user notebook pods
argoWorkflow orchestrationArgo Workflows controller, server
openfaasServerless functionsOpenFaaS gateway, controller
dataData servicesData processing pipelines
docsDocumentationDocumentation site hosting
sonarqubeCode qualitySonarQube server, database

Namespace Map

K3s Cluster (31 namespaces)
│
├── System (4)
│   ├── kube-system          (Traefik, CoreDNS, metrics)
│   ├── kube-node-lease      (node heartbeats)
│   ├── kube-public          (public config)
│   └── default              (unused)
│
├── Applications (13)
│   ├── stiq / stiq-dev / stiq-staging
│   ├── glamhub / glamhub-dev
│   ├── corestation / corestation-dev / corestation-staging
│   ├── idp / idp-dev
│   ├── kelsey
│   └── aegis / aegis-dev
│
├── Infrastructure (7)
│   ├── authentik            (SSO)
│   ├── vault                (secrets)
│   ├── registry             (Harbor)
│   ├── devtroncd            (CI/CD)
│   ├── monitoring           (Prometheus, Grafana, Loki)
│   ├── cert-manager         (TLS certs)
│   └── longhorn-system      (storage)
│
├── Platform Services (4)
│   ├── linkerd              (service mesh)
│   ├── argo                 (workflows)
│   ├── openfaas             (serverless)
│   └── sonarqube            (code quality)
│
└── Specialized (3)
    ├── ai-ml                (MLflow, Ollama)
    ├── gpu-operator         (NVIDIA)
    ├── jupyterhub           (notebooks)
    ├── data                 (data processing)
    └── docs                 (documentation)

Quick Commands

# List all namespaces
kubectl get namespaces

# Pods in a specific namespace
kubectl get pods -n stiq

# All resources in a namespace
kubectl get all -n glamhub

# Resource usage by namespace
kubectl top pods -n monitoring

# Create a new namespace
kubectl create namespace my-new-ns

# Set default namespace for kubectl
kubectl config set-context --current --namespace=stiq

Multi-Environment Pattern

Most applications follow a consistent multi-environment pattern:

EnvironmentNamespace SuffixDomain PatternPurpose
Production(none)app.domain.comLive traffic
Development-devdev-app.domain.comActive development
Staging-stagingstaging-app.domain.comPre-release validation

Example for STIQ:

  • stiq -> stiq.us, api.stiq.us, app.stiq.us, admin.stiq.us
  • stiq-dev -> dev.stiq.us, dev-api.stiq.us, dev-app.stiq.us, dev-admin.stiq.us
  • stiq-staging -> staging.stiq.us, staging-api.stiq.us, staging-app.stiq.us, staging-admin.stiq.us