Module - ceph_pools_pg_protection¶
This module provides for the following ansible plugin:
ceph_pools_pg_protection
Module Documentation¶
The Ceph PG overdose protection check (https://ceph.com/community/new-luminous-pg-overdose-protection) is executed by Ceph before a pool is created. If the check does not pass, then the pool is not created.
When TripleO deploys Ceph it triggers ceph-ansible which creates the pools that OpenStack needs.
This validation runs the same check that the overdose protection uses to determine if the user should update their CephPools, PG count, or number of OSDs. Without this check a deployer may have to wait until after Ceph is running, but before the pools are created to realize the deployment will fail.
Used by the ceph-pg validation.
Owned by the "DFG:Storage Squad:Ceph"
Options¶
- num_osds
The number of Ceph OSDs expected to be running during Pool creation.
TripleO does not have this parameter
In theory you can derive this parameter from TripleO parameters
- ceph_pool_default_size
The same as the TripleO CephPoolDefaultSize parameter
Number of replicas of the data
- ceph_pool_default_pg_num
The same as the TripleO CephPoolDefaultPgNum parameter
The default number of Placement Groups a pool should have
Ceph defaults this number to 16
TripleO defaults this number to 128
- ceph_pools
The same as the TripleO CephPools parameter
A list of dictionaries
Each embedded dict must have a name parameter
Optional pg_num and size parameters may be set per pool
Authors¶
John Fulton (fultonj)
Example Tasks¶
- name: Is the CephPools parameter configured correctly?
ceph_pools_pg_protection:
num_osds: 36
ceph_pool_default_size: 3
ceph_pool_default_pg_num: 128
ceph_pools:
- {name: volumes, pg_num: 1024, pgp_num: 1024, application: rbd, size: 3}
- {name: vms, pg_num: 512, pgp_num: 512, application: rbd, size: 3}
- {name: images, pg_num: 128, pgp_num: 128, application: rbd, size: 3}
register: pool_creation_simulation
- name: Fail if CephPools parameter is not configured correctly
fail:
msg: pool_creation_simulation["message"]
when: not pool_creation_simulation["valid_input"]
# Call this module from within TripleO Heat Templates (if only num_osds was derived)
- name: Is the CephPools parameter configured correctly?
ceph_pools_pg_protection:
num_osds: 36
ceph_pool_default_size: {get_param: CephPoolDefaultSize}
ceph_pool_default_pg_num: {get_param: CephPoolDefaultPgNum}
ceph_pools: {get_param: CephPools}
register: pool_creation_simulation