Deployment Procedures

Deployment and rollback procedures for production environments

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

Workflows

Configure deployment workflows

Troubleshooting

Debug deployment issues

Back to Overview

Return to CI/CD overview