rbmd/README.md

RBMD

RBD mount wrapper cluster

Table of Contents

• RBMD
  • Dependencies
  • Usage
    • Example
  • API
    • GET /status
      • Example
    • GET /node
      • Example
    • GET /health
      • Example
    • POST /mount
    • POST /umount

Dependencies

• Zookeeper
• Access to ceph cluster(for map/unmap images)

Usage

Usage of ./rbmd:
  -listen string
    	HTTP API listen address (default "0.0.0.0:9076")
  -tick int
    	Tick time loop (default 5)
  -zk string
    	Zookeeper servers comma separated (default "127.0.0.1:2181")
  -zkPath string
    	Zookeeper path (default "/rbmd")

Example

./rbmd -listen 127.0.0.1:9908 -zkPath /rbmd-ru-dc3-rack5

API

GET /status

Return JSON of quorum status

Example

 curl 127.0.0.1:9076/status | jq
{
  "quorum": [
    {
      "node": "node.example.org",
      "ip": {
        "v4": [
          "10.0.3.1"
        ],
        "v6": [
          "fe80::108d:fcff:fe77:3df6"
        ]
      },
      "updated": 1483095334,
      "mounts": null
    }
  ],
  "leader": "node.example.org",
  "health": "alive."
}

GET /node

Return JSON of node stats

Example

{
  "node": "difrex-mac.wargaming.net",
  "ip": {
    "v4": [
      "169.254.156.1"
    ],
    "v6": [
      "fe80::108d:fcff:fe77:3df6"
    ]
  },
  "updated": 1483095493,
  "mounts": null
}

GET /health

Return string with quorum health check result

Example

curl 127.0.0.1:9076/health
alive.

POST /mount

Accept JSON. Not implemented yet.

POST /umount

Accept JSON. Not implemented yet.