pain

A distributed storage system.

Prerequisites

• xmake
• python3
• ansible

# install xmake
curl -fsSL https://xmake.io/shget.text | bash

# install ansible
sudo apt install ansible

# install prometheus roles
ansible-galaxy collection install prometheus.prometheus

Build

• Config your project with debug mode.

./pain.py config -m debug

• Build

# build and install to ${PROJECT_DIR}/output
./pain.py build -i/--install

• More commands

# build without install
./pain.py build

# only build sad target
./pain.py build sad

# format your project and it's useful before pulling a request
./pain.py format

Using ./pain.py -h for more information.

Deploy

Pain provide a easy ansible script to deploy minimal cluster

# deploy deva/manusya
ansible-playbook -i ./deploy/hosts ./deploy/deploy.yml -t start

# deploy jaeger
ansible-playbook -i ./deploy/hosts ./deploy/deploy.yml -t start-jaeger

# deploy promethues
ansible-playbook -i ./deploy/hosts ./deploy/deploy.yml -t start-prometheus

Trace

Pain supports opentelemetry. You can install jaeger using follow command.

docker run --rm \
  -e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \
  -p 16686:16686 \
  -p 4317:4317 \
  -p 4318:4318 \
  -p 9411:9411 \
  jaegertracing/all-in-one:latest

SDK Examples

#include <pain/pain.h>

int main() {
    auto fs = pain::FileSystem::create("list://192.168.10.1:8001,192.168.10.2:8001,192.168.10.3:8001");
    auto file = fs->open("/tmp/hello.txt", O_CREAT | O_WRONLY);
    pain::core::FileService::Stub stub(file.get());
    pain::Controller cntl;
    pain::core::AppendRequest request;
    pain::core::AppendResponse response;
    
    request.set_direct_io(true);
    cntl.request_attachment().append("hello world");
    stub.append(&cntl, &request, &response, nullptr);
    if (cntl.Failed()) {
        std::cerr << "append failed: " << cntl.ErrorText() << std::endl;
        return 1;
    }
    std::cout << "append success, offset: " << response.offset() << std::endl;
    return 0;
}