mirror of https://github.com/ansible/ansible.git
4 28 docs backportapalooza (#77686)
* docs: Update porting guide for ansible 5.7.0 (#77646) (cherry picked from commitpull/77787/head^2709ae7c050) * remove import_play examples from include module (#77597) (cherry picked from commitd321fa3f15) * trim down to use sanity test docs requirements file (#77612) * trim down to use sanity test docs requirements file * add requirements back Co-authored-by: Felix Fontein <felix@fontein.de> * Update docs/docsite/rst/community/documentation_contributions.rst (cherry picked from commita65fbfad5b) * Typo fix (#77648) (cherry picked from commitcf5f0690f0) * Update guide_vultr.rst (#77665) (cherry picked from commitf6fb402d1f) * add select distro installs to docs (#77567) (cherry picked from commit096393a221) * community_steering_committee.rst: add new member (#77589) (cherry picked from commit3cbfee7852) * clarify latest release (#77577) * clarify latest release * fix tables (cherry picked from commitf633b62cbc) * typo in doc (#77672) (cherry picked from commitc71faec595) Co-authored-by: David Moreau Simard <moi@dmsimard.com> Co-authored-by: deosrc <deosrc@g-de.co.uk> Co-authored-by: Jan-Piet Mens <jp@mens.de> Co-authored-by: Andrew Klychkov <aklychko@redhat.com> Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
Sandra McCann
2 years ago
committed by
GitHub
parent
f4f1f772c1
commit
a07e3eb45b
@ -1,19 +0,0 @@
|
||||
# pip packages required to build docsite
|
||||
# tested Nov 11 2021
|
||||
# NOTE - this file must align with CI test for docs-build at
|
||||
# test/sanity/code-smell/docs-build.requirements.txt
|
||||
# test/sanity/code-smell/rstcheck.requirements.txt
|
||||
|
||||
antsibull-docs == 1.0.0
|
||||
# sphinx 4.2.0 requires docutils < 0.18
|
||||
docutils == 0.17.1
|
||||
jinja2 == 3.0.3
|
||||
pygments == 2.10.0
|
||||
pyyaml == 6.0
|
||||
resolvelib == 0.5.4
|
||||
rstcheck == 3.3.1
|
||||
sphinx == 4.2.0
|
||||
sphinx-notfound-page == 0.8 # must be >= 0.6
|
||||
sphinx-intl == 2.0.1
|
||||
sphinx-ansible-theme === 0.9.1
|
||||
straight.plugin == 1.5.0 # Needed for hacking/build-ansible.py which is the backend build script
|
||||
@ -0,0 +1,110 @@
|
||||
.. _installing_distros:
|
||||
|
||||
Installing Ansible on specific operating systems
|
||||
================================================
|
||||
|
||||
The ``ansible`` package can always be :ref:`installed from PyPI using pip <intro_installation_guide>` on most systems but it is also packaged and maintained by the community for a variety of Linux distributions.
|
||||
|
||||
The following instructions will guide you through installing the ``ansible`` package with your preferred distribution's package manager.
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
|
||||
Installing Ansible on Fedora or CentOS
|
||||
--------------------------------------
|
||||
|
||||
On Fedora:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ sudo dnf install ansible
|
||||
|
||||
On CentOS:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ sudo yum install epel-release
|
||||
$ sudo yum install ansible
|
||||
|
||||
RPMs for currently supported versions of CentOS are also available from `EPEL <https://fedoraproject.org/wiki/EPEL>`_.
|
||||
|
||||
|
||||
.. _from_apt:
|
||||
|
||||
Installing Ansible on Ubuntu
|
||||
----------------------------
|
||||
|
||||
Ubuntu builds are available `in a PPA here <https://launchpad.net/~ansible/+archive/ubuntu/ansible>`_.
|
||||
|
||||
To configure the PPA on your system and install Ansible run these commands:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ sudo apt update
|
||||
$ sudo apt install software-properties-common
|
||||
$ sudo add-apt-repository --yes --update ppa:ansible/ansible
|
||||
$ sudo apt install ansible
|
||||
|
||||
.. note:: On older Ubuntu distributions, "software-properties-common" is called "python-software-properties". You may want to use ``apt-get`` rather than ``apt`` in older versions. Also, be aware that only newer distributions (that is, 18.04, 18.10, and later) have a ``-u`` or ``--update`` flag. Adjust your script as needed.
|
||||
|
||||
|
||||
|
||||
|
||||
Installing Ansible on Debian
|
||||
----------------------------
|
||||
|
||||
Debian users can use the same source as the Ubuntu PPA (using the following table).
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
|
||||
* - Debian
|
||||
-
|
||||
- Ubuntu
|
||||
* - Debian 11 (Bullseye)
|
||||
- ->
|
||||
- Ubuntu 20.04 (Focal)
|
||||
* - Debian 10 (Buster)
|
||||
- ->
|
||||
- Ubuntu 18.04 (Bionic)
|
||||
|
||||
|
||||
.. note::
|
||||
|
||||
Ansible releases are only built for Ubuntu 18.04 (Bionic) or later releases.
|
||||
|
||||
Add the following line to ``/etc/apt/sources.list`` or ``/etc/apt/sources.list.d/ansible.list``:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
deb http://ppa.launchpad.net/ansible/ansible/ubuntu MATCHING_UBUNTU_CODENAME_HERE main
|
||||
|
||||
Example for Debian 11 (Bullseye)
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
deb http://ppa.launchpad.net/ansible/ansible/ubuntu focal main
|
||||
|
||||
Then run these commands:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 93C4A3FD7BB9C367
|
||||
$ sudo apt update
|
||||
$ sudo apt install ansible
|
||||
|
||||
|
||||
|
||||
.. _from_windows:
|
||||
|
||||
Installing Ansible on Windows
|
||||
------------------------------
|
||||
|
||||
You cannot use a Windows system for the Ansible control node. See :ref:`windows_faq_ansible`
|
||||
|
||||
.. seealso::
|
||||
|
||||
`Installing Ansible on ARch Linux <https://wiki.archlinux.org/title/Ansible#Installation>`_
|
||||
Distro-specific installation on Arch Linux
|
||||
`Installing Ansible on Clear Linux <https://clearlinux.org/software/bundle/ansible>`_
|
||||
Distro-specific installation on Clear Linux
|
||||
Loading…
Reference in New Issue