Ceph Create
CertifiedCreate a Ceph pool
Ceph Create
Create a Ceph pool
Calls POST /api/pool. Some Ceph versions process pool creation asynchronously via the Dashboard task manager, so the follow-up fetch of the resulting pool may briefly 404 right after the POST; this task retries it for up to ~10 seconds (10 attempts, 1s apart) before failing.
type: io.kestra.plugin.ceph.pools.CreateExamples
Create a replicated Ceph pool
id: create_ceph_pool
namespace: company.team
tasks:
- id: create_pool
type: io.kestra.plugin.ceph.pools.Create
host: "ceph-mgr.internal"
username: "admin"
password: "{{ secret('CEPH_DASHBOARD_PASSWORD') }}"
poolName: "archive"
poolType: REPLICATED
size: 3
pgNum: 32
Properties
host *Requiredstring
Ceph Dashboard host
Hostname or IP address of the Ceph Manager Dashboard. Must be reachable from the Kestra worker.
poolName *Requiredstring
Pool name
Name of the pool to create.
applicationMetadata array
Application metadata
Application tags to enable on the pool, e.g. ["rbd"] or ["rgw"].
password string
Password
Password for the Ceph Dashboard account. Never logged. Required unless token is set; ignored otherwise.
pgNum integerstring
32Placement group count
Number of placement groups for the pool. Must be a positive power of two for optimal distribution. Defaults to 32.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
poolType string
REPLICATEDREPLICATEDERASUREPool type
Replication strategy: REPLICATED or ERASURE. Defaults to REPLICATED.
port integerstring
8443Ceph Dashboard port
TCP port of the Ceph Manager Dashboard REST API. Defaults to 8443.
size integerstring
3Replica size
Number of data replicas for a REPLICATED pool. Ignored for ERASURE pools. Defaults to 3.
skipSsl booleanstring
falseSkip 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.
token string
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 string
Username
Ceph Dashboard account used to obtain a session token from POST /api/auth. Required unless token is set.
Outputs
application_metadata array
Application metadata
Application tags enabled on the pool, e.g. rbd or rgw.
pg_num integer
Placement group count
Number of placement groups.
pg_placement_num integer
Placement group placement count
Number of placement groups used for placement.
pool integer
Pool ID
Numeric identifier Ceph assigned to the pool.
pool_name string
Pool name
Name of the pool.
size integer
Replica size
Number of data replicas for a replicated pool.
