11# Collection for using Mitogen strategy
2- This collection allows for using Mitogen strategy
3- without the need to mess with paths. It also performs
4- live patching for Mitogen restrictions in Ansible
5- versions, making it possible to use Mitogen
6- with the current Ansible version.
2+
3+ This collection allows to use [ Mitogen] ( https://github.com/mitogen-hq/mitogen )
4+ strategy without the need to specify absolute path to the strategy file.
5+
6+ It also performs live patching for Mitogen restrictions in Ansible
7+ versions, making it possible to use Mitogen with the current Ansible version.
78
89Tested versions of ansible-core:
910
1011* 2.14
1112* 2.15
13+ * 2.16
1214
1315It patches ` ansible_mitogen ` code and unpatches it
1416back right after module import, so the original
1517files are kept intact.
1618
1719## Install
18- To use this collection, you need to install Mitogen. Up to a moment you've have
19- to use master from mitogen repo (` pip install git+https://github.com/mitogen-hq/mitogen@master ` ),
20- but there was a release of version 0.3.4 on 2023-07-03 which made it unnecessary.
21-
22- Mitogen installation:
20+ To use this collection, you need to install Mitogen:
2321
2422``` bash
2523pip install mitogen==0.3.4
@@ -50,9 +48,11 @@ You can set `ANSIBLE_STRATEGY` environment variable:
5048ANSIBLE_STRATEGY=serverscom.mitogen.mitogen_linear ansible-playbook ...
5149```
5250
53- ### strategy stanza
51+ (This is my preferred way to use Mitogen).
5452
55- You can use ` strategy ` stanza in a play:
53+ ### Strategy stanza
54+
55+ You can use a ` strategy ` stanza in a play:
5656
5757```
5858- hosts: all
@@ -79,11 +79,11 @@ based on @ITD27M01 idea: https://github.com/mitogen-hq/mitogen/issues/961#issuec
7979# Disclamer
8080Servers.com is not responsible for any problems that may arise
8181during the use of this collection.
82+
8283Mitogen is a separate project (https://github.com/mitogen-hq/mitogen )
8384that is well-known for speeding up Ansible in exchange for multiple
8485stability issues. Servers.com does not provide support for
8586Mitogen-specific issues and may only address issues related
8687to imports and/or patching of Mitogen.
8788
8889If you want to make Mitogen better, please help upstream.
89-
0 commit comments