tommahs / tommahs/trinity-cache

Create deployment to host trinity-cache in Kubernetes

Open
#36 0 comments 0 reactions 1 assignee View on GitHub

@tommahs is already working on this.

Since Feb 22, 2026.

Dominant language
Go
Stars
0
Forks
0
Avg merge
1m
Merged PRs (30d)
3

Description

Create a production-grade Kubernetes deployment for Trinity Cache that enables scalable, secure, and observable operation across environments (dev → staging → production).

This issue proposes designing and implementing Kubernetes manifests / Helm chart (or equivalent) covering deployment, configuration, networking, persistence, autoscaling, and operational concerns.

🎯 Goals

  • Provide a fully production-ready Kubernetes setup
  • Support horizontal scalability and high availability
  • Ensure secure configuration management
  • Enable observability and operational readiness
  • Allow environment-specific configuration
  • Offer simple install + upgrade workflow

❌ Non-goals

  • Kubernetes operator (initially)
  • Multi-cluster federation
  • Deep cloud-provider-specific infrastructure automation

🧱 Proposed Architecture
Workload

  • Deployment or StatefulSet (depending on persistence requirements)
  • Rolling updates with zero downtime
  • Resource requests/limits tuned for cache workload

Networking

  • ClusterIP service
  • Optional ingress support
  • TLS termination strategy (ingress or sidecar)

Configuration

  • ConfigMaps for non-sensitive config
  • Secrets for credentials
  • Environment-based overrides
  • Persistence (if required)
  • PVC support with configurable storage class
  • Backup strategy defined

Scaling

  • Horizontal Pod Autoscaler (CPU/memory or custom metrics)
  • Pod disruption budget

Security

  • Non-root container
  • Pod security context
  • Network policies
  • Secret management patterns

Observability

  • Liveness & readiness probes
  • Metrics endpoint integration
  • Prometheus annotations
  • Structured logging
  • Tracing hooks (optional)
Implementation Options (to discuss)
  • Helm chart (recommended)
  • Kustomize overlays
  • Raw manifests
  • Hybrid Helm + Kustomize
Acceptance Criteria
  • Helm chart or equivalent deployment artifacts
  • Example values for dev/staging/prod
  • Horizontal scaling verified
  • Rolling upgrade tested
  • Resource limits documented
  • Security best practices applied
  • Metrics and probes implemented
  • CI workflow validating manifests
  • Documentation added to README
Testing Strategy
  • Kind or k3d integration test
  • Upgrade test (N → N+1)
  • Failure injection (pod kill / node drain)
  • Load testing with realistic cache traffic
Documentation Requirements
  • Quick start install guide
  • Production tuning guide
  • Scaling recommendations
  • Observability setup
  • Backup/restore (if persistence exists)
  • Troubleshooting section
Future Enhancements
  • Kubernetes operator
  • Service mesh integration
  • Multi-region active-active
  • Advanced autoscaling (KEDA)
  • Chaos testing automation

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.