@ -23,6 +23,15 @@ when a term comes up on the mailing list.
writing a :term:`playbook <playbooks>` and playbooks can also glue
writing a :term:`playbook <playbooks>` and playbooks can also glue
lots of other operations together.
lots of other operations together.
Ansible (the package)
A software package (Python, deb, rpm, and so on) that contains ansible-base and a select group of collections. Playbooks that worked with Ansible 2.9 should still work with the Ansible 2.10 package. See the :file:`ansible-<version>.build` file in the release-specific directory at `ansible-build-data <https://github.com/ansible-community/ansible-build-data>`_ for a list of collections included in Ansible, as well as the included ``ansible-base`` version.
ansible-base
New for 2.10. The installable package (RPM/Python/Deb package) generated from the `ansible/ansible repository <https://github.com/ansible/ansible>`_. Contains the command-line tools and the code for basic features and functions, such as copying module code to managed nodes. The ``ansible-base`` package includes a few modules and plugins and allows you to add others by installing collections.
Ansible Galaxy
An `online resource <galaxy.ansible.com>`_ for finding and sharing Ansible community content. Also, the command-line utility that lets users install individual Ansible Collections, for example`` ansible-galaxy install community.crypto``.
Async
Async
Refers to a task that is configured to run in the background rather
Refers to a task that is configured to run in the background rather
than waiting for completion. If you have a long process that would
than waiting for completion. If you have a long process that would
@ -49,6 +58,18 @@ when a term comes up on the mailing list.
other systems). Use this to get an idea of what might happen, but do
other systems). Use this to get an idea of what might happen, but do
not substitute it for a good staging environment.
not substitute it for a good staging environment.
Collection
A packaging format for bundling and distributing Ansible content, including plugins, roles, modules, and more. Collections release independent of other collections or ``ansible-base`` so features can be available sooner to users. Some collections are packaged with Ansible (version 2.10 or later). You can install other collections (or other versions of collections) with ``ansible-galaxy collection install <namespace.collection>``.
Collection name
The second part of a Fully Qualified Collection Name. The collection name divides the collection namespace and usually reflects the function of the collection content. For example, the ``cisco`` namespace might contain ``cisco.ios``, ``cisco.aci``, and ``cisco.nxos``, with content for managing the different network devices maintained by Cisco.
community.general (collection)
A special collection managed by the Ansible Community Team containing all the modules and plugins which shipped in Ansible 2.9 that do ont have their own dedicated Collection. See `community.general <https://galaxy.ansible.com/community/general>`_` on Galaxy.
community.network (collection)
Similar to ``community.general``, focusing on network content. `community.network <https://galaxy.ansible.com/community/network>`_` on Galaxy.
Connection Plugin
Connection Plugin
By default, Ansible talks to remote machines through pluggable
By default, Ansible talks to remote machines through pluggable
libraries. Ansible uses native OpenSSH (:term:`SSH (Native)`) or
libraries. Ansible uses native OpenSSH (:term:`SSH (Native)`) or
@ -121,6 +142,9 @@ when a term comes up on the mailing list.
forks, though if you have a lot of RAM, you can easily set this to
forks, though if you have a lot of RAM, you can easily set this to
a value like 50 for increased parallelism.
a value like 50 for increased parallelism.
Fully Qualified Collection Name (FQCN)
The full definition of a module, plugin, or role hosted within a collection, in the form <namespace.collection.content_name>. Allows a Playbook to refer to a specific module or plugin from a specific source in an unambiguous manner, for example, ``community.grafana.grafana_dashboard``. The FQCN is required when you want to specify the exact source of a plugin. For example, if multiple collections contain a module plugin called ``user``, the FQCN specifies which one to use for a given task. When you have multiple collections installed, the FQCN is always the explicit and authoritative indicator of which collection to search for the correct plugin for each task.
Gather Facts (Boolean)
Gather Facts (Boolean)
:term:`Facts` are mentioned above. Sometimes when running a multi-play
:term:`Facts` are mentioned above. Sometimes when running a multi-play
:term:`playbook <playbooks>`, it is desirable to have some plays that
:term:`playbook <playbooks>`, it is desirable to have some plays that
@ -294,6 +318,9 @@ when a term comes up on the mailing list.
models entire IT topologies and workflows rather than looking at
models entire IT topologies and workflows rather than looking at
configuration from a "one system at a time" perspective.
configuration from a "one system at a time" perspective.
Namespace
The first part of a fully qualified collection name, the namespace usually reflects a functional content category. Example: in ``cisco.ios.ios_config``, ``cisco`` is the namespace. Namespaces are reserved and distributed by Red Hat at Red Hat's discretion. Many, but not all, namespaces will correspond with vendor names. See `Galaxy namespaces <https://galaxy.ansible.com/docs/contributing/namespaces.html#galaxy-namespaces>`_ on the Galaxy docsite for namespace requirements.
Notify
Notify
The act of a :term:`task <tasks>` registering a change event and
The act of a :term:`task <tasks>` registering a change event and
informing a :term:`handler <handlers>` task that another
informing a :term:`handler <handlers>` task that another