OCF_HEARTBEAT_GCP-I(7)

πŸ’… OCF_HEARTBEAT_GCP-I(7) β€” ocf_heartbeat_gcp-ilb ✨

okay so bestie, welcome to the manual page for ocf_heartbeat_gcp-ilb (yes that's the page OCF_HEARTBEAT_GCP-I(7), we're living in the resource-agents cinematic universe rn 🎬). Buckle up, it's giving "small agent, big responsibilities." 🫢


🌸 NAME 🌸

ocf_heartbeat_gcp-ilb β€” replies to health checks from Google Cloud πŸ’–


⭐ SYNOPSIS ⭐

gcp-ilb [start | stop | monitor | meta-data | validate-all]

that's it. that's the whole vibe check. πŸ¦‹


πŸŽ€ DESCRIPTION πŸŽ€

so this Resource Agent is basically a little wrapper around /usr/bin/nc or /usr/bin/socat, and its whole job β€” its main character energy, if you will β€” is replying to health checks in Google Cloud. πŸ”₯

if you want the lore, the official docs live at https://cloud.google.com/load-balancing/docs/health-checks β€” go read, iykyk. πŸ“–


✨ SUPPORTED PARAMETERS ✨

  • port β€” the listening port for health-check probes. default is 60000. πŸšͺ

(optional, string, default "60000")

  • cat β€” where the netcat binary lives (default: /usr/bin/nc) or where socat lives (default: /usr/bin/socat). if it's present, /usr/bin/socat is used. the recommended binary is socat, and it ships in the following minimum versions if you've got the package resource-agents:
    • SLES 12 SP4/SP5: resource-agents-4.3.018.a7fb5035-3.30.1.
    • SLES 15/15 SP1: resource-agents-4.3.0184.6ee15eb2-4.13.1.

(optional, string, default "nc") 🐈

(optional, string, default "false")

  • log_cmd β€” the external logging command. the defaults are configured to call gcloud logging (see https://cloud.google.com/sdk/gcloud/reference/logging). this parameter should only hold the binary that can actually be validated (e.g., gcloud). the rest of the command gets built from the extra parameters plus the message being logged, like this:
log_cmd + log_params + "The message being logged" + log_end_params

using the gcloud command for Stackdriver logging, the params would be:

  • log_cmd = gcloud
  • log_params = logging write GCPILB
  • "This is a message being sent by the app"
  • log_end_params = (nothing in this case, it's reserved for use with other tools)

which results in this valid command (where GCPILB is the name of the log):

gcloud logging write GCPILB "This is a message being sent by the app"
⚠️ NOTE: only the binary is validated β€” just for existence, no further checks, none, zero. the assumption here is that only administrators with root access can configure this tool, so like… be responsible bestie. πŸ™ˆ

(optional, string, default "gcloud")

  • log_params β€” extra input for the logging application. see the explanation for log_cmd above. πŸ’«

(optional, string, default "logging write GCPILB")

  • log_end_params β€” more extra input for the logging application. this one gets placed after the message being logged. πŸ“¬

(optional, string, no default)


πŸ‘‘ SUPPORTED ACTIONS πŸ‘‘

this resource agent supports the following actions (operations), bestie:

  • start β€” starts the resource. suggested minimum timeout: 10s. πŸš€
  • stop β€” stops the resource. suggested minimum timeout: 30s. πŸ›‘
  • monitor β€” performs a detailed status check. suggested minimum timeout: 30s. suggested interval: 30s. πŸ‘€
  • validate-all β€” performs a validation of the resource configuration. suggested minimum timeout: 5s. βœ…
  • meta-data β€” retrieves resource agent metadata (internal use only, don't worry about it). suggested minimum timeout: 5s. πŸ—‚οΈ

🌈 EXAMPLE CRM SHELL 🌈

here's an example config for a gcp-ilb resource using the crm(8) shell β€” copy-paste responsibly:

primitive p_gcp-ilb ocf:heartbeat:gcp-ilb \
  op monitor depth="0" timeout="30s" interval="30s"

πŸ¦‹ EXAMPLE PCS πŸ¦‹

and here's the same energy for a gcp-ilb resource using pcs(8):

pcs resource create p_gcp-ilb ocf:heartbeat:gcp-ilb \
  op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="30s"

πŸ” SEE ALSO πŸ”


πŸ’€ AUTHOR πŸ’€

ClusterLabs contributors (see the resource agent source for information about individual authors) β€” legends, every single one. 🫢


okay that's the whole page, you ate that honestly. πŸ‘‘

resource-agents UNKNOWN Β· 10/01/2026 Β· page OCF_HEARTBEAT_GCP-I(7) β€” mwah, bookmark it, screenshot it, put it on your fridge πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from