Skip to content

Latest commit

 

History

History
78 lines (54 loc) · 3.55 KB

ch01-setup.adoc

File metadata and controls

78 lines (54 loc) · 3.55 KB
Raw

Setup Environments

This section describes the hardware and software needed for this workshop, and how to configure them. This workshop is designed for a BYOL (Brying Your Own Laptop) style hands-on-lab.

Hardware & Software

  1. Memory: At least 4 GB+, strongly preferred 8 GB

  2. Operating System: Mac OS X (10.10.3+), Windows 10 Pro+ 64-bit, Ubuntu 12+, CentOS 7+.

    Note
    		 An older version of the operating system may be used. The installation instructions would differ slightly in that case and are explained in the next section.

  3. Amazon Web Services credentials with following permissions. This is only needed for some parts of the workshop.

Install Docker

Docker runs natively on Mac, Windows and Linux. This lab will use Docker Community Edition. Follow the instructions to install Docker.

Note
 Docker Community Edition have requirements for a fairly recent operating system version. If your machine does not meet these requirements, then you need to install Docker Toolbox.

This workshop is tested with Docker Community Edition 17.09.0-ce-rc2, build 363a3e7 on Mac OS X 10.12.5.

Additional components

If Docker is installed using Docker Community Edition or Docker Toolbox, then this section is not required.

Install the following additional components:

Docker Toolbox Notes

Skip this section if you are using Docker Community Edition.

  1. Default Docker Machine: Docker Toolbox creates a Docker Machine named default. To make it easier to start/stop the containers, an entry is added into the host mapping table of your operating system.

    Find out the IP address of your Docker Machine:

    docker-machine ip default

    This will provide the IP address associated with the Docker Machine created by Toolbox.

    Edit /etc/hosts (Mac OS) or C:\Windows\System32\drivers\etc\hosts (Windows) and add:

    <IP ADDRESS>  dockerhost

    This allows to access Docker containers using dockerhost.

  2. Docker CLI Shell: Any Docker CLI command needs to be issued from the Terminal or Command Prompt where eval $(docker-machine env default) command was issued. This will make sure Docker CLI is configured to talk to the VM created by Docker Toolbox.

Download Images

This tutorial uses a few Docker images and software. Let’s download them before we start the tutorial.

docker-compose -f docker-compose-pull-images.yml pull --parallel
Note
 --parallel switch will not work for Docker Compose version prior to 1.12. If you are using an older version then remove the --parallel switch.
Note
 For Linux, docker-compose and docker commands need sudo access. So prefix all commands with sudo.

Other Software

  1. Download Java IDE based upon your choice and install.

  2. Download Maven and install.

  3. Install Docker Cloud CLI following the instructions.