Now that you’ve read the installation guide and installed Ansible, you can get started with some ad-hoc commands.
What we are showing first are not the powerful configuration/deployment/orchestration features of Ansible. These features are handled by playbooks which are covered in a separate section.
This section is about how to initially get Ansible running. Once you understand these concepts, read Introduction To Ad-Hoc Commands for some more detail, and then you’ll be ready to begin learning about playbooks and explore the most interesting parts!
Before we get started, it is important to understand how Ansible communicates with remote machines over the SSH protocol.
By default, Ansible will try to use native
OpenSSH for remote communication when possible. This enables ControlPersist (a performance feature), Kerberos, and options in
~/.ssh/config such as Jump Host setup. However, when using Enterprise Linux 6 operating systems as the control machine (Red Hat Enterprise Linux and derivatives such as CentOS), the version of OpenSSH may be too old to support ControlPersist. On these operating systems, Ansible will fallback into using a high-quality Python implementation of
OpenSSH called ‘paramiko’. If you wish to use features like Kerberized SSH and more, consider using Fedora, macOS, or Ubuntu as your control machine until a newer version of OpenSSH is available for your platform.
Occasionally you will encounter a device that does not support SFTP. This is rare, but should it occur, you can switch to SCP mode in Configuring Ansible.
When speaking with remote machines, Ansible by default assumes you are using SSH keys. SSH keys are encouraged but password authentication can also be used where needed by supplying the option
--ask-pass. If using sudo features and when sudo requires a password, also supply
--ask-sudo-pass which has been deprecated).
Ansible does not expose a channel to allow communication between the user and the ssh process to accept a password manually to decrypt an ssh key when using the ssh connection plugin (which is the default). The use of
ssh-agent is highly recommended.
While it may be common sense, it is worth sharing: Any management system benefits from being run near the machines being managed. If you are running Ansible in a cloud, consider running it from a machine inside that cloud. In most cases this will work better than on the open Internet.
Ansible is not limited to remote connections over SSH. The transports are pluggable, and there are options for managing things locally, as well as managing chroot, lxc, and jail containers. A mode called ‘ansible-pull’ can also invert the system and have systems ‘phone home’ via scheduled git checkouts to pull configuration directives from a central repository.
Now that you’ve installed Ansible, try some basics.
Edit (or create)
/etc/ansible/hosts and put one or more remote systems in it. Your
public SSH key should be located in
authorized_keys on those systems:
192.0.2.50 aserver.example.org bserver.example.org
This is an inventory file, which is also explained in greater depth here: Working with Inventory.
We assume you are using SSH keys for authentication. To set up SSH agent to avoid retyping passwords, you can do:
$ ssh-agent bash $ ssh-add ~/.ssh/id_rsa
Depending on your setup, you may wish to use Ansible’s
--private-key command line option to specify a pem file instead. You can also add the private key file:
$ ssh-agent bash $ ssh-add ~/.ssh/keypair.pem
Another way to add private key files without using ssh-agent is using
ansible_ssh_private_key_file in an inventory file as explained here: Working with Inventory.
Now ping all your nodes:
$ ansible all -m ping
Ansible will attempt to remote connect to the machines using your current user name, just like SSH would.
You can override the default remote user name in several ways, including passing the
-u parameter at the command line, setting user information in your inventory file, setting user information in your configuration file, and setting environment variables. See Controlling how Ansible behaves: precedence rules for details on the (sometimes unintuitive) precedence of each method of passing user information.
If you would like to access sudo mode, there are also flags to do that:
# as bruce $ ansible all -m ping -u bruce # as bruce, sudoing to root (sudo is default method) $ ansible all -m ping -u bruce --become # as bruce, sudoing to batman $ ansible all -m ping -u bruce --become --become-user batman
The sudo implementation (and other methods of changing the current user) can be modified in Ansible configuration if you happen to want to use a sudo replacement. Flags passed to sudo (like -H) can also be set.
Now run a live command on all of your nodes:
$ ansible all -a "/bin/echo hello"
Congratulations! You have contacted your nodes with Ansible. You have a fully working infrastructure. Next you can read about more real-world cases in Introduction To Ad-Hoc Commands, explore what you can do with different modules, or read about the Ansible Working With Playbooks language. Ansible is not just about running commands, it also has powerful configuration management and deployment features.
When running commands, you can specify the local server by using “localhost” or “127.0.0.1” for the server name.
$ ansible localhost -m ping -e 'ansible_python_interpreter="/usr/bin/env python"'
You can specify localhost explicitly by adding this to your inventory file:
localhost ansible_connection=local ansible_python_interpreter="/usr/bin/env python"
Ansible has host key checking enabled by default.
If a host is reinstalled and has a different key in ‘known_hosts’, this will result in an error message until corrected. If a host is not initially in ‘known_hosts’ this will result in prompting for confirmation of the key, which results in an interactive experience if using Ansible, from say, cron. You might not want this.
If you understand the implications and wish to disable this behavior, you can do so by editing
[defaults] host_key_checking = False
Alternatively this can be set by the
ANSIBLE_HOST_KEY_CHECKING environment variable:
$ export ANSIBLE_HOST_KEY_CHECKING=False
Also note that host key checking in paramiko mode is reasonably slow, therefore switching to ‘ssh’ is also recommended when using this feature.
Ansible will log some information about module arguments on the remote system in the remote syslog, unless a task or play is marked with a “no_log: True” attribute. This is explained later.
To enable basic logging on the control machine see Configuring Ansible document and set the ‘log_path’ configuration file setting. Enterprise users may also be interested in Red Hat Ansible Tower. Tower provides a very robust database logging feature where it is possible to drill down and see history based on hosts, projects, and particular inventories over time – explorable both graphically and through a REST API.
- Working with Inventory
- More information about inventory
- Introduction To Ad-Hoc Commands
- Examples of basic commands
- Working With Playbooks
- Learning Ansible’s configuration management language
- Mailing List
- Questions? Help? Ideas? Stop by the list on Google Groups
- #ansible IRC chat channel