As a backend project, ceph/go-ceph has picked up 694 stars on GitHub (Go). Go bindings for Ceph :octopus: :octopus: :octopus:
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
The go-ceph project is a collection of API bindings that support the use of
native Ceph APIs, which are C language functions, in Go. These bindings make
use of Go's cgo feature.
There are three main Go sub-packages that make up go-ceph:
rados - exports functionality from Ceph's librados
rbd - exports functionality from Ceph's librbd
cephfs - exports functionality from Ceph's libcephfs
rgw/admin - interact with radosgw admin ops API
We aim to provide comprehensive support for the Ceph APIs over time. This
includes both I/O related functions and management functions. If your project
makes use of Ceph command line tools and is written in Go, you may be able to
switch away from shelling out to the CLI and to these native function calls.
Installation
The code in go-ceph is purely a library module. Typically, one will import
go-ceph in another Go based project. When building the code the native RADOS,
RBD, & CephFS library and development headers are expected to be installed.
On debian based systems (apt) these may be:
libcephfs-dev librbd-dev librados-dev
On rpm based systems (dnf, yum, etc) these may be:
libcephfs-devel librbd-devel librados-devel
On MacOS you can use brew to install the libraries:
brew tap mulbc/ceph-client
brew install ceph-client
NOTE: CentOS users may want to use a
CentOS Storage SIG
repository to enable packages for a supported ceph version.
Example: dnf -y install centos-release-ceph-tentacle.
(CentOS 7 users should use "yum" rather than "dnf")
To quickly test if one can build with go-ceph on your system, run:
go get github.com/ceph/go-ceph
Once compiled, code using go-ceph is expected to dynamically link to the Ceph
libraries. These libraries must be available on the system where the go based
binaries will be run. Our use of cgo and ceph libraries does not allow for
fully static binaries.
go-ceph tries to support different Ceph versions. However some functions might
only be available in recent versions, and others may be deprecated. In order to
work with non-current versions of Ceph, it is required to pass build-tags to
the go command line. A tag with the named Ceph release will enable/disable
certain features of the go-ceph packages, and prevent warnings or compile
problems. For example, to ensure you select the library features that match
the "tentacle" release, use:
go build -tags tentacle ....
go test -tags tentacle ....
Supported Ceph Versions
go-ceph version
Supported Ceph Versions
Deprecated Ceph Versions
v0.42.0
squid, tentacle, umbrella
quincy, reef
v0.41.0
squid, tentacle, umbrella
quincy, reef
v0.40.0
squid, tentacle
pacific, quincy, reef
v0.39.0
squid, tentacle
pacific, quincy, reef
v0.38.0
reef, squid, tentacle
pacific, quincy
v0.37.0
reef, squid, tentacle
pacific, quincy
v0.36.0
reef, squid, tentacle
pacific, quincy
v0.35.0
quincy, reef, squid
octopus, pacific
v0.34.0
pacific, quincy, reef, squid
octopus
v0.33.0
pacific, quincy, reef, squid
octopus
v0.32.0
pacific, quincy, reef, squid
octopus
v0.31.0
pacific, quincy, reef, squid
octopus
v0.30.0
pacific, quincy, reef, squid
octopus
v0.29.0
pacific, quincy, reef
octopus
v0.28.0
pacific, quincy, reef
nautilus, octopus
v0.27.0
pacific, quincy, reef
nautilus, octopus
v0.26.0
pacific, quincy, reef
nautilus, octopus
v0.25.0
pacific, quincy, reef
nautilus, octopus
v0.24.0
pacific, quincy, reef
nautilus, octopus
v0.23.0
pacific, quincy, reef
nautilus, octopus
v0.22.0
pacific, quincy
nautilus, octopus
v0.21.0
pacific, quincy
nautilus, octopus
v0.20.0
pacific, quincy
nautilus, octopus
v0.19.0
pacific, quincy
nautilus, octopus
The tags affect what is supported at compile time. What version of the Ceph
cluster the client libraries support, and vice versa, is determined entirely
by what version of the Ceph C libraries go-ceph is compiled with.
To see what older versions of go-ceph supported refer to the older
releases file in the documentation.
Documentation
Detailed API documentation is available at
https://pkg.go.dev/github.com/ceph/go-ceph.
Some API Hints and How-Tos are also available to quickly
introduce how some of API calls work together.
No homepage URL was recorded for ceph/go-ceph in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How does ceph/go-ceph compare to other Backend projects?
ceph/go-ceph is tracked by TopGit in the Backend category, with 694 GitHub stars and written in Go. Browse the Backend topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does ceph/go-ceph have?
ceph/go-ceph has 694 GitHub stars — refresh the page for the live number, or check github.com/ceph/go-ceph. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is ceph/go-ceph open source?
Yes — ceph/go-ceph ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/ceph/go-ceph.
What else is in the Backend space?
ceph/go-ceph is tracked by TopGit under the Backend category, alongside 7 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is ceph/go-ceph?
ceph/go-ceph (ceph/go-ceph) is a Go project on GitHub. From the project's own README: Go bindings for Ceph :octopus: :octopus: :octopus:
Where do I read more about ceph/go-ceph?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/ceph/go-ceph is the definitive source.
Read full README in the tab above.
Curious whether go-ceph is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about go-ceph.