Module - tripleo_derive_hci_parameters

This module provides for the following ansible plugin:

  • tripleo_derive_hci_parameters

Module Documentation

When collocating Ceph OSDs on Nova Compute hosts (hyperconverged or hci) the Nova Scheduler does not take into account the CPU/Memory needs of the OSDs. This module returns recommended NovaReservedHostMemory and NovaCPUAllocationRatio parmaters so that the host reseves memory and CPU for Ceph. The values are based on workload description, deployment configuration, and Ironic data. The workload description is the expected average_guest_cpu_utilization_percentage and average_guest_memory_size_in_mb.

Options

tripleo_environment_parameters

Map from key environment_parameters from stack_data. Used to determine number of OSDs in deployment per role

tripleo_role_name

TripleO role name whose parameters are being derived

introspection_data

Output of the tripleo_get_introspected_data module. Used to determine available memory and CPU of each instance from any role with the CephOSD service

average_guest_cpu_utilization_percentage

Percentage of CPU utilization expected for average guest, e.g. 99 means 99% and 10 means 10%

average_guest_memory_size_in_mb

Amount of memory in MB required by the average guest

derived_parameters

any previously derived parameters which should be included in the final result

new_heat_environment_path

Path to file new where resultant derived parameters will be written; result will be valid input to TripleO client, e.g. /home/stack/derived_paramaters.yaml

append_new_heat_environment_path

If new_heat_environment_path already exists and append_new_heat_environment_path is true, then append new content to the existing new_heat_environment_path instead of overwriting a new version of that file.

report_path

Path to file new where a report on how HCI paramters were derived be written, e.g. /home/stack/hci_derived_paramaters.txt

Authors

John Fulton (fultonj)

Example Tasks

- name: Add Derived HCI parameters to existing derived parameters for ComputeHCI role
  tripleo_derive_hci_parameters:
    tripleo_environment_parameters: '{{ tripleo_environment_parameters }}'
    introspection_data: '{{ hw_data }}'
    derived_parameters: '{{ derived_parameters }}'
    tripleo_role_name: ComputeHCI
    average_guest_cpu_utilization_percentage: 90
    average_guest_memory_size_in_mb: 8192
    new_heat_environment_path: /home/stack/hci_result.yaml
    report_path: /home/stack/hci_report.txt
  register: derived_parameters_result
- name: Show derived HCI Memory result
  debug:
    msg: "{{ derived_parameters_result['derived_parameters']['ComputeHCIParameters']['NovaReservedHostMemory']\
      \ }}"
- name: Show derived HCI CPU result
  debug:
    msg: "{{ derived_parameters_result['derived_parameters']['ComputeHCIParameters']['NovaCPUAllocationRatio']\
      \ }}"