Files
skills/public/deployment-heroku-deployment.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

539 lines
27 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>deployment-heroku-deployment</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="alternate" type="text/markdown" href="/deployment-heroku-deployment.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/deployment-heroku-deployment">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/deployment-heroku-deployment.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>deployment-heroku-deployment</h1><p class="lede">Deploying web applications, APIs, or worker processes to Heroku</p><h1>Heroku Deployment</h1>
<p><strong>Scope</strong>: Heroku app deployment, Procfile, buildpacks, pipelines, review apps <strong>Lines</strong>: ~330 <strong>Last Updated</strong>: 2025-10-18</p>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Deploying web applications, APIs, or worker processes to Heroku</li><li>Setting up Heroku pipelines for staging/production environments</li><li>Configuring Procfile for process types (web, worker, release)</li><li>Troubleshooting Heroku deployment failures or build errors</li><li>Implementing review apps for pull request previews</li><li>Migrating from other platforms to Heroku</li><li>Setting up custom buildpacks or multi-buildpack configurations</li></ul>
<h2>Core Concepts</h2>
<h3>Heroku Application Architecture</h3>
<p><strong>Dynos</strong>: Lightweight Linux containers running app processes</p>
<ul><li>Web dynos: Handle HTTP traffic, must bind to <code>$PORT</code></li><li>Worker dynos: Background jobs, queues, scheduled tasks</li><li>One-off dynos: Run scripts, migrations, maintenance tasks</li><li>Dyno types: Basic ($7/mo), Standard ($25/mo), Performance ($250+/mo)</li></ul>
<p><strong>Procfile</strong>: Process type definition file</p>
<ul><li>Lives at repository root</li><li>Defines how to start each process type</li><li>Required for non-standard app types</li><li>Format: <code>&lt;process-type&gt;: &lt;command&gt;</code></li></ul>
<p><strong>Buildpacks</strong>: Transform code into runnable apps</p>
<ul><li>Auto-detection: Heroku detects language from files</li><li>Official buildpacks: Ruby, Node.js, Python, Java, PHP, Go, etc.</li><li>Custom buildpacks: Add system dependencies</li><li>Multi-buildpack: Combine multiple buildpacks (buildpacks in <code>.buildpacks</code> file)</li></ul>
<h3>Deployment Methods</h3>
<p><strong>Git Push Deployment</strong> (Standard):</p>
<pre><code class="lang-bash"># Add Heroku remote
heroku git:remote -a myapp
# Deploy
git push heroku main</code></pre>
<p><strong>GitHub Integration</strong>:</p>
<ul><li>Automatic deploys from branch</li><li>Wait for CI to pass before deploy</li><li>Review apps for PRs</li><li>Manual promotion to production</li></ul>
<p><strong>Docker Deployment</strong>:</p>
<pre><code class="lang-bash"># Login to container registry
heroku container:login
# Build and push
heroku container:push web -a myapp
# Release
heroku container:release web -a myapp</code></pre>
<h3>Release Phase</h3>
<p><strong>Purpose</strong>: Run tasks before new release goes live</p>
<ul><li>Database migrations</li><li>Asset compilation</li><li>Cache warming</li><li>Validation checks</li></ul>
<p><strong>Configuration</strong> (Procfile):</p>
<pre><code>release: python manage.py migrate
web: gunicorn myapp.wsgi</code></pre>
<p><strong>Behavior</strong>:</p>
<ul><li>Runs on new release only (not dyno restart)</li><li>Blocks release if command fails (exit code != 0)</li><li>Runs in ephemeral dyno (no persistent storage)</li><li>60 minute timeout</li></ul>
<hr>
<h2>Patterns</h2>
<h3>Pattern 1: Standard Web Application Deployment</h3>
<p><strong>Python (Django/Flask) with Procfile</strong>:</p>
<pre><code class="lang-procfile">web: gunicorn myapp.wsgi --bind 0.0.0.0:$PORT --workers 4
release: python manage.py migrate --noinput</code></pre>
<p><strong>Node.js (Express/Next.js)</strong>:</p>
<pre><code class="lang-procfile">web: npm start
release: npm run migrate</code></pre>
<p><strong>Requirements</strong>:</p>
<pre><code class="lang-bash"># Python: runtime.txt
python-3.11.9
# Python: requirements.txt
gunicorn==21.2.0
django==4.2.0
# Node.js: package.json engines
{
&quot;engines&quot;: {
&quot;node&quot;: &quot;20.x&quot;,
&quot;npm&quot;: &quot;10.x&quot;
}
}</code></pre>
<p><strong>Deploy steps</strong>:</p>
<pre><code class="lang-bash"># Create app
heroku create myapp
# Add Postgres
heroku addons:create heroku-postgresql:essential-0
# Set environment variables
heroku config:set SECRET_KEY=xxx DJANGO_SETTINGS_MODULE=myapp.settings.production
# Deploy
git push heroku main
# Scale dynos
heroku ps:scale web=1
# Open app
heroku open</code></pre>
<h3>Pattern 2: Worker Dyno for Background Jobs</h3>
<p><strong>Procfile with web and worker</strong>:</p>
<pre><code class="lang-procfile">web: gunicorn myapp.wsgi --workers 4
worker: celery -A myapp worker --loglevel=info
release: python manage.py migrate</code></pre>
<p><strong>Deploy and scale</strong>:</p>
<pre><code class="lang-bash"># Deploy changes
git push heroku main
# Scale worker dynos
heroku ps:scale worker=2
# Check dyno status
heroku ps
# View worker logs
heroku logs --dyno=worker.1 --tail</code></pre>
<p><strong>Cost optimization</strong>:</p>
<pre><code class="lang-bash"># Scale down workers during off-hours (use Heroku Scheduler)
heroku ps:scale worker=0 # Night
heroku ps:scale worker=2 # Day</code></pre>
<h3>Pattern 3: Heroku Pipeline (Staging → Production)</h3>
<p><strong>Create pipeline</strong>:</p>
<pre><code class="lang-bash"># Create pipeline
heroku pipelines:create myapp-pipeline --team=myteam
# Create staging app
heroku create myapp-staging --pipeline=myapp-pipeline --stage=staging
# Create production app
heroku create myapp-production --pipeline=myapp-pipeline --stage=production
# Connect to GitHub
heroku pipelines:connect myapp-pipeline --repo=myorg/myapp</code></pre>
<p><strong>Enable review apps</strong> (app.json):</p>
<pre><code class="lang-json">{
&quot;name&quot;: &quot;myapp&quot;,
&quot;description&quot;: &quot;My awesome app&quot;,
&quot;repository&quot;: &quot;https://github.com/myorg/myapp&quot;,
&quot;env&quot;: {
&quot;SECRET_KEY&quot;: {
&quot;description&quot;: &quot;Django secret key&quot;,
&quot;generator&quot;: &quot;secret&quot;
},
&quot;DEBUG&quot;: {
&quot;value&quot;: &quot;False&quot;
}
},
&quot;formation&quot;: {
&quot;web&quot;: {
&quot;quantity&quot;: 1,
&quot;size&quot;: &quot;basic&quot;
}
},
&quot;addons&quot;: [
&quot;heroku-postgresql:mini&quot;
],
&quot;buildpacks&quot;: [
{
&quot;url&quot;: &quot;heroku/python&quot;
}
],
&quot;scripts&quot;: {
&quot;postdeploy&quot;: &quot;python manage.py migrate &amp;&amp; python manage.py loaddata fixtures/demo.json&quot;
}
}</code></pre>
<p><strong>Promotion workflow</strong>:</p>
<pre><code class="lang-bash"># Auto-deploy staging from main branch (via dashboard)
# Manual promotion to production:
heroku pipelines:promote -r staging
# Or promote specific release
heroku releases -a myapp-staging
heroku pipelines:promote -r staging --release v123</code></pre>
<h3>Pattern 4: Multi-Buildpack Setup</h3>
<p><strong>Use case</strong>: Python app requiring Node.js for asset compilation</p>
<p><strong>Create <code>.buildpacks</code> file</strong>:</p>
<pre><code>https://github.com/heroku/heroku-buildpack-nodejs
https://github.com/heroku/heroku-buildpack-python</code></pre>
<p><strong>Or via CLI</strong>:</p>
<pre><code class="lang-bash">heroku buildpacks:add --index 1 heroku/nodejs
heroku buildpacks:add --index 2 heroku/python
# Verify order
heroku buildpacks</code></pre>
<p><strong>Order matters</strong>: Buildpacks run in sequence, last one determines dyno type</p>
<h3>Pattern 5: Custom Domain Configuration</h3>
<p><strong>Add custom domain</strong>:</p>
<pre><code class="lang-bash"># Add domain
heroku domains:add www.example.com
# Get DNS target
heroku domains
# Output:
# === myapp Custom Domains
# Domain Name DNS Target
# www.example.com myapp-12345.herokudns.com</code></pre>
<p><strong>DNS configuration</strong> (at domain registrar):</p>
<pre><code>Type Name Value
CNAME www myapp-12345.herokudns.com</code></pre>
<p><strong>SSL certificate</strong> (automatic with ACM):</p>
<pre><code class="lang-bash"># Enable Automated Certificate Management (free)
heroku certs:auto:enable
# Check status
heroku certs:auto</code></pre>
<h3>Pattern 6: Environment Configuration</h3>
<p><strong>Set config vars</strong>:</p>
<pre><code class="lang-bash"># Single variable
heroku config:set DATABASE_URL=postgres://...
# Multiple variables
heroku config:set \
SECRET_KEY=xxx \
DEBUG=False \
ALLOWED_HOSTS=myapp.com
# From .env file (requires heroku-dotenv plugin)
heroku plugins:install heroku-config
heroku config:push
# View all config
heroku config
# Unset variable
heroku config:unset DEBUG</code></pre>
<p><strong>Access in code</strong> (Python):</p>
<pre><code class="lang-python">import os
SECRET_KEY = os.environ.get(&#x27;SECRET_KEY&#x27;)
DATABASE_URL = os.environ.get(&#x27;DATABASE_URL&#x27;)
DEBUG = os.environ.get(&#x27;DEBUG&#x27;, &#x27;False&#x27;) == &#x27;True&#x27;</code></pre>
<h3>Pattern 7: Database Migration on Deploy</h3>
<p><strong>Procfile with release phase</strong>:</p>
<pre><code class="lang-procfile">release: python manage.py migrate &amp;&amp; python manage.py createcachetable
web: gunicorn myapp.wsgi</code></pre>
<p><strong>Alternative: Post-deploy hook</strong> (app.json):</p>
<pre><code class="lang-json">{
&quot;scripts&quot;: {
&quot;postdeploy&quot;: &quot;python manage.py migrate&quot;
}
}</code></pre>
<p><strong>Manual migration</strong> (for complex changes):</p>
<pre><code class="lang-bash"># Run one-off dyno
heroku run python manage.py migrate
# With custom settings
heroku run python manage.py migrate --settings=myapp.settings.production</code></pre>
<h3>Pattern 8: Docker Container Deployment</h3>
<p><strong>Dockerfile</strong>:</p>
<pre><code class="lang-dockerfile">FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
# Heroku provides $PORT dynamically
CMD gunicorn myapp.wsgi --bind 0.0.0.0:$PORT</code></pre>
<p><strong>Deploy</strong>:</p>
<pre><code class="lang-bash"># Build and push (uses heroku.yml or Dockerfile)
heroku container:push web
# Release (starts new dynos)
heroku container:release web
# View logs
heroku logs --tail</code></pre>
<p><strong>heroku.yml</strong> (advanced):</p>
<pre><code class="lang-yaml">build:
docker:
web: Dockerfile
worker: Dockerfile.worker
run:
web: gunicorn myapp.wsgi
worker: celery -A myapp worker</code></pre>
<hr>
<h2>Quick Reference</h2>
<h3>Essential Commands</h3>
<pre><code>Command | Purpose
-------------------------------------|------------------------------------------
heroku create [name] | Create new Heroku app
heroku git:remote -a myapp | Add Heroku remote to existing repo
git push heroku main | Deploy via git
heroku logs --tail | View live logs
heroku ps | Check dyno status
heroku ps:scale web=1 worker=2 | Scale dynos
heroku run bash | Open shell on dyno
heroku releases | View release history
heroku rollback v123 | Rollback to specific version
heroku domains:add domain.com | Add custom domain
heroku config:set KEY=value | Set environment variable
heroku addons:create addon:plan | Add add-on
heroku pg:backups:capture | Create database backup
heroku maintenance:on | Enable maintenance mode
heroku restart | Restart all dynos</code></pre>
<h3>Procfile Process Types</h3>
<pre><code>Process Type | Purpose | Example Command
-------------|--------------------------------|--------------------------------
web | HTTP traffic handler | gunicorn app:app
worker | Background jobs | celery worker -A tasks
release | Pre-release tasks | python manage.py migrate
clock | Scheduled tasks (deprecated) | python clock.py</code></pre>
<h3>Deployment Checklist</h3>
<pre><code>✅ DO: Use Procfile for custom start commands
✅ DO: Set Python/Node version explicitly (runtime.txt, engines)
✅ DO: Use release phase for migrations
✅ DO: Set production environment variables before first deploy
✅ DO: Add .gitignore entries for local files (.env, db.sqlite3)
✅ DO: Use pipelines for staging → production flow
✅ DO: Enable automatic SSL for custom domains
✅ DO: Configure proper dyno type for workload (Basic/Standard/Performance)
❌ DON&#x27;T: Hardcode secrets in code (use config vars)
❌ DON&#x27;T: Commit .env files to git
❌ DON&#x27;T: Use SQLite in production (use Postgres)
❌ DON&#x27;T: Store files on dyno filesystem (use S3/Cloudinary)
❌ DON&#x27;T: Deploy without testing locally first
❌ DON&#x27;T: Ignore Procfile (causes wrong start command)
❌ DON&#x27;T: Use development dependencies in production</code></pre>
<hr>
<h2>Anti-Patterns</h2>
<p>❌ <strong>Hardcoded secrets in repository</strong>: Exposes credentials in git history ✅ Use <code>heroku config:set SECRET_KEY=xxx</code> and <code>os.environ.get(&#x27;SECRET_KEY&#x27;)</code></p>
<p>❌ <strong>No Procfile for non-standard apps</strong>: Heroku may guess wrong start command ✅ Always include Procfile with explicit process definitions</p>
<p>❌ <strong>Using SQLite in production</strong>: Data loss on dyno restart (ephemeral filesystem) ✅ Use <code>heroku addons:create heroku-postgresql:essential-0</code></p>
<p>❌ <strong>Storing uploaded files on dyno</strong>: Files disappear on restart/scale ✅ Use S3, Cloudinary, or Heroku add-on for persistent storage</p>
<p>❌ <strong>Not setting Python/Node version</strong>: Unpredictable runtime ✅ Create <code>runtime.txt</code> (Python) or set <code>engines</code> in package.json (Node)</p>
<p>❌ <strong>Deploying without migrations</strong>: Database schema mismatch ✅ Use <code>release: python manage.py migrate</code> in Procfile</p>
<p>❌ <strong>Wrong dyno type for workload</strong>: Over/under-provisioning ✅ Basic for low-traffic, Standard for production, Performance for high-demand</p>
<p>❌ <strong>Not using pipelines</strong>: No staging environment, deploy directly to production ✅ Create pipeline with staging app for testing before production</p>
<p>❌ <strong>Ignoring build logs</strong>: Silent deployment failures ✅ Always check <code>git push heroku main</code> output for errors</p>
<p>❌ <strong>Manual scaling only</strong>: No auto-scaling for traffic spikes ✅ Consider Heroku Autoscaling add-on or Standard+ dynos with built-in autoscaling</p>
<hr>
<h2>Related Skills</h2>
<ul><li><code>heroku-addons.md</code> - Postgres, Redis, monitoring, email services</li><li><code>heroku-troubleshooting.md</code> - Debugging crashes, logs, performance issues</li><li><code>docker-deployment.md</code> - Container-based deployment patterns</li><li><code>ci-cd-pipelines.md</code> - Continuous deployment automation</li><li><code>environment-configuration.md</code> - Managing secrets and config across environments</li><li><code>database-migrations.md</code> - Safe migration strategies for production</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2025-10-18 <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="/deployment-heroku-deployment.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>