Skip to content

Conversation

@konokenj
Copy link
Contributor

@konokenj konokenj commented Dec 8, 2025

Summary

Added documentation for creating asynchronous jobs in the webapp README.

Changes

  • Added "Asynchronous Jobs" section explaining how to create Lambda-based background jobs
  • Documented the build process using job.Dockerfile with esbuild
  • Provided two patterns: single-file jobs and jobs with subdirectories
  • Included practical examples based on existing code (async-job-runner.ts and migration-runner.ts)

Key Points

  • All jobs in src/jobs/*.ts are bundled into separate Lambda handlers
  • Simple jobs use a single file; complex jobs use subdirectories for organization
  • No individual Dockerfiles needed - shared job.Dockerfile handles all jobs
  • Jobs must be configured in CDK stack for deployment

The documentation is concise, accurate, and follows the existing project patterns.

Copy link
Contributor

@tmokmss tmokmss left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@tmokmss tmokmss merged commit 5158c0c into aws-samples:main Dec 10, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants