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/vagrant-docker-yaml
History
Scott S. Lowe e3feb33619 Update README.md 
Update README.md based on new architecture of the learning environment
2016-10-05 21:08:30 -06:00
..
containers.yml Add files for multi-container Docker environments with Vagrant 2015-02-11 10:11:27 -07:00
hostvms.yml Re-factor Docker+Vagrat+YAML environment 2016-10-04 09:41:29 -06:00
README.md Update README.md 2016-10-05 21:08:30 -06:00
Vagrantfile Re-factor Docker+Vagrat+YAML environment 2016-10-04 09:41:29 -06:00
VagrantfileHost Re-factor Docker+Vagrat+YAML environment 2016-10-04 09:41:29 -06:00

README.md

Running Multiple Docker Containers in Vagrant with YAML

These files were created to allow users to use Vagrant (http://www.vagrantup.com) to quickly and relatively easily launch multiple Docker (http://www.docker.com) containers. The specifics of the Docker containers are specified in an external YAML file. The configuration was tested using Vagrant 1.8.5, VMware Fusion 8.1.0 (with the Vagrant VMware plugin), and VirtualBox 5.1.

Contents

  • containers.yml: This YAML file contains a list of the Docker containers and their properties for use by Vagrant. You will need to edit this file to specify container friendly name, image, and exposed ports.

  • hostvms.yml: This YAML file contains the configuration data for the "host VM" that the Vagrant Docker provider will use. Edit this file to change the Vagrant box used by the "host VM," or the VM configuration.

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

  • VagrantfileHost: This file is used by Vagrant to spin up a "host VM" for use with the Vagrant Docker provider. No edits should be necessary to this file.

  • Vagrantfile: This file is used by Vagrant to spin up the Docker containers on the host VM created by VagrantfileHost. Unless you change filenames, you should not need to edit this file. All container details are stored in a separate YAML file.

Instructions

  1. Use vagrant box add to install an Ubuntu 14.04 base box. If you'd like to use a VMware Fusion-formatted box, you can use my base box ("slowe/ubuntu-trusty-x64").

  2. Edit hostvms.yml to specify the name of the box you added in step #1.

  3. Edit the containers.yml file to specify the Docker containers that Vagrant should create on the host VM. Each container should contain three properties: name (the friendly name to be assigned to the Docker container), image (the name of the Docker image to be used for this container), and ports (a list of ports to be exposed for the container).

  4. From the directory where the main Vagrantfile is located, simply run vagrant up to spin up the specified host VM and specified Docker containers. Note that Internet access will be required to download Docker and the Docker images.

Enjoy!