Jobs documentation - #26251
Draft
glours wants to merge 2 commits into
Draft
Jobs documentation#26251glours wants to merge 2 commits into
glours wants to merge 2 commits into
Conversation
Document the experimental jobs feature: one-shot workloads that Docker Engine runs on demand or on a cron schedule, declared with the new top-level jobs element in a Compose file. Add a Compose how-to with a walkthrough that was run against an Engine with the extension turned on, a reference page for the jobs, triggers, and schedule attributes, and an Engine page for turning on the jobs extension and using the docker job commands. Add the "Compose jobs" and "Docker Engine jobs" entries to data/summary.yaml, marked Experimental with no version number because the feature isn't released. Signed-off-by: Guillaume Lours <glours@users.noreply.github.com> Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The profiles reference said that no top-level element other than services is affected by profiles. Jobs honor profiles, so name them as the exception. The init containers page says that scheduled backups are the wrong use for init containers, so point to jobs for that case. Signed-off-by: Guillaume Lours <glours@users.noreply.github.com> Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
github-actions
Bot
added
area/engine
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Add documentation for the experimental jobs feature: one-shot workloads that
Docker Engine runs on demand or on a cron schedule, declared with a new
top-level
jobselement in a Compose file.compose/how-tos/jobs.md)jobs,triggers, andscheduledocker job(
engine/daemon/jobs.md)summary.yamlentries marked Experimental, with no version numberThe extension is off by default, so every page is marked as experimental.
Related issues or tickets
Reviews
Keep as a draft until the Engine, CLI, and Compose changes ship. The
walkthrough was run against an Engine with the extension turned on.
Needs a reviewer's call: the security warning on the Engine page, and whether
the extension is available on Docker Desktop.