Deployment Runbook

Overview

This runbook covers deploying Shinkansen Commerce to production using Kubernetes.

Pre-Deployment Checklist

• All tests passing
• Code reviewed and approved
• Migration scripts prepared
• Environment variables configured
• Database backups enabled
• Monitoring configured
• Rollback plan documented

Deployment Steps

1. Build Docker Images

make docker-build

2. Push to Registry

make docker-push

3. Apply Kubernetes Manifests

cd deploy/k8s
kubectl apply -f namespace.yaml
kubectl apply -f configmaps.yaml
kubectl apply -f secrets.yaml
kubectl apply -f services/
kubectl apply -f deployments/

4. Verify Deployment

kubectl get pods -n shinkansen
kubectl logs -f -n shinkansen -l app=gateway

Rolling Updates

Update Single Service

kubectl set image deployment/gateway \
  gateway=docker.io/afasari/gateway:v1.0.1 \
  -n shinkansen

Rollback if Issues

kubectl rollout undo deployment/gateway -n shinkansen

Monitoring After Deployment

Check Health

curl https://api.shinkansen.com/health

Check Logs

kubectl logs -f -n shinkansen --all-containers=true

Troubleshooting

Pods Not Starting

kubectl describe pod <pod-name> -n shinkansen

Services Not Accessible

kubectl get svc -n shinkansen
kubectl get ingress -n shinkansen

Rollback Procedure

Immediate Rollback

kubectl rollout undo deployment/gateway -n shinkansen

Full Rollback

kubectl delete -f deploy/k8s/
kubectl apply -f deploy/k8s/previous/