OCF_HEARTBEAT_PODMAN(7) OCF resource agents OCF_HEARTBEAT_PODMAN(7) NAME ocf_heartbeat_podman - Podman container resource agent. SYNOPSIS podman [start | stop | monitor | meta-data | validate-all] DESCRIPTION The podman HA resource agent creates and launches a podman container based off a supplied podman image. Containers managed by this agent are both cre- ated and removed upon the agent's start and stop actions. SUPPORTED PARAMETERS image The podman image to base this container off of. (required, string, no default) name The name to give the created container. By default this will be that resource's instance name. (optional, string, no default) allow_pull Allow the image to be pulled from the configured podman registry when the image does not exist locally. NOTE, this can drastically increase the time required to start the container if the image repository is pulled over the network. (optional, boolean, no default) run_opts Add options to be appended to the 'podman run' command which is used when creating the container during the start action. This option allows users to do things such as setting a custom entry point and injecting environment variables into the newly created container. Note the '-d' option is supplied regardless of this value to force containers to run in the background. NOTE: Do not explicitly specify the --name argument in the run_opts. This agent will set --name using either the resource's instance or the name provided in the 'name' argument of this agent. (optional, string, no default) run_cmd Specify a command to launch within the container once it has initial- ized. (optional, string, no default) mount_points A comma separated list of directories that the container is expecting to use. The agent will ensure they exist by running 'mkdir -p' (optional, string, no default) monitor_cmd Specify the full path of a command to launch within the container to check the health of the container. This command must return 0 to indi- cate that the container is healthy. A non-zero return code will indi- cate that the container has failed and should be recovered. Note: Using this method for monitoring processes inside a container is not recommended, as containerd tries to track processes running inside the container and does not deal well with many short-lived processes being spawned. Ensure that your container monitors its own processes and terminates on fatal error rather than invoking a command from the outside. (optional, string, no default) force_kill Kill a container immediately rather than waiting for it to gracefully shutdown (optional, boolean, no default) reuse Allow the container to be reused once it is stopped. By default, con- tainers get removed once they are stopped. Enable this option to have the particular one persist when this happens. (optional, boolean, default 0) drop_in_dependency Use transient drop-in files to add extra dependencies to the systemd scopes associated to the container. During reboot, this prevents sys- temd to stop the container before pacemaker. (optional, boolean, no default) SUPPORTED ACTIONS This resource agent supports the following actions (operations): start Starts the resource. Suggested minimum timeout: 90s. stop Stops the resource. Suggested minimum timeout: 90s. monitor Performs a detailed status check. Suggested minimum timeout: 30s. Sug- gested interval: 30s. meta-data Retrieves resource agent metadata (internal use only). Suggested mini- mum timeout: 5s. validate-all Performs a validation of the resource configuration. Suggested minimum timeout: 30s. EXAMPLE CRM SHELL The following is an example configuration for a podman resource using the crm(8) shell: primitive p_podman ocf:heartbeat:podman \ params \ image=string \ op monitor timeout="30s" interval="30s" depth="0" EXAMPLE PCS The following is an example configuration for a podman resource using pcs(8) pcs resource create p_podman ocf:heartbeat:podman \ image=string \ op monitor timeout="30s" interval="30s" OCF_CHECK_LEVEL="0" SEE ALSO http://clusterlabs.org/ AUTHOR ClusterLabs contributors (see the resource agent source for information about individual authors) resource-agents 4.13.0 08/27/2026 OCF_HEARTBEAT_PODMAN(7)
NAME | SYNOPSIS | DESCRIPTION | SUPPORTED PARAMETERS | SUPPORTED ACTIONS | EXAMPLE CRM SHELL | EXAMPLE PCS | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ocf_heartbeat_podman&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>