XTesting/kubespray/docs/mitogen.md

   1 # Mitogen
   2
   3 *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.
   4
   5 [Mitogen for Ansible](https://mitogen.networkgenomics.com/ansible_detailed.html) 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.
   6
   7 ## Install
   8
   9 ```ShellSession
  10 ansible-playbook contrib/mitogen/mitogen.yml
  11 ```
  12
  13 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:
  14
  15 ```ShellSession
  16 export ANSIBLE_STRATEGY=mitogen_linear
  17 export ANSIBLE_STRATEGY_PLUGINS=plugins/mitogen/ansible_mitogen/plugins/strategy
  18 ```
  19
  20 ... or `ansible.cfg` setup:
  21
  22 ```ini
  23 [defaults]
  24 strategy_plugins = plugins/mitogen/ansible_mitogen/plugins/strategy
  25 strategy=mitogen_linear
  26 ```
  27
  28 ## Limitation
  29
  30 If you are experiencing problems, please see the [documentation](https://mitogen.networkgenomics.com/ansible_detailed.html#noteworthy-differences).