Skip to content

ClusterLabs/go-pacemaker

Repository files navigation

Pacemaker

This library provides an API for connecting to and working with the Pacemaker cluster manager, specifically with the cluster configuration (the CIB), from the Go programming language.

It is not meant to be a complete API. The main use case is connecting to the CIB, subscribing to updates and reading the XML.

Note: This API is under heavy development.

Current features:

  • Connect and get CIB as an XML []byte block

Major missing features:

  • Decode CIB attributes and status section into a Go object structure

  • Encode status section as JSON

  • Decoding / encoding configuration section

  • Writing changes back to the CIB

  • Get CIB as JSON

  • Get CibObjects as JSON

  • Make changes

  • Create CibObjects

  • Get status of resources and nodes

  • History information

  • Meta information about agents etc.

Compilation

The compile-time dependencies are Pacemaker, glib 2.0 and libxml2.

On openSUSE and similar distributions, this will get you all the dependencies needed to compile:

zypper in libpacemaker-devel libxml2-devel glib2-devel

To run the tests, the pacemaker schema files need to be available as well. These are usually packaged separately, so to get these, you will need to install the pacemaker package as well:

zypper in pacemaker

Usage

See pacemaker_test.go for usage examples.