# go-pacemaker

**Repository Path**: mirrors_ClusterLabs/go-pacemaker

## Basic Information

- **Project Name**: go-pacemaker
- **Description**: Go API for the Pacemaker cluster resource manager
- **Primary Language**: Unknown
- **License**: LGPL-2.1
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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.