Create a runbook snapshot in Octopus Deploy
Usage:
octopus runbook snapshot create [flags]
Aliases:
create, new
Flags:
--git-resource stringArray Git reference for a specific Git resource.
Format as {step}:{git-ref}, {step}:{git-resource-name}:{git-ref}
You may specify this multiple times.
Only relevant for config-as-code projects where runbooks are stored in Git.
-n, --name string Override the snapshot name
--package stringArray Version specification a specific packages.
Format as {package}:{version}, {step}:{version} or {package-ref-name}:{packageOrStep}:{version}
You may specify this multiple times
--package-version string Default version to use for all packages. Only relevant for config-as-code projects where runbooks are stored in Git.
-p, --project string Name or ID of the project where the runbook is
--publish Publish the snapshot immediately
-r, --runbook string Name or ID of the runbook to create the snapshot for
--snapshot-notes string Release notes to attach
--snapshot-notes-file string Release notes to attach (from file)
Global Flags:
-h, --help Show help for a command
--no-prompt Disable prompting in interactive mode
-f, --output-format string Specify the output format for a command ("json", "table", or "basic") (default "table")
-s, --space string Specify the space for operations
Examples
Octopus Samples instance
Many of the examples we use, reference the samples instance of Octopus Deploy. If you’d like to explore the samples instance, you can log in as a guest.
$ octopus runbook snapshot create --project MyProject --runbook "Rebuild DB Indexes"
$ octopus runbook snapshot create --project MyProject --runbook "Rebuild DB Indexes" --name "My cool snapshot"
$ octopus runbook snapshot create -p MyProject -r "Restart App" --package "azure-cli:1.2.3" --no-prompt
$ octopus runbook snapshot create -p MyProject -r "Restart App" --git-resource "Script step from Git:refs/heads/dev-branch" --publish --no-prompt
Learn more
Help us continuously improve
Please let us know if you have any feedback about this page.
Page updated on Wednesday, May 7, 2025