spiegel_podman/docs/source/markdown
Valentin Rothberg fb536046a3 health check: add on-failure actions
For systems that have extreme robustness requirements (edge devices,
particularly those in difficult to access environments), it is important
that applications continue running in all circumstances. When the
application fails, Podman must restart it automatically to provide this
robustness. Otherwise, these devices may require customer IT to
physically gain access to restart, which can be prohibitively difficult.

Add a new `--on-failure` flag that supports four actions:

- **none**: Take no action.

- **kill**: Kill the container.

- **restart**: Restart the container.  Do not combine the `restart`
               action with the `--restart` flag.  When running inside of
               a systemd unit, consider using the `kill` or `stop`
               action instead to make use of systemd's restart policy.

- **stop**: Stop the container.

To remain backwards compatible, **none** is the default action.

Backport of commit aad29e759c

BZ: https://bugzilla.redhat.com/show_bug.cgi?id=2097708
Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2022-09-27 10:40:36 +02:00
..
links Add podman image/container inspect man pages 2021-09-20 12:06:26 -04:00
podman-attach.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-auto-update.1.md [CI:DOCS] man pages: fix inconsistencies 2022-05-11 13:14:08 -06:00
podman-build.1.md Document behavior of --timestamp when only FROM is used 2022-08-10 16:46:05 -04:00
podman-commit.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-completion.1.md Merge pull request #12193 from yahavi/patch-1 2021-11-11 16:17:41 +01:00
podman-container-checkpoint.1.md Add support for checkpoint image 2022-04-20 18:55:39 +01:00
podman-container-cleanup.1.md Fix spelling "setup" -> "set up" and similar 2022-06-22 18:39:21 +02:00
podman-container-clone.1.md [CI:DOCS] man pages: replace -c with --cpu-shares 2022-07-26 13:09:08 -04:00
podman-container-diff.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-container-exists.1.md [CI:DOCS] Fix typos and improve language 2022-01-24 19:34:36 +01:00
podman-container-inspect.1.md Add support for ipc namespace modes "none, private, sharable" 2022-04-12 13:35:51 -04:00
podman-container-prune.1.md Fix sort ordering of filters 2022-01-27 07:19:02 -05:00
podman-container-restore.1.md Add support for checkpoint image 2022-04-20 18:55:39 +01:00
podman-container-runlabel.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-container.1.md Fix spelling "setup" -> "set up" and similar 2022-06-22 18:39:21 +02:00
podman-cp.1.md podman cp: do not overwrite non-dirs with dirs and vice versa 2022-06-10 09:42:19 +02:00
podman-create.1.md health check: add on-failure actions 2022-09-27 10:40:36 +02:00
podman-diff.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-events.1.md Add podman events -f to be alias for --filter 2022-07-26 13:15:45 -04:00
podman-exec.1.md [CI:DOCS] Rewrite --env docs 2022-06-19 09:56:46 +02:00
podman-export.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-generate-kube.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-generate-systemd.1.md [CI:DOCS] podman-generate-systemd.1.md: document --sdnotify 2022-07-26 14:46:25 -04:00
podman-generate.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-healthcheck-run.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-healthcheck.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-history.1.md [CI:DOCS] man pages: fix inconsistencies 2022-05-11 13:14:08 -06:00
podman-image-diff.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-image-exists.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-image-inspect.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-image-mount.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-image-prune.1.md Fix sort ordering of filters 2022-01-27 07:19:02 -05:00
podman-image-scp.1.md Update test output expectation 2022-06-02 16:05:05 -04:00
podman-image-sign.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-image-tree.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-image-trust.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-image-unmount.1.md Run codespell on code 2022-04-22 06:18:20 -04:00
podman-image.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-images.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-import.1.md Makefile: use order-only prereq for podman-remote 2022-07-26 14:40:08 -04:00
podman-info.1.md podman info: hide --debug 2022-08-10 16:46:05 -04:00
podman-init.1.md Unify examples section across several man pages: init/kill 2022-04-04 22:46:28 +02:00
podman-inspect.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-kill.1.md First batch of resolutions to FIXMEs 2022-05-25 13:28:04 -04:00
podman-load.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-login.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-logout.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-logs.1.md Add option for pod logs to display different colors per container. 2022-03-29 17:29:13 +02:00
podman-machine-info.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-machine-init.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-machine-inspect.1.md Only allow Rootless runs of Podman Machine 2022-06-29 09:19:09 -04:00
podman-machine-list.1.md Only allow Rootless runs of Podman Machine 2022-06-29 09:19:09 -04:00
podman-machine-rm.1.md Only allow Rootless runs of Podman Machine 2022-06-29 09:19:09 -04:00
podman-machine-set.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-machine-ssh.1.md Only allow Rootless runs of Podman Machine 2022-06-29 09:19:09 -04:00
podman-machine-start.1.md Only allow Rootless runs of Podman Machine 2022-06-29 09:19:09 -04:00
podman-machine-stop.1.md Only allow Rootless runs of Podman Machine 2022-06-29 09:19:09 -04:00
podman-machine.1.md Podman machine info 2022-07-05 15:18:41 -04:00
podman-manifest-add.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-manifest-annotate.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-manifest-create.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-manifest-exists.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-manifest-inspect.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-manifest-push.1.md Add support for creating sigstore signatures, and providing passphrases 2022-08-02 16:52:56 +02:00
podman-manifest-remove.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-manifest-rm.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-manifest.1.md [CI:DOCS] Fix typo in manifest manpage 2022-07-26 13:35:17 -04:00
podman-mount.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-network-connect.1.md docs: remove CNI word where it is not applicable 2022-07-26 14:42:32 -04:00
podman-network-create.1.md docs: remove CNI word where it is not applicable 2022-07-26 14:42:32 -04:00
podman-network-disconnect.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-network-exists.1.md [CI:DOCS] Fix typos and improve language 2022-01-24 19:34:36 +01:00
podman-network-inspect.1.md docs: remove CNI word where it is not applicable 2022-07-26 14:42:32 -04:00
podman-network-ls.1.md docs: remove CNI word where it is not applicable 2022-07-26 14:42:32 -04:00
podman-network-prune.1.md Unify examples section across several man pages 2022-03-28 21:56:13 +02:00
podman-network-reload.1.md Docs rootfull -> rootful 2022-04-25 11:53:57 -04:00
podman-network-rm.1.md docs: remove CNI word where it is not applicable 2022-07-26 14:42:32 -04:00
podman-network.1.md docs: remove CNI word where it is not applicable 2022-07-26 14:42:32 -04:00
podman-pause.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-play-kube.1.md docs: remove CNI word where it is not applicable 2022-07-26 14:42:32 -04:00
podman-play.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-pod-clone.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-pod-create.1.md pod create --share none should not create infra 2022-07-26 14:46:12 -04:00
podman-pod-exists.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-pod-inspect.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-pod-kill.1.md Unify examples section across several man pages: init/kill 2022-04-04 22:46:28 +02:00
podman-pod-logs.1.md Add option for pod logs to display different colors per container. 2022-03-29 17:29:13 +02:00
podman-pod-pause.1.md Unify examples section across several man pages 2022-03-28 21:56:13 +02:00
podman-pod-prune.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-pod-ps.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-pod-restart.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-pod-rm.1.md Unify examples section across several man pages: pod rm/start/unpause 2022-04-05 23:40:07 +02:00
podman-pod-start.1.md Unify examples section across several man pages: pod rm/start/unpause 2022-04-05 23:40:07 +02:00
podman-pod-stats.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-pod-stop.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-pod-top.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-pod-unpause.1.md Unify examples section across several man pages: pod rm/start/unpause 2022-04-05 23:40:07 +02:00
podman-pod.1.md podman pod clone 2022-06-10 14:23:19 -04:00
podman-port.1.md Fix spelling "setup" -> "set up" and similar 2022-06-22 18:39:21 +02:00
podman-ps.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-pull.1.md Podman pull --all-tags shorthand option 2022-07-26 13:27:55 -04:00
podman-push.1.md Add support for creating sigstore signatures, and providing passphrases 2022-08-02 16:52:56 +02:00
podman-remote.1.md Document schema values in the --url flag 2022-02-02 18:07:10 -05:00
podman-rename.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-restart.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-rm.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-rmi.1.md podman rmi --ignore 2022-03-19 10:05:43 +01:00
podman-run.1.md health check: add on-failure actions 2022-09-27 10:40:36 +02:00
podman-save.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-search.1.md podman search: truncate by default 2022-04-28 09:40:46 +02:00
podman-secret-create.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-secret-inspect.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-secret-ls.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-secret-rm.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-secret.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-start.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-stats.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-stop.1.md Podman stop --filter flag 2022-07-26 13:25:36 -04:00
podman-system-connection-add.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-system-connection-default.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-system-connection-list.1.md [CI:DOCS] man pages: fix inconsistencies 2022-05-11 13:14:08 -06:00
podman-system-connection-remove.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-system-connection-rename.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-system-connection.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-system-df.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-system-migrate.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-system-prune.1.md podman system prune support prune unused networks 2022-06-14 14:04:03 +09:00
podman-system-renumber.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-system-reset.1.md podman system reset removed machines incorrectly 2022-05-04 10:31:42 -04:00
podman-system-service.1.md Make it clear the REST API could be a security issue 2022-06-16 09:56:44 -04:00
podman-system.1.md podman system prune support prune unused networks 2022-06-14 14:04:03 +09:00
podman-tag.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-top.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman-unmount.1.md Unify examples section across several man pages 2022-03-28 21:56:13 +02:00
podman-unpause.1.md Unify examples section across several man pages 2022-03-28 21:56:13 +02:00
podman-unshare.1.md podman unshare: document that command cannot be used with remote 2022-03-22 17:54:37 +01:00
podman-untag.1.md [CI:DOCS] Fix typos and improve language 2022-01-24 19:34:36 +01:00
podman-version.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-volume-create.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-volume-exists.1.md [CI:DOCS] Fix typos and improve language 2022-01-24 19:34:36 +01:00
podman-volume-export.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-volume-import.1.md podman-volume-import: Reword "precendence" 2022-08-10 16:46:05 -04:00
podman-volume-inspect.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-volume-ls.1.md man page checker: enforce stricter options format 2022-07-26 13:22:28 -04:00
podman-volume-mount.1.md Add podman volume mount support 2022-02-28 14:26:22 -05:00
podman-volume-prune.1.md man pages: sort flags, and keep them that way 2022-03-23 13:49:42 -06:00
podman-volume-reload.1.md add podman volume reload to sync volume plugins 2022-06-23 18:36:30 +02:00
podman-volume-rm.1.md Add links to all SEE ALSO sections 2021-11-10 09:29:21 -05:00
podman-volume-unmount.1.md Unify examples section across several man pages 2022-03-28 21:56:13 +02:00
podman-volume.1.md add podman volume reload to sync volume plugins 2022-06-23 18:36:30 +02:00
podman-wait.1.md Clarify remote client means Mac and Windows 2022-01-28 08:14:05 -05:00
podman.1.md Add support for passing --volumepath 2022-04-23 08:03:36 -04:00