Files
skills/public/cicd-cd-deployment-patterns.html
zeekay 747dafba10 Register WebMCP tools on every page, and name each page's twin from site.py
Every page now loads /webmcp.js, scripts/webmcp.ts with its types
stripped (npm run webmcp). Where the browser has document.modelContext
it registers two read-only tools: search_skills over the published
skills index, and get_skill, which returns a skill's markdown checked
against the index digest. The markdown alternate link moves from
build.py to site.py, so CI holds every page to it.

The API catalog gains the site itself (llms.txt and the skills index)
and hanzo.ai/agents; the live discovery check now fetches every
catalog link. tests/site.mjs drives the tools through a recording
modelContext, and checks a browser without one loads clean.
2026-10-26 20:57:05 -07:00

813 lines
31 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>cicd-cd-deployment-patterns</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/cicd-cd-deployment-patterns">
<link rel="alternate" type="text/markdown" href="/cicd-cd-deployment-patterns.md">
<script type="module" src="/webmcp.js"></script>
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/cicd-cd-deployment-patterns.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>cicd-cd-deployment-patterns</h1><p class="lede">Implementing zero-downtime deployment strategies</p><h1>CD Deployment Patterns</h1>
<p><strong>Scope</strong>: Blue-green deployments, canary releases, rolling updates, rollback strategies, and environment promotion patterns</p>
<p><strong>Lines</strong>: 395</p>
<p><strong>Last Updated</strong>: 2025-10-18</p>
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
<hr>
<h2>When to Use This Skill</h2>
<p>Use this skill when:</p>
<ul><li>Implementing zero-downtime deployment strategies</li><li>Setting up blue-green or canary deployments</li><li>Configuring rolling updates for Kubernetes/container orchestration</li><li>Designing rollback mechanisms</li><li>Managing environment promotion (dev → staging → prod)</li><li>Implementing feature flags for gradual rollouts</li><li>Setting up deployment approvals and gates</li><li>Automating database migrations with deployments</li></ul>
<p>Don&#x27;t use this skill for:</p>
<ul><li>Basic workflow configuration (see <code>github-actions-workflows.md</code>)</li><li>Testing strategies (see <code>ci-testing-strategy.md</code>)</li><li>Pipeline optimization (see <code>ci-optimization.md</code>)</li></ul>
<hr>
<h2>Core Concepts</h2>
<h3>Deployment Strategies</h3>
<ol><li><strong>Blue-Green</strong>: Two identical environments, switch traffic atomically</li><li><strong>Canary</strong>: Gradual rollout to subset of users</li><li><strong>Rolling</strong>: Sequential update of instances</li><li><strong>Recreate</strong>: Stop old, start new (downtime acceptable)</li><li><strong>Shadow</strong>: Run new version alongside old without serving traffic</li></ol>
<h3>Risk vs Speed Trade-offs</h3>
<pre><code>Strategy | Speed | Safety | Complexity | Rollback Speed
──────────────|──────|───────|───────────|───────────────
Recreate | ★★★★ | ★ | ★ | ★★
Rolling | ★★★ | ★★ | ★★ | ★★
Blue-Green | ★★★★ | ★★★★ | ★★★ | ★★★★★
Canary | ★★ | ★★★★★ | ★★★★ | ★★★★</code></pre>
<hr>
<h2>Patterns</h2>
<h3>Blue-Green Deployment</h3>
<pre><code class="lang-yaml">name: Blue-Green Deploy
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
# Build new version
- name: Build Docker image
run: |
docker build -t myapp:${{ github.sha }} .
docker tag myapp:${{ github.sha }} myapp:green
# Deploy to green environment
- name: Deploy to green
run: |
# Deploy to inactive environment
kubectl apply -f k8s/deployment-green.yaml
kubectl set image deployment/myapp-green myapp=myapp:${{ github.sha }}
kubectl rollout status deployment/myapp-green
# Run smoke tests on green
- name: Smoke test green environment
run: |
./scripts/smoke-test.sh https://green.myapp.com
# Switch traffic to green
- name: Switch traffic
run: |
# Update service to point to green
kubectl patch service myapp -p &#x27;{&quot;spec&quot;:{&quot;selector&quot;:{&quot;version&quot;:&quot;green&quot;}}}&#x27;
# Monitor for issues
- name: Monitor new deployment
run: |
sleep 300 # Monitor for 5 minutes
./scripts/check-metrics.sh
# Rollback if needed
- name: Rollback on failure
if: failure()
run: |
kubectl patch service myapp -p &#x27;{&quot;spec&quot;:{&quot;selector&quot;:{&quot;version&quot;:&quot;blue&quot;}}}&#x27;
kubectl delete deployment myapp-green
# Make green the new blue
- name: Promote green to blue
if: success()
run: |
kubectl delete deployment myapp-blue
kubectl apply -f k8s/deployment-blue.yaml
kubectl set image deployment/myapp-blue myapp=myapp:${{ github.sha }}</code></pre>
<h3>Canary Deployment</h3>
<pre><code class="lang-yaml">name: Canary Deploy
on:
push:
branches: [main]
jobs:
deploy-canary:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
- name: Deploy canary (10%)
run: |
# Deploy canary with 10% traffic
kubectl apply -f k8s/canary-deployment.yaml
kubectl set image deployment/myapp-canary myapp=myapp:${{ github.sha }}
# Configure traffic split
kubectl apply -f - &lt;&lt;EOF
apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
name: myapp
spec:
hosts:
- myapp.com
http:
- match:
- headers:
canary:
exact: &quot;true&quot;
route:
- destination:
host: myapp-canary
- route:
- destination:
host: myapp-stable
weight: 90
- destination:
host: myapp-canary
weight: 10
EOF
- name: Monitor canary metrics
run: |
./scripts/monitor-canary.sh --duration=600 --threshold=5
- name: Gradually increase traffic
if: success()
run: |
# 25%
./scripts/adjust-traffic.sh --canary=25 --stable=75
sleep 300
# 50%
./scripts/adjust-traffic.sh --canary=50 --stable=50
sleep 300
# 100%
./scripts/adjust-traffic.sh --canary=100 --stable=0
- name: Promote canary to stable
if: success()
run: |
kubectl set image deployment/myapp-stable myapp=myapp:${{ github.sha }}
kubectl delete deployment myapp-canary
- name: Rollback canary
if: failure()
run: |
kubectl delete deployment myapp-canary
./scripts/alert-slack.sh &quot;Canary rollback triggered&quot;</code></pre>
<h3>Rolling Deployment (Kubernetes)</h3>
<pre><code class="lang-yaml">name: Rolling Deploy
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
- name: Update Kubernetes deployment
run: |
kubectl set image deployment/myapp \
myapp=myapp:${{ github.sha }} \
--record
# Configure rolling update strategy
kubectl patch deployment myapp -p &#x27;{
&quot;spec&quot;: {
&quot;strategy&quot;: {
&quot;type&quot;: &quot;RollingUpdate&quot;,
&quot;rollingUpdate&quot;: {
&quot;maxSurge&quot;: 1,
&quot;maxUnavailable&quot;: 0
}
}
}
}&#x27;
- name: Wait for rollout
run: |
kubectl rollout status deployment/myapp --timeout=600s
- name: Verify deployment
run: |
# Check pod health
kubectl get pods -l app=myapp
# Run health checks
./scripts/health-check.sh
- name: Rollback on failure
if: failure()
run: |
kubectl rollout undo deployment/myapp
kubectl rollout status deployment/myapp</code></pre>
<h3>Environment Promotion Pipeline</h3>
<pre><code class="lang-yaml">name: Environment Promotion
on:
push:
branches: [main]
jobs:
deploy-dev:
runs-on: ubuntu-latest
environment: development
steps:
- uses: actions/checkout@v4
- name: Deploy to dev
run: ./scripts/deploy.sh dev
- name: Run smoke tests
run: ./scripts/smoke-test.sh https://dev.myapp.com
deploy-staging:
needs: deploy-dev
runs-on: ubuntu-latest
environment: staging
steps:
- uses: actions/checkout@v4
- name: Deploy to staging
run: ./scripts/deploy.sh staging
- name: Run integration tests
run: npm run test:integration
- name: Run E2E tests
run: npm run test:e2e
deploy-prod:
needs: deploy-staging
runs-on: ubuntu-latest
environment:
name: production
url: https://myapp.com
steps:
- uses: actions/checkout@v4
# Manual approval via environment protection rules
- name: Deploy to production
run: ./scripts/deploy.sh production
- name: Verify deployment
run: ./scripts/verify-prod.sh
- name: Notify team
if: always()
run: |
./scripts/notify-slack.sh \
&quot;Production deployment: ${{ job.status }}&quot; \
&quot;Version: ${{ github.sha }}&quot;</code></pre>
<h3>Database Migration with Deployment</h3>
<pre><code class="lang-yaml">name: Deploy with Migrations
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
# Backup database before migration
- name: Backup database
run: |
./scripts/backup-db.sh production
echo &quot;BACKUP_ID=$(date +%s)&quot; &gt;&gt; $GITHUB_ENV
# Run forward migrations
- name: Run migrations
run: |
# Test migrations on copy first
./scripts/test-migration.sh
# Apply to production
npm run migrate:up
env:
DATABASE_URL: ${{ secrets.PROD_DATABASE_URL }}
# Deploy application
- name: Deploy application
run: |
kubectl set image deployment/myapp myapp=myapp:${{ github.sha }}
kubectl rollout status deployment/myapp
# Verify deployment
- name: Verify deployment
run: ./scripts/health-check.sh
# Rollback on failure
- name: Rollback deployment and database
if: failure()
run: |
# Rollback application
kubectl rollout undo deployment/myapp
# Rollback database
npm run migrate:down
./scripts/restore-db.sh production ${{ env.BACKUP_ID }}</code></pre>
<h3>Feature Flag Deployment</h3>
<pre><code class="lang-yaml">name: Feature Flag Deploy
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
# Deploy with feature disabled
- name: Deploy with feature flag off
run: |
kubectl set image deployment/myapp myapp=myapp:${{ github.sha }}
kubectl rollout status deployment/myapp
# Enable feature for internal users (0%)
- name: Enable for internal
run: |
curl -X PATCH https://api.launchdarkly.com/api/v2/flags/default/new-feature \
-H &quot;Authorization: ${{ secrets.LAUNCHDARKLY_TOKEN }}&quot; \
-d &#x27;{&quot;instructions&quot;: [{&quot;kind&quot;: &quot;updateTargets&quot;, &quot;values&quot;: {&quot;targets&quot;: [&quot;internal&quot;]}}]}&#x27;
# Gradual rollout
- name: Gradual rollout
run: |
# 5%
./scripts/update-flag.sh new-feature --percentage=5
sleep 600
# 25%
./scripts/update-flag.sh new-feature --percentage=25
sleep 600
# 50%
./scripts/update-flag.sh new-feature --percentage=50
sleep 600
# 100%
./scripts/update-flag.sh new-feature --percentage=100
- name: Monitor metrics
run: |
./scripts/check-error-rate.sh --flag=new-feature --threshold=1.0
- name: Rollback feature
if: failure()
run: |
./scripts/update-flag.sh new-feature --percentage=0</code></pre>
<h3>Multi-Region Deployment</h3>
<pre><code class="lang-yaml">name: Multi-Region Deploy
on:
push:
branches: [main]
jobs:
deploy-primary:
runs-on: ubuntu-latest
environment: production-us-east
steps:
- uses: actions/checkout@v4
- name: Deploy to us-east-1
run: |
aws eks update-kubeconfig --region us-east-1 --name prod-cluster
kubectl set image deployment/myapp myapp=myapp:${{ github.sha }}
kubectl rollout status deployment/myapp
- name: Verify primary region
run: ./scripts/health-check.sh us-east-1
deploy-secondary:
needs: deploy-primary
runs-on: ubuntu-latest
strategy:
matrix:
region: [us-west-2, eu-west-1, ap-southeast-1]
steps:
- uses: actions/checkout@v4
- name: Deploy to ${{ matrix.region }}
run: |
aws eks update-kubeconfig --region ${{ matrix.region }} --name prod-cluster
kubectl set image deployment/myapp myapp=myapp:${{ github.sha }}
kubectl rollout status deployment/myapp
- name: Verify region
run: ./scripts/health-check.sh ${{ matrix.region }}
- name: Update global load balancer
run: |
aws route53 change-resource-record-sets \
--hosted-zone-id ${{ secrets.HOSTED_ZONE_ID }} \
--change-batch file://dns-update-${{ matrix.region }}.json</code></pre>
<h3>Deployment with Health Checks</h3>
<pre><code class="lang-yaml">name: Deploy with Health Checks
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
- name: Deploy application
run: |
kubectl set image deployment/myapp myapp=myapp:${{ github.sha }}
- name: Wait for pods to be ready
run: |
kubectl rollout status deployment/myapp --timeout=600s
- name: Health check - HTTP endpoints
run: |
for i in {1..30}; do
if curl -f https://myapp.com/health; then
echo &quot;Health check passed&quot;
break
fi
echo &quot;Attempt $i failed, retrying...&quot;
sleep 10
done
- name: Health check - Database connectivity
run: |
kubectl exec deployment/myapp -- npm run db:ping
- name: Health check - Dependencies
run: |
./scripts/check-dependencies.sh \
--redis \
--postgres \
--s3
- name: Monitor error rates
run: |
./scripts/monitor-errors.sh --duration=300 --threshold=0.5
- name: Automated rollback
if: failure()
run: |
echo &quot;Health checks failed, rolling back&quot;
kubectl rollout undo deployment/myapp
kubectl rollout status deployment/myapp
# Notify team
./scripts/notify-slack.sh \
&quot;Deployment rolled back due to health check failure&quot; \
&quot;SHA: ${{ github.sha }}&quot;</code></pre>
<hr>
<h2>Quick Reference</h2>
<h3>Deployment Strategy Selection</h3>
<pre><code class="lang-yaml">Use Case → Strategy
─────────────────────────────────────────────────
Zero downtime required → Blue-Green or Rolling
High-risk changes → Canary
Limited resources → Rolling
Fast rollback critical → Blue-Green
Gradual validation needed → Canary
Simple app, downtime OK → Recreate
A/B testing → Feature Flags + Canary</code></pre>
<h3>Kubernetes Rolling Update Config</h3>
<pre><code class="lang-yaml">spec:
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1 # Extra pods during rollout
maxUnavailable: 0 # Minimum availability
minReadySeconds: 30 # Wait before marking ready
progressDeadlineSeconds: 600 # Timeout</code></pre>
<h3>Rollback Commands</h3>
<pre><code class="lang-bash"># Kubernetes
kubectl rollout undo deployment/myapp
kubectl rollout undo deployment/myapp --to-revision=2
# Docker
docker service update --rollback myapp
# AWS ECS
aws ecs update-service --cluster prod --service myapp --force-new-deployment
# Vercel
vercel rollback</code></pre>
<hr>
<h2>Anti-Patterns</h2>
<h3>❌ No Automated Rollback</h3>
<pre><code class="lang-yaml"># WRONG: Manual intervention required
- name: Deploy
run: ./deploy.sh
# [If it fails, ops team manually fixes]</code></pre>
<pre><code class="lang-yaml"># CORRECT: Automated rollback
- name: Deploy
run: ./deploy.sh
- name: Health check
run: ./health-check.sh
- name: Rollback on failure
if: failure()
run: ./rollback.sh</code></pre>
<h3>❌ Deploying Without Health Checks</h3>
<pre><code class="lang-yaml"># WRONG: Assume deployment succeeded
- run: kubectl apply -f deployment.yaml</code></pre>
<pre><code class="lang-yaml"># CORRECT: Verify deployment health
- run: kubectl apply -f deployment.yaml
- run: kubectl rollout status deployment/myapp
- run: ./smoke-test.sh</code></pre>
<h3>❌ No Database Backup Before Migration</h3>
<pre><code class="lang-yaml"># WRONG: Risky migration
- run: npm run migrate:up
- run: ./deploy.sh</code></pre>
<pre><code class="lang-yaml"># CORRECT: Backup first
- run: ./backup-db.sh
- run: npm run migrate:up
- run: ./deploy.sh
- if: failure()
run: ./restore-db.sh</code></pre>
<h3>❌ Deploying to All Regions Simultaneously</h3>
<pre><code class="lang-yaml"># WRONG: All regions at once
jobs:
deploy:
strategy:
matrix:
region: [us, eu, asia]
steps: [deploy]</code></pre>
<pre><code class="lang-yaml"># CORRECT: Staged rollout
jobs:
deploy-primary:
steps: [deploy to us-east-1]
deploy-secondary:
needs: deploy-primary
strategy:
matrix:
region: [us-west-2, eu-west-1]</code></pre>
<h3>❌ No Monitoring Period After Deployment</h3>
<pre><code class="lang-yaml"># WRONG: Deploy and forget
- run: ./deploy.sh</code></pre>
<pre><code class="lang-yaml"># CORRECT: Monitor post-deployment
- run: ./deploy.sh
- run: sleep 300 # 5 minute soak period
- run: ./check-metrics.sh</code></pre>
<h3>❌ Skipping Canary for High-Risk Changes</h3>
<pre><code class="lang-yaml"># WRONG: Direct to production
on:
push:
branches: [main]
jobs:
deploy-prod:
steps: [deploy 100%]</code></pre>
<pre><code class="lang-yaml"># CORRECT: Canary for risky changes
jobs:
deploy-canary:
if: contains(github.event.head_commit.message, &#x27;[high-risk]&#x27;)
steps: [deploy 10%, monitor, gradual rollout]</code></pre>
<hr>
<h2>Related Skills</h2>
<ul><li><code>github-actions-workflows.md</code> - Workflow configuration basics</li><li><code>ci-testing-strategy.md</code> - Pre-deployment testing</li><li><code>ci-optimization.md</code> - Deployment speed optimization</li><li><code>ci-security.md</code> - Secure deployment practices</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2025-10-18</p>
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/cicd-cd-deployment-patterns.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>