prehistoric-systems/scottslowe-learning-tools
1
0
Fork 0
mirror of https://codeberg.org/scottslowe/learning-tools.git synced 2026-03-11 09:04:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
scottslowe-learning-tools/ansible/src-dst-list/README.md
Scott Lowe 0d580804e6
Add documentation 
Update main README.md for the Ansible section. Add new README.md files for subsections as needed.

Signed-off-by: Scott Lowe <scott.lowe@scottlowe.org>
2018-04-19 14:01:47 -06:00

2.1 KiB
Raw Permalink Blame History

Using Complex Lists with Ansible Tasks

These files provide an example of how to use "complex" (multi-value) lists in an Ansible task using the "with_items" construct.

Contents

  • docker.socket: This is a systemd unit file defining a socket for the Docker daemon.

  • docker-socket.conf: This is a systemd drop-in unit to modify the default Docker unit file.

  • docker-tcp.socket: This systemd unit file defines a TCP socket for the Docker daemon.

  • machines.yml: This YAML data file is used by Vagrant to determine which VM images to use, how many VMs to create, and what the configuration of those VMs should be.

  • provision.yml: This Ansible playbook shows the use of the "with_items" construct when items in the list have multiple values/attributes.

  • README.md: The file you're currently reading.

  • Vagrantfile: This file is used by Vagrant to spin up VMs. No changes should be needed to this file; all configuration information is provided in machines.yml.

Instructions

These instructions assume that you have both Vagrant and Ansible installed and functioning correctly on your system, and that the virtualization provider used by Vagrant is working as expected. These instructions also assume that you've installed any necessary Vagrant plugins to support the installed virtualization provider.

  1. Place the files from the ansible/src-dst-list directory of this GitHub repository into a directory on your local system. You can clone the entire "learning-tools" repository (using git clone) or just download the specific files from the ansible/src-dst-list folder.

  2. Install a Vagrant box for CentOS Atomic Host. The machines.yml file contains a suggested box for VirtualBox. This environment does not support other virtualization providers at this time.

  3. Run vagrant up to spin up the Vagrant VM. Vagrant will automatically invoke Ansible to copy the files into the correct location. This illustrates how Ansible's "with_items" construct can leverage multiple values in a list.

  4. Run vagrant destroy to tear down the environment.

Enjoy!

License

This content is licensed under the MIT License.