blob: 026b580d684508eca10b55ab8f525b91a851d665 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
# Installing
Install Ansible-lint to apply rules and follow best practices with your
automation content.
!!! note
Ansible-lint does not currently support installation on Windows systems.
!!! warning
Ansible-lint does not support any installation methods that are not mentioned in
this document. Before raising any bugs related to installation, review all of
the following details:
- You should use installation methods outlined in this document only.
- You should upgrade the Python installer (`pip` or `pipx`) to the latest
version available from pypi.org. If you used a system package manager, you
will need to upgrade the installer to a newer version.
- If you are installing from a git zip archive, which is not supported but
should work, ensure you use the main branch and the latest version of pip and
setuptools.
- If you are installing Ansible-lint within a container or system package, you
should not report the issue here. Contact the relevant container or package
provider instead.
- If you are using [poetry](https://python-poetry.org/), read this
[discussion](https://github.com/ansible/ansible-lint/discussions/2820#discussioncomment-4400380).
Pull requests to improve installation instructions are welcome. Any new issues
related to installation will be closed and locked.
For a container image, we recommend using
[creator-ee](https://github.com/ansible/creator-ee/), which includes
Ansible-lint. If you have a use case that the `creator-ee` container doesn't
satisfy, please contact the team through the
[discussions](https://github.com/ansible/ansible-lint/discussions) forum.
You can also run Ansible-lint on your source code with the
[Ansible-lint GitHub action](https://github.com/marketplace/actions/ansible-lint)
instead of installing it directly.
## Installing the latest version
You can install the most recent version of Ansible-lint with the [pip3] or
[pipx] Python package manager. Use [pipx] to isolate Ansible-lint from your
current Python environment as an alternative to creating a virtual environment.
```bash
# This also installs ansible-core if it is not already installed
pip3 install ansible-lint
```
## Installing on Fedora and RHEL
You can install Ansible-lint on Fedora, or Red Hat Enterprise Linux (RHEL) with
the `dnf` package manager.
```bash
dnf install ansible-lint
```
!!! note
On RHEL, `ansible-lint` package is part of "Red Hat Ansible Automation
Platform" subscription, which needs to be activated.
## Installing from source code
**Note**: `pip>=22.3.1` is required for installation from the source repository.
Please consult the [PyPA User Guide] to learn more about managing Pip versions.
```bash
pip3 install git+https://github.com/ansible/ansible-lint
```
[installing_from_source]: https://pypi.org/project/pip/
[pip3]: https://pypi.org/project/pip/
[pipx]: https://pypa.github.io/pipx/
[pypa user guide]:
https://packaging.python.org/en/latest/tutorials/installing-packages/#ensure-pip-setuptools-and-wheel-are-up-to-date
|
