Skip to content

Conversation

@zawadzkidiana
Copy link

@zawadzkidiana zawadzkidiana commented Oct 22, 2025

Summary
Adds docker-samples directory for quick Cadence onboarding with Docker.

What's included

  • Minimal hello-world Docker sample
  • docker-compose.yml with full Cadence stack
  • quick-start.sh for one-command demo

Note
Originally opened in wrong repo (cadence instead of cadence-samples).
All feedback from initial review has been addressed:

  • Removed duplicate workflows
  • Fixed machine-specific paths
  • Kept it minimal, references main samples for advanced examples

Add containerized hello world workflow with Dockerfile and k8s deployment manifest.

Signed-off-by: Diana Zawadzki <[email protected]>
- Created docker-samples directory with standalone Docker-focused samples
- Added hello-world sample with environment variable configuration
- Created docker-compose.yml orchestrating Cadence server + sample workers
- Added quick-start.sh script for one-command demo
- Added comprehensive documentation for Docker workflows
- Implemented multi-stage Docker build for minimal image size
- Added build optimization with .dockerignore

This enables running Cadence samples in containers, making it easier
for users to get started without local setup. The samples include:
- Basic workflow and activity execution
- Long-running workflow examples
- Environment-based configuration
- Production-ready Docker patterns

The docker-samples directory is self-contained and can be used
independently of the existing samples for quick demonstrations.

---

Note: This work was originally started in the wrong repository (cadence
instead of cadence-samples) as I'm new to the team. After discussion with
David and Ender, we agreed to relocate these files to the correct location.
This commit represents that migration - moving the dockerization work from
the cadence repo to cadence-samples where it belongs.

This was my first project in Cadence, serving as a learning exercise to
understand the workflow system while creating a quick-start Docker setup.
Addressing @timl3136's feedback:

1. Removed long_running_example.go
   - The main samples repo already has 20+ comprehensive workflow examples
   - Keeping docker-samples minimal and focused on quick onboarding
   - Added note in README directing users to main samples for more examples

2. Fixed all machine-specific paths
   - Changed '/path/to/cadence/samples' to 'docker-samples'
   - Removed GOWORK=off flag (not needed in standalone samples)
   - Made all paths relative and portable

3. Updated documentation
   - Clarified that docker-samples is intentionally standalone
   - Referenced main samples directory for advanced patterns
   - Improved quick-start instructions

The docker-samples directory now serves as a minimal, self-contained
quick-start for Docker users, while the main samples directory provides
comprehensive examples for learning advanced Cadence patterns.
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.

1 participant