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]>
615 lines
25 KiB
HTML
615 lines
25 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>modal-scheduling</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="/modal-scheduling.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/modal-scheduling">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/modal-scheduling.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>modal-scheduling</h1><p class="lede">Running periodic tasks on Modal</p><h1>Modal Scheduling</h1>
|
|
<p><strong>Use this skill when:</strong></p>
|
|
<ul><li>Running periodic tasks on Modal</li><li>Implementing cron jobs</li><li>Scheduling batch processing</li><li>Creating automated workflows</li><li>Building recurring data pipelines</li></ul>
|
|
<h2>Periodic Schedules</h2>
|
|
<h3>Simple Period</h3>
|
|
<p>Run functions at fixed intervals:</p>
|
|
<pre><code class="lang-python">import modal
|
|
|
|
app = modal.App("scheduled-app")
|
|
|
|
# Every 5 minutes
|
|
@app.function(schedule=modal.Period(minutes=5))
|
|
def every_five_minutes():
|
|
print("Running every 5 minutes")
|
|
return process_data()
|
|
|
|
# Every hour
|
|
@app.function(schedule=modal.Period(hours=1))
|
|
def hourly_task():
|
|
print("Running hourly")
|
|
return cleanup_temp_files()
|
|
|
|
# Every day
|
|
@app.function(schedule=modal.Period(days=1))
|
|
def daily_task():
|
|
print("Running daily")
|
|
return generate_report()</code></pre>
|
|
<h3>Multiple Time Units</h3>
|
|
<p>Combine time units:</p>
|
|
<pre><code class="lang-python"># Every 1 hour 30 minutes
|
|
@app.function(schedule=modal.Period(hours=1, minutes=30))
|
|
def every_ninety_minutes():
|
|
return sync_data()
|
|
|
|
# Every week (7 days)
|
|
@app.function(schedule=modal.Period(days=7))
|
|
def weekly_cleanup():
|
|
return archive_old_data()</code></pre>
|
|
<h2>Cron Schedules</h2>
|
|
<h3>Cron Syntax</h3>
|
|
<p>Use cron expressions for precise timing:</p>
|
|
<pre><code class="lang-python"># Every day at 2:30 AM UTC
|
|
@app.function(schedule=modal.Cron("30 2 * * *"))
|
|
def daily_at_230am():
|
|
return generate_daily_report()
|
|
|
|
# Every Monday at 9:00 AM UTC
|
|
@app.function(schedule=modal.Cron("0 9 * * MON"))
|
|
def monday_morning():
|
|
return send_weekly_summary()
|
|
|
|
# Every weekday at 8:00 AM UTC
|
|
@app.function(schedule=modal.Cron("0 8 * * MON-FRI"))
|
|
def weekday_morning():
|
|
return business_day_tasks()
|
|
|
|
# First day of month at midnight UTC
|
|
@app.function(schedule=modal.Cron("0 0 1 * *"))
|
|
def monthly_billing():
|
|
return process_monthly_invoices()
|
|
|
|
# Every 15 minutes
|
|
@app.function(schedule=modal.Cron("*/15 * * * *"))
|
|
def every_fifteen_min():
|
|
return poll_external_api()</code></pre>
|
|
<h3>Cron Format Reference</h3>
|
|
<pre><code># Format: minute hour day month weekday
|
|
# ┌───────── minute (0 - 59)
|
|
# │ ┌───────── hour (0 - 23)
|
|
# │ │ ┌───────── day of month (1 - 31)
|
|
# │ │ │ ┌───────── month (1 - 12)
|
|
# │ │ │ │ ┌───────── day of week (0 - 6) (Sunday=0 or 7)
|
|
# │ │ │ │ │
|
|
# * * * * *
|
|
|
|
# Examples:
|
|
# "0 0 * * *" # Daily at midnight
|
|
# "0 */6 * * *" # Every 6 hours
|
|
# "30 3 * * 0" # Sundays at 3:30 AM
|
|
# "0 0 1,15 * *" # 1st and 15th of month
|
|
# "0 9-17 * * *" # Every hour from 9 AM to 5 PM</code></pre>
|
|
<h2>Scheduled Data Processing</h2>
|
|
<h3>ETL Pipeline</h3>
|
|
<p>Schedule data extraction and processing:</p>
|
|
<pre><code class="lang-python">image = modal.Image.debian_slim().uv_pip_install(
|
|
"pandas",
|
|
"sqlalchemy",
|
|
"psycopg2-binary"
|
|
)
|
|
|
|
@app.function(
|
|
schedule=modal.Cron("0 1 * * *"), # 1 AM daily
|
|
image=image,
|
|
timeout=3600 # 1 hour max
|
|
)
|
|
def etl_pipeline():
|
|
import pandas as pd
|
|
from sqlalchemy import create_engine
|
|
|
|
print("Starting ETL pipeline")
|
|
|
|
# Extract
|
|
source_data = extract_from_source()
|
|
|
|
# Transform
|
|
df = pd.DataFrame(source_data)
|
|
df = transform_data(df)
|
|
|
|
# Load
|
|
engine = create_engine(DATABASE_URL)
|
|
df.to_sql("analytics", engine, if_exists="replace")
|
|
|
|
print(f"Loaded {len(df)} rows")
|
|
return {"rows": len(df), "status": "complete"}
|
|
|
|
def extract_from_source():
|
|
# Fetch from API, S3, etc.
|
|
return data
|
|
|
|
def transform_data(df):
|
|
# Clean and transform
|
|
return df</code></pre>
|
|
<h3>Batch Processing</h3>
|
|
<p>Process batches on schedule:</p>
|
|
<pre><code class="lang-python">@app.function(
|
|
schedule=modal.Period(hours=6),
|
|
timeout=7200 # 2 hours
|
|
)
|
|
def process_pending_jobs():
|
|
jobs = get_pending_jobs()
|
|
|
|
print(f"Processing {len(jobs)} jobs")
|
|
|
|
# Process in parallel
|
|
results = list(process_job.map(jobs))
|
|
|
|
successful = sum(1 for r in results if r["status"] == "success")
|
|
failed = len(results) - successful
|
|
|
|
print(f"Completed: {successful} success, {failed} failed")
|
|
|
|
return {
|
|
"total": len(jobs),
|
|
"successful": successful,
|
|
"failed": failed
|
|
}
|
|
|
|
@app.function()
|
|
def process_job(job):
|
|
try:
|
|
result = execute_job(job)
|
|
return {"job_id": job["id"], "status": "success"}
|
|
except Exception as e:
|
|
return {"job_id": job["id"], "status": "failed", "error": str(e)}</code></pre>
|
|
<h2>Monitoring and Alerts</h2>
|
|
<h3>Health Checks</h3>
|
|
<p>Schedule health monitoring:</p>
|
|
<pre><code class="lang-python">@app.function(schedule=modal.Period(minutes=5))
|
|
def health_check():
|
|
services = ["api", "database", "cache"]
|
|
results = {}
|
|
|
|
for service in services:
|
|
try:
|
|
status = check_service(service)
|
|
results[service] = "healthy"
|
|
except Exception as e:
|
|
results[service] = f"unhealthy: {e}"
|
|
send_alert(f"Service {service} is down: {e}")
|
|
|
|
return results
|
|
|
|
def check_service(service_name):
|
|
# Ping service
|
|
pass
|
|
|
|
def send_alert(message):
|
|
# Send to Slack, PagerDuty, etc.
|
|
pass</code></pre>
|
|
<h3>Metric Collection</h3>
|
|
<p>Collect metrics periodically:</p>
|
|
<pre><code class="lang-python">@app.function(schedule=modal.Cron("*/5 * * * *")) # Every 5 min
|
|
def collect_metrics():
|
|
metrics = {
|
|
"timestamp": datetime.now().isoformat(),
|
|
"cpu_usage": get_cpu_usage(),
|
|
"memory_usage": get_memory_usage(),
|
|
"active_users": count_active_users(),
|
|
"request_count": get_request_count()
|
|
}
|
|
|
|
# Store in time-series database
|
|
store_metrics(metrics)
|
|
|
|
return metrics</code></pre>
|
|
<h2>Data Cleanup</h2>
|
|
<h3>Automated Cleanup</h3>
|
|
<p>Schedule data cleanup tasks:</p>
|
|
<pre><code class="lang-python">from datetime import datetime, timedelta
|
|
|
|
@app.function(schedule=modal.Cron("0 2 * * *")) # 2 AM daily
|
|
def cleanup_old_data():
|
|
cutoff_date = datetime.now() - timedelta(days=90)
|
|
|
|
# Delete old records
|
|
deleted_count = delete_records_before(cutoff_date)
|
|
|
|
# Clean up temporary files
|
|
temp_files_deleted = cleanup_temp_files()
|
|
|
|
# Archive old logs
|
|
logs_archived = archive_old_logs(cutoff_date)
|
|
|
|
return {
|
|
"records_deleted": deleted_count,
|
|
"temp_files_deleted": temp_files_deleted,
|
|
"logs_archived": logs_archived
|
|
}</code></pre>
|
|
<h3>Cache Warming</h3>
|
|
<p>Pre-warm caches on schedule:</p>
|
|
<pre><code class="lang-python">@app.function(schedule=modal.Cron("0 6 * * *")) # 6 AM daily
|
|
def warm_caches():
|
|
# Pre-compute popular queries
|
|
popular_items = get_popular_items()
|
|
|
|
for item in popular_items:
|
|
cache_item_details(item)
|
|
|
|
print(f"Warmed cache for {len(popular_items)} items")
|
|
return {"items_cached": len(popular_items)}</code></pre>
|
|
<h2>Backup and Archival</h2>
|
|
<h3>Automated Backups</h3>
|
|
<p>Schedule database backups:</p>
|
|
<pre><code class="lang-python">@app.function(
|
|
schedule=modal.Cron("0 0 * * *"), # Midnight daily
|
|
timeout=3600
|
|
)
|
|
def backup_database():
|
|
import subprocess
|
|
from datetime import datetime
|
|
|
|
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
|
|
backup_file = f"backup_{timestamp}.sql"
|
|
|
|
# Create backup
|
|
subprocess.run([
|
|
"pg_dump",
|
|
"-h", DB_HOST,
|
|
"-U", DB_USER,
|
|
"-d", DB_NAME,
|
|
"-f", backup_file
|
|
])
|
|
|
|
# Upload to S3
|
|
upload_to_s3(backup_file, f"backups/{backup_file}")
|
|
|
|
# Clean up local file
|
|
os.remove(backup_file)
|
|
|
|
return {"backup_file": backup_file, "status": "complete"}</code></pre>
|
|
<h2>Retries and Error Handling</h2>
|
|
<h3>Retry Failed Jobs</h3>
|
|
<p>Handle failures gracefully:</p>
|
|
<pre><code class="lang-python">@app.function(
|
|
schedule=modal.Period(hours=1),
|
|
retries=3 # Retry up to 3 times
|
|
)
|
|
def resilient_task():
|
|
try:
|
|
result = perform_task()
|
|
return {"status": "success", "result": result}
|
|
except Exception as e:
|
|
print(f"Task failed: {e}")
|
|
# Log error for monitoring
|
|
log_error(e)
|
|
raise # Will trigger retry</code></pre>
|
|
<h3>Error Notifications</h3>
|
|
<p>Send alerts on failures:</p>
|
|
<pre><code class="lang-python">@app.function(schedule=modal.Cron("0 * * * *")) # Hourly
|
|
def monitored_task():
|
|
try:
|
|
result = critical_operation()
|
|
return {"status": "success"}
|
|
except Exception as e:
|
|
# Send alert
|
|
send_slack_alert(f"Hourly task failed: {e}")
|
|
|
|
# Log to monitoring service
|
|
log_to_datadog("task.failed", tags=["critical"])
|
|
|
|
# Re-raise to show as failed in Modal dashboard
|
|
raise</code></pre>
|
|
<h2>Conditional Execution</h2>
|
|
<h3>Skip on Conditions</h3>
|
|
<p>Run only when needed:</p>
|
|
<pre><code class="lang-python">@app.function(schedule=modal.Cron("0 */4 * * *")) # Every 4 hours
|
|
def conditional_sync():
|
|
# Check if sync is needed
|
|
if not should_sync():
|
|
print("Sync not needed, skipping")
|
|
return {"status": "skipped"}
|
|
|
|
# Perform sync
|
|
result = sync_data()
|
|
|
|
return {"status": "completed", "items": result}
|
|
|
|
def should_sync():
|
|
# Check conditions (e.g., data staleness)
|
|
return check_data_age() > 4 * 3600</code></pre>
|
|
<h2>Chaining Scheduled Functions</h2>
|
|
<h3>Sequential Processing</h3>
|
|
<p>Chain multiple scheduled tasks:</p>
|
|
<pre><code class="lang-python">@app.function(schedule=modal.Cron("0 1 * * *")) # 1 AM
|
|
def step1_extract():
|
|
data = extract_data()
|
|
save_to_temp(data)
|
|
# Trigger next step
|
|
step2_transform.spawn()
|
|
return {"status": "extracted"}
|
|
|
|
@app.function()
|
|
def step2_transform():
|
|
data = load_from_temp()
|
|
transformed = transform(data)
|
|
save_to_temp(transformed)
|
|
# Trigger next step
|
|
step3_load.spawn()
|
|
|
|
@app.function()
|
|
def step3_load():
|
|
data = load_from_temp()
|
|
load_to_warehouse(data)
|
|
cleanup_temp()</code></pre>
|
|
<h2>Testing Scheduled Functions</h2>
|
|
<h3>Manual Triggering</h3>
|
|
<p>Test scheduled functions manually:</p>
|
|
<pre><code class="lang-python">@app.function(schedule=modal.Cron("0 2 * * *"))
|
|
def scheduled_task():
|
|
return process_data()
|
|
|
|
# Can still call directly for testing
|
|
@app.local_entrypoint()
|
|
def test():
|
|
result = scheduled_task.remote()
|
|
print(f"Test result: {result}")</code></pre>
|
|
<h2>Anti-Patterns to Avoid</h2>
|
|
<p><strong>DON'T use short periods for expensive operations:</strong></p>
|
|
<pre><code class="lang-python"># ❌ BAD - Expensive GPU task every minute
|
|
@app.function(
|
|
schedule=modal.Period(minutes=1),
|
|
gpu="a100"
|
|
)
|
|
def expensive_every_minute():
|
|
return train_model() # Costs $8/hour constantly!
|
|
|
|
# ✅ GOOD - Appropriate frequency
|
|
@app.function(
|
|
schedule=modal.Period(hours=6),
|
|
gpu="a100"
|
|
)
|
|
def reasonable_schedule():
|
|
return train_model()</code></pre>
|
|
<p><strong>DON'T forget timeouts:</strong></p>
|
|
<pre><code class="lang-python"># ❌ BAD - Could run forever
|
|
@app.function(schedule=modal.Cron("0 0 * * *"))
|
|
def no_timeout():
|
|
while True:
|
|
process()
|
|
|
|
# ✅ GOOD - Bounded execution
|
|
@app.function(
|
|
schedule=modal.Cron("0 0 * * *"),
|
|
timeout=3600 # 1 hour max
|
|
)
|
|
def with_timeout():
|
|
process_for_limited_time()</code></pre>
|
|
<p><strong>DON'T ignore errors silently:</strong></p>
|
|
<pre><code class="lang-python"># ❌ BAD - Swallows errors
|
|
@app.function(schedule=modal.Period(hours=1))
|
|
def silent_failures():
|
|
try:
|
|
critical_task()
|
|
except:
|
|
pass # No one knows it failed!
|
|
|
|
# ✅ GOOD - Log and alert
|
|
@app.function(schedule=modal.Period(hours=1))
|
|
def monitored():
|
|
try:
|
|
critical_task()
|
|
except Exception as e:
|
|
log_error(e)
|
|
send_alert(e)
|
|
raise</code></pre>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><strong>modal-functions-basics.md</strong> - Basic Modal patterns</li><li><strong>modal-volumes-secrets.md</strong> - Persisting scheduled task data</li><li><strong>modal-web-endpoints.md</strong> - Triggering tasks via webhooks</li></ul>
|
|
<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="/modal-scheduling.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |