Scaffold: Job Packaging

This document is an entrypoint for job packaging scaffolding. The step-by-step flow is in /.system/skills/ssot/repo/scaffolding/devops-packaging-job/SKILL.md.

1. Purpose & Scope

Purpose: Generate packaging skeleton for deploying a module as a batch job (cron job, scheduled task, one-off execution).

Scope:

•Creates job packaging configuration files
•Sets up Dockerfile template optimized for batch execution
•Configures job scripts
•Records packaging decisions in workdocs

Out of scope:

•Actual Docker image building
•Job scheduler configuration (Kubernetes CronJob, etc.)
•HTTP service packaging (see devops_packaging_service.md)
•Deployment (see devops_deploy_job.md)

2. Inputs & Preconditions

Required Inputs

Parameter	Type	Description
`job_name`	string	Job identifier (used in image tags)
`module_id`	string	Source module being packaged
`entrypoint`	string	Job entrypoint script or command

Optional Inputs

Parameter	Type	Default	Description
`base_image`	string	`python:3.11-slim`	Docker base image
`schedule`	string	""	Cron schedule expression (informational)
`timeout`	string	`1h`	Job timeout
`retry_policy`	object	{}	Retry configuration
`registry`	string	""	Container registry URL

Preconditions

•Target module exists in /modules/<module_id>/
•Module has a runnable job entrypoint
•/ops/packaging/ directory exists
•Human has container registry credentials (if pushing images)

3. Step-by-Step Flow (AI + Human)

See /.system/skills/ssot/repo/scaffolding/devops-packaging-job/SKILL.md.

4. Tools & Scripts

Tool	Purpose
`scripts/devops/scaffold/devops_packaging_job.py`	Orchestrator script
`/ops/packaging/scripts/build.sh`	Generated build script

5. Outputs & Side Effects

Files Created

code

ops/packaging/jobs/<job_name>/
  Dockerfile          # Docker build configuration
  run.sh              # Job run script
  config.yaml         # Job configuration
  README.md           # Human-facing documentation

Dockerfile Template

dockerfile

# Auto-generated by devops_packaging_job scaffold
FROM python:3.11-slim

WORKDIR /app

# Install dependencies
COPY modules/<module_id>/requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Copy application code
COPY modules/<module_id>/src/ ./src/

# Job entrypoint
ENTRYPOINT ["python", "-m", "<entrypoint>"]

Configuration File

yaml

job_name: <job_name>
module_id: <module_id>
entrypoint: <entrypoint>
base_image: python:3.11-slim
schedule: ""  # e.g., "0 2 * * *" for daily at 2am
timeout: 1h
retry_policy:
  max_retries: 3
  backoff: exponential
registry: ""

6. Safety & Rollback

Safety Measures

•--dry-run always available for preview
•Human approval required before execution
•No actual Docker builds during scaffold
•Credentials not stored in generated files

Rollback Procedure

If scaffold fails or needs reverting:

•
Delete the packaging directory:
bash
```
rm -rf ops/packaging/jobs/<job_name>/
```

7. Next Steps After Scaffolding

•Review and customize generated Dockerfile

•Build image locally:

bash

cd ops/packaging/jobs/<job_name>
docker build -t <job_name>:latest .

•
Test job locally:
bash
```
docker run --rm <job_name>:latest
```
•
Push to registry (requires credentials):
bash
```
docker push <registry>/<job_name>:latest
```
•Configure deployment/scheduling (see /.system/skills/ssot/repo/scaffolding/devops-deploy-job/SKILL.md)

8. Related Documents

•/.system/skills/ssot/repo/scaffolding/devops-packaging-job/templates/packaging_template.md - Packaging knowledge template
•/.system/skills/ssot/repo/scaffolding/devops-packaging-service/SKILL.md - Service packaging scaffold
•/.system/skills/ssot/repo/scaffolding/devops-deploy-job/SKILL.md - Job deployment scaffold
•/ops/packaging/AGENTS.md - Packaging strategy