kubespray/docs/mitogen.md

1.4 KiB

Mitogen

Warning: Mitogen support is now deprecated in kubespray due to upstream not releasing an updated version to support ansible 4.x (ansible-base 2.11.x) and above. The CI support has been stripped for mitogen and we are no longer validating any support or regressions for it. The supporting mitogen install playbook and integration documentation will be removed in a later version.

Mitogen for Ansible allow a 1.25x - 7x speedup and a CPU usage reduction of at least 2x, depending on network conditions, modules executed, and time already spent by targets on useful work. Mitogen cannot improve a module once it is executing, it can only ensure the module executes as quickly as possible.

Install

ansible-playbook contrib/mitogen/mitogen.yml

The above playbook sets the ansible strategy and strategy_plugins in ansible.cfg but you can also enable them if you use your own ansible.cfg by setting the environment varialbles:

export ANSIBLE_STRATEGY=mitogen_linear
export ANSIBLE_STRATEGY_PLUGINS=plugins/mitogen/ansible_mitogen/plugins/strategy

... or ansible.cfg setup:

[defaults]
strategy_plugins = plugins/mitogen/ansible_mitogen/plugins/strategy
strategy=mitogen_linear

Limitation

If you are experiencing problems, please see the documentation.