#storage #environment #interface #node #build-environment #github #admin


Official Ceph-rust. A rust-lang specific interface to Ceph librados and Admin Sockets. You can create a Ceph development environment with the Chef automation tools: https://github.com/bloomberg/chef-bcs or with ceph-ansible. Chef-bcs uses the ceph-chef cookbook created and manage at github.com/ceph/ceph-chef. It will build out a full Ceph environment which you can then use for development etc. See README.md for details.

21 releases (13 stable)

3.2.5 Apr 5, 2021
3.2.4 May 11, 2020
3.2.3 Apr 16, 2020
3.1.0 Nov 18, 2019
0.3.0 Nov 5, 2015

#241 in Filesystem

Used in 2 crates


5.5K SLoC

Contains (WOFF font, 120KB) docs/Heuristica-Italic.woff, (WOFF font, 90KB) docs/FiraSans-Medium.woff, (WOFF font, 92KB) docs/FiraSans-Regular.woff, (WOFF font, 56KB) docs/SourceCodePro-Regular.woff, (WOFF font, 56KB) docs/SourceCodePro-Semibold.woff, (WOFF font, 49KB) docs/SourceSerifPro-Bold.woff and 1 more.

Ceph Rust

Official Ceph Rust interface

Build Status Version info

Official Ceph Rust-lang interface. Contributions welcomed!

This library is the core librados Rust interface for Ceph. It also supports Admin Socket commands.

Build requirements

Librados must be installed.

On CentOS/RHEL - Ceph Hammer librados is located in /usr/lib64. So, to get rust to see it you need to create a new symlink: sudo ln -s /usr/lib64/librados.so.2.0.0 /usr/lib64/librados.so

On Ubuntu - Ceph Hammer librados is located in /usr/lib. So, to get rust to see it you need to create a new symlink: sudo ln -s /usr/lib/librados.so.2.0.0 /usr/lib/librados.so

There may be another way to change the link name in rust without having to create a symlink.

On MacOS, you can install librados via homebrew:

$ brew tap zeichenanonym/ceph-client
$ brew install ceph-client


Create a Ceph development environment or use an existing Ceph environment.

If creating a Ceph environment then use the following. It will generate a 4 node Virtual Box Ceph system with one node being a bootstrap node that controls the other. The remaining 3 nodes are Ceph nodes (Mons, OSDs, RGWs, APIs).

Created and manage github.com/ceph/ceph-chef (Chef cookbooks for Ceph) and the Bloomberg github.com link below for chef-bcs. Chef-bcs uses ceph-chef. These are the same tools at Bloomberg.

Requirements for Mac OSX:

  1. VirtualBox
  2. git
  3. Locate an area where you would like to install the Ceph build environment
  4. git clone https://github.com/bloomberg/chef-bcs.git
$ cd chef-bcs
$ cd /bootstrap/vms/vagrant

NOTE: If using the latest version of chef-bcs, you can enable an automatic development environment to be built with all of the development tools. See the project for details. It does it by default for Vagrant build.

This will take about 30 minutes to build out. It installs CentOS 7.3, downloads all of the parts required to get Ceph up and running with good options.

Once complete you can then login to the first node:

$ vagrant ssh ceph-vm1

Run ceph -s to make sure you see Ceph running. Now you can install the development environment and Rust.


(In ceph-vm1 node)

curl -sSf https://static.rust-lang.org/rustup.sh | sh


curl https://sh.rustup.rs -sSf | sh


(In ceph-vm1 node) - Note: This is automatically done for you if you installed the environment vi Chef-bcs as noted above.

mkdir -p projects/lambdastack
cd projects/lambdastack

Requirements for development:
sudo yum install -y git cmake
sudo yum install -y openssl openssl-devel

Clone ceph-rust project:

git clone https://github.com/lambdastackio/ceph-rust.git

NOTE: Make sure you have setup your favorite editor. Vim is automatically installed.

AWS S3 Object Store

Crate (library): aws-sdk-rust at https://github.com/lambdastackio/aws-sdk-rust

AWS S3 CLI Utility

Crate (binary): s3lsio at https://github.com/lambdastackio/s3lsio

Ceph Admin Commands

An example of finding a mon socket in a generic like environment.

ceph-conf --name mon.$(hostname -s) --show-config-value admin_socket

The raw admin_socket commands can be found in: /src/ceph_admin_socket_mon_commands.json /src/ceph_admin_socket_osd_commands.json /src/ceph_admin_socket_client_commands.json

A number of them are the same.

Portions originated from Chris Holcombe at https://github.com/cholcombe973


~97K SLoC