Ceph Clone

Ceph Clone

Certified

Clone an RBD snapshot into a new image

Calls POST /api/block/image/{image_spec}/snap/{snapshot_name}/clone, creating a new copy-on-write image backed by the snapshot. Some Ceph versions process this asynchronously via the Dashboard task manager; this task issues the request and immediately fetches the resulting child image, which may briefly reflect an in-progress state until Ceph finishes cloning it.

yaml
type: io.kestra.plugin.ceph.rbd.snapshots.Clone

Clone an RBD snapshot into a new image

yaml
id: clone_rbd_snapshot
namespace: company.team

tasks:
  - id: clone
    type: io.kestra.plugin.ceph.rbd.snapshots.Clone
    host: "ceph-mgr.internal"
    username: "admin"
    password: "{{ secret('CEPH_DASHBOARD_PASSWORD') }}"
    poolName: "rbd"
    imageName: "data-volume"
    snapshotName: "before-migration"
    childPoolName: "rbd"
    childImageName: "data-volume-clone"
Properties

Destination image name

Name of the new cloned image.

Destination pool name

Pool the new cloned image is created in.

Ceph Dashboard host

Hostname or IP address of the Ceph Manager Dashboard. Must be reachable from the Kestra worker.

Image name

Name of the source RBD image holding the snapshot.

Pool name

Pool of the source image holding the snapshot.

Snapshot name

Name of the snapshot to clone from.

Password

Password for the Ceph Dashboard account. Never logged. Required unless token is set; ignored otherwise.

Reference (ref) of the pluginDefaults to apply to this task.

Default8443

Ceph Dashboard port

TCP port of the Ceph Manager Dashboard REST API. Defaults to 8443.

Defaultfalse

Skip TLS certificate verification

When true, disables TLS certificate verification. Useful when the Ceph Manager Dashboard uses a self-signed certificate, which is the default on most Ceph deployments. Defaults to false (secure): enable it explicitly and only for trusted networks.

Pre-obtained JWT

A JWT obtained from POST /api/auth, used directly instead of username/password. Reused as-is for every request in the execution. It expires (Ceph default 8h TTL) and is NOT auto-renewed, so do not use it in triggers or scheduled flows; use username/password there instead. Mutually exclusive with password: when set, username/password are ignored.

Username

Ceph Dashboard account used to obtain a session token from POST /api/auth. Required unless token is set.

Image name

Name of the RBD image.

Object size

Size of the RADOS objects backing the image, in bytes.

Pool name

Name of the pool the image belongs to.

Size

Size of the image in bytes.