mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
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]>
539 lines
27 KiB
HTML
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><process-type>: <command></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
|
|
{
|
|
"engines": {
|
|
"node": "20.x",
|
|
"npm": "10.x"
|
|
}
|
|
}</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">{
|
|
"name": "myapp",
|
|
"description": "My awesome app",
|
|
"repository": "https://github.com/myorg/myapp",
|
|
"env": {
|
|
"SECRET_KEY": {
|
|
"description": "Django secret key",
|
|
"generator": "secret"
|
|
},
|
|
"DEBUG": {
|
|
"value": "False"
|
|
}
|
|
},
|
|
"formation": {
|
|
"web": {
|
|
"quantity": 1,
|
|
"size": "basic"
|
|
}
|
|
},
|
|
"addons": [
|
|
"heroku-postgresql:mini"
|
|
],
|
|
"buildpacks": [
|
|
{
|
|
"url": "heroku/python"
|
|
}
|
|
],
|
|
"scripts": {
|
|
"postdeploy": "python manage.py migrate && python manage.py loaddata fixtures/demo.json"
|
|
}
|
|
}</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('SECRET_KEY')
|
|
DATABASE_URL = os.environ.get('DATABASE_URL')
|
|
DEBUG = os.environ.get('DEBUG', 'False') == 'True'</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 && 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">{
|
|
"scripts": {
|
|
"postdeploy": "python manage.py migrate"
|
|
}
|
|
}</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'T: Hardcode secrets in code (use config vars)
|
|
❌ DON'T: Commit .env files to git
|
|
❌ DON'T: Use SQLite in production (use Postgres)
|
|
❌ DON'T: Store files on dyno filesystem (use S3/Cloudinary)
|
|
❌ DON'T: Deploy without testing locally first
|
|
❌ DON'T: Ignore Procfile (causes wrong start command)
|
|
❌ DON'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('SECRET_KEY')</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> |