The outcome
Create a reproducible service artifact with a narrow interface, known rights, and production-ready failure behavior.
Step by step
A workflow you can repeat.
- 01
Define the handler contract, users, input and output schema, model and code licenses, data class, safety, latency, resources, dependencies, errors, and acceptance tests.
- 02
Create a minimal Photon with typed handlers, validate and bound inputs, exclude arbitrary execution and embedded secrets, and pin model, package, and system dependencies.
- 03
Run locally with representative normal, malformed, adversarial, large, concurrent, and failure cases while checking outputs, logs, memory, startup, and health behavior.
- 04
Build and inspect the artifact, record its ID and source revision, scan dependencies, verify no credentials or private data are included, and push it to the correct workspace.
- 05
Deploy privately, smoke-test the generated API contract, compare with local results, and retain the artifact, test evidence, license record, and rollback version.
Working standard
What good use looks like.
- Expose the smallest typed interface.
- Never bake secrets into a Photon.
- Pin every production dependency.
Official references