ceph-test

Single-node Ceph cluster (mon + mgr + osd + rgw) in one container, for testing. Based on quay.io/ceph/ceph. Multiarch: linux/amd64 and linux/arm64.

docker run -d --name ceph -p 8080:8080 ghcr.io/arttor/ceph-test:v20

With an S3 user:

docker run -d --name ceph \
  -e CEPH_DEMO_ACCESS_KEY=mykey \
  -e CEPH_DEMO_SECRET_KEY=mysecret \
  -p 8080:8080 \
  ghcr.io/arttor/ceph-test:v20

Check status: docker exec ceph ceph -s

With the dashboard:

docker run -d --name ceph \
  -e CEPH_DASHBOARD=true \
  -p 8080:8080 -p 8443:8443 \
  ghcr.io/arttor/ceph-test:v20

Then open http://localhost:8443 and log in with admin / admin.

For a full dashboard playground (Prometheus + Grafana + Alertmanager, plus a multi-cluster example), see compose/.

Files placed in /etc/ceph/ceph.conf.d/*.conf are also appended to ceph.conf at startup — handy for injecting RGW Keystone or other settings via volume mounts or testcontainers file injection.

By default nothing persists between containers — each start creates a fresh cluster. To keep data across restarts, mount a volume at /var/lib/ceph; if it already contains a cluster the container reuses it instead of running mkfs.

docker run -d --name ceph -v ceph-data:/var/lib/ceph -p 8080:8080 ghcr.io/arttor/ceph-test:v20

Use a named volume (as above), not a bind mount to a host path. On macOS, BlueStore mkfs fails on a Docker Desktop file share, so a bind mount for /var/lib/ceph does not work; named volumes live in the Docker VM and work fine.

Mount /etc/ceph to share ceph.conf and keyrings with a client container.

Inject extra ceph.conf settings via env var:

docker run -d --name ceph \
  -e 'CEPH_EXTRA_CONF=
[client.rgw.demo]
rgw keystone api version = 3
rgw keystone url = http://keystone:5000
rgw s3 auth use keystone = true' \
  ghcr.io/arttor/ceph-test:v20

or a mounted config file:

echo '[client.rgw.demo]
rgw keystone api version = 3
rgw keystone url = http://keystone:5000' > keystone.conf

docker run -d --name ceph \
  -v $(pwd)/keystone.conf:/etc/ceph/ceph.conf.d/keystone.conf:ro \
  ghcr.io/arttor/ceph-test:v20

With testcontainers (Go), inject via the Files field:

req := testcontainers.ContainerRequest{
    Image: "ghcr.io/arttor/ceph-test:v20",
    Files: []testcontainers.ContainerFile{{
        Reader:            strings.NewReader(keystoneConf),
        ContainerFilePath: "/etc/ceph/ceph.conf.d/keystone.conf",
        FileMode:          0o644,
    }},
}

docker build -t ceph-test:latest .

With a specific Ceph version:

docker build --build-arg CEPH_VERSION=v20.2.2 -t ceph-test:v20 .