Skip to main content

Deployment Procedures

Environment Strategy

Development Staging Production

 Kustomize   Kustomize   Helm
   (dev)     (staging)  (release)

Development Deployment

Trigger: Automatic on push to develop branch (manual gate) Method: Kustomize with dev overlay
make deploy-dev
Configuration:
  • Namespace: mcp-server-langgraph-dev
  • Auth: inmemory (no Keycloak)
  • Sessions: memory (no Redis)
  • Replicas: 1
  • Resources: Low limits

Staging Deployment

Trigger: Manual deployment after dev validation Method: Kustomize with staging overlay
make deploy-staging
Configuration:
  • Namespace: staging-mcp-server-langgraph
  • Auth: keycloak
  • Sessions: redis (12-hour TTL)
  • Replicas: 2
  • Resources: Medium limits
  • Full observability enabled

Production Deployment

Trigger: Manual deployment with confirmation Method: Helm chart
make deploy-production
Configuration:
  • Namespace: mcp-server-langgraph
  • Auth: keycloak (SSL verified)
  • Sessions: redis (SSL enabled, 24-hour TTL)
  • Replicas: 3+ (HPA enabled)
  • Resources: Production limits
  • High availability configured
Safety Features:
  • 10-second confirmation delay
  • Health check validation
  • Rolling update strategy
  • Pod disruption budgets

Rollback Procedures

Quick Rollback Commands

Development:
make deploy-rollback-dev
Staging:
make deploy-rollback-staging
Production:
make deploy-rollback-production

Manual Rollback

Kubernetes Deployment:
## List rollout history
kubectl rollout history deployment/mcp-server-langgraph -n mcp-server-langgraph

## Rollback to previous version
kubectl rollout undo deployment/mcp-server-langgraph -n mcp-server-langgraph

## Rollback to specific revision
kubectl rollout undo deployment/mcp-server-langgraph -n mcp-server-langgraph --to-revision=3

## Monitor rollback
kubectl rollout status deployment/mcp-server-langgraph -n mcp-server-langgraph
Helm Rollback:
## List release history
helm history mcp-server-langgraph -n mcp-server-langgraph

## Rollback to previous release
helm rollback mcp-server-langgraph -n mcp-server-langgraph

## Rollback to specific revision
helm rollback mcp-server-langgraph 2 -n mcp-server-langgraph

Next Steps