FreeBSD Manual Pages
OCF_HEARTBEAT_DOCKER(7) OCF resource agents OCF_HEARTBEAT_DOCKER(7) NAME ocf_heartbeat_docker-compose - This script manages docker services using docker-compose. SYNOPSIS docker-compose [start | stop | monitor | meta-data | validate-all] DESCRIPTION Manages docker services using docker-compose as an OCF resource in an High Availability setup. It relies on a well-tested docker compose YAML file which distributed on an identical location on all cluster nodes. Caveat: 1. A YAML file (docker-compose.yml) and an optional Dockerfile must be provided in a working directory. 2. It is suggested to test run the docker-compose and verify on all cluster nodes before enabling this agent. SUPPORTED PARAMETERS binpath The docker-composer binary path. For example, "/usr/bin/docker-compose" (optional, string, default "/usr/bin/docker-compose") dirpath The directory contains docker compose yaml file. For example, "/data/docker" (required, string, no default) ymlfile The docker-compose yaml file. For example, "docker-compose.yml" (optional, string, default "docker-compose.yml") SUPPORTED ACTIONS This resource agent supports the following actions (operations): start Starts the resource. Suggested minimum timeout: 240s. stop Stops the resource. Suggested minimum timeout: 20s. monitor Performs a detailed status check. Suggested minimum timeout: 10s. Suggested interval: 60s. validate-all Performs a validation of the resource configuration. Suggested minimum timeout: 5s. meta-data Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s. EXAMPLE CRM SHELL The following is an example configuration for a docker-compose resource using the crm(8) shell: primitive p_docker-compose ocf:heartbeat:docker-compose \ params \ dirpath=string \ op monitor depth="0" timeout="10s" interval="60s" EXAMPLE PCS The following is an example configuration for a docker-compose resource using pcs(8) pcs resource create p_docker-compose ocf:heartbeat:docker-compose \ dirpath=string \ op monitor OCF_CHECK_LEVEL="0" timeout="10s" interval="60s" SEE ALSO http://clusterlabs.org/ AUTHOR ClusterLabs contributors (see the resource agent source for information about individual authors) resource-agents 4.13.0 04/12/2025 OCF_HEARTBEAT_DOCKER(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_docker-compose&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>