Skip to content

Commit 6ffa2d8

Browse files
authoredFeb 6, 2024
Merge pull request #16 from serverscom/update_docs
docs: update readme, list supported ansible versions
2 parents 6edb7fa + 010c113 commit 6ffa2d8

File tree

2 files changed

+14
-14
lines changed

2 files changed

+14
-14
lines changed
 

‎README.md

+13-13
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,23 @@
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

89
Tested versions of ansible-core:
910

1011
* 2.14
1112
* 2.15
13+
* 2.16
1214

1315
It patches `ansible_mitogen` code and unpatches it
1416
back right after module import, so the original
1517
files 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
2523
pip install mitogen==0.3.4
@@ -50,9 +48,11 @@ You can set `ANSIBLE_STRATEGY` environment variable:
5048
ANSIBLE_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
8080
Servers.com is not responsible for any problems that may arise
8181
during the use of this collection.
82+
8283
Mitogen is a separate project (https://github.com/mitogen-hq/mitogen)
8384
that is well-known for speeding up Ansible in exchange for multiple
8485
stability issues. Servers.com does not provide support for
8586
Mitogen-specific issues and may only address issues related
8687
to imports and/or patching of Mitogen.
8788

8889
If you want to make Mitogen better, please help upstream.
89-

‎galaxy.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
namespace: serverscom
33
name: mitogen
4-
version: 1.3.5
4+
version: 1.3.6
55
readme: README.md
66
authors:
77
- Sergey Putko <psvmcc+ansible-galaxy@gmail.com>

0 commit comments

Comments
 (0)