Skip to content

docker-setup.adoc

Latest commit

 

History

History
191 lines (136 loc) · 7.47 KB

docker-setup.adoc

File metadata and controls

191 lines (136 loc) · 7.47 KB

Setup Environments

This section describes the relevant steps for both attendees and instructors to setup the environments. Please follow the parts, that are appropriate for you.

Instructor

The instructor setup is designed to make the lab most reliable even with bad Internet connections. Most, if not all, of the software can be directly downloaded from the instructor’s machine. The machine is setup as Docker Host and also runs a Docker Registry and Nexus container.

Follow all the instructor setup instructions at least a day before the lab. Make sure there is a decent Internet connection available.

Attendees (From Instructor’s Machine)

This lab is designed for a BYOL (Brying Your Own Laptop) style hands-on-lab. This section provide instructions to setup an attendee environment from an instructor’s machine.

Hardware

  1. CPU

    1. Mac: X64 (i5 or superior)

    2. Linux / Windows: x64 (i5 and comparable)

  2. Memory

    1. At least 4GB, preferred 8 GB

Software

  1. Operating System

    1. Mac OS X (10.8 or later), Windows 7 (SP1), Fedora (21 or later)

  2. Java: Oracle JDK 8u45

  3. Webbrowser

A Word About Licenses

This tutorial only uses software which is open source or at least free to use in development and/or education. Please refer to the individual products/tools used in this tutorial.

Configure Instructor Host

All downloads and relevant infrastructure is setup on instructor’s machine. Configure the IP address of instructor’s machine into the resolver configuration of your operating system.

Edit the /etc/resolv.conf (Mac OS / Linux)

nameserver  <INSTRUCTOR IP>

Maven

  1. Download Apache Maven from http://classroom.example.com:8082/downloads/apache-maven-3.3.3-bin.zip

  2. Unzip to a folder of your choice and add the folder to your PATH environment variable.

VirtualBox

Docker currently runs natively on Linux, but you can use VirtualBox to run Docker in a virtual machine on your box, and get the best of both worlds. This is why Virtualbox is a requirement to have on your machine. Get the latest downloads from the instructur machine:

Downloads are available from Mac, Linux, Windows.

Warning

Linux Users

  1. Have your kernel updated

  2. Users should have the GNU compiler, build and header files for your current Linux kernel

  3. Create a /usr/src/linux link to the current kernel source

Vagrant

  1. Download Vagrant for Mac, Windows, Linux or Debian and install.

Docker Machine

# MacOS
curl -L  http://classroom.example.com:8082/downloads/docker-machine_darwin-amd64 > /usr/local/bin/docker-machine
chmod +x /usr/local/bin/docker-machine

# Linux
curl -L  http://classroom.example.com:8082/downloads/docker-machine_linux-amd64 > /usr/local/bin/docker-machine
chmod +x /usr/local/bin/docker-machine

#Windows
curl http://classroom.example.com:8082/downloads/docker-machine_windows-amd64.exe

On Windows copy the script into C:\docker directory and rename to: docker-machine.exe. Add C:\docker to your PATH variable.

Docker Client

# MacOS
curl -L  http://classroom.example.com:8082/downloads/docker-latest-mac > /usr/local/bin/docker
chmod +x /usr/local/bin/docker

# Linux (other distros)
curl -L  http://classroom.example.com:8082/downloads/docker-latest-linux > /usr/local/bin/docker
chmod +x /usr/local/bin/docker

#Windows
curl http://classroom.example.com:8082/docker-1.6.0.exe

On Windows rename the file to C:\docker\docker.exe.

Create Lab Docker Host

  1. Create the Docker Host to be used in the lab:

    docker-machine create --driver=virtualbox --engine-opt dns=<INSTRUCTOR IP> --virtualbox-boot2docker-url=http://classroom.example.com:8082/downloads/boot2docker.iso --engine-insecure-registry=classroom.example.com:5000 lab
eval "$(docker-machine env lab)"

    Substitute <INSTRUCTOR_IP> with the IP address of the instructor’s machine.

  2. To make it easier to access the containers, we add an entry into the host mapping table of your operating system. Add a host entry for this Docker Host running on your machine. Find out the IP address of your machine:

    docker-machine ip lab

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

    <OUTPUT OF DOCKER MACHINE COMMAND>  dockerhost

Kubernetes

  1. Download Kubernetes (0.18.1) from http://classroom.example.com:8082/downloads/kubernetes.tar.gz

  2. Install it by clicking on the archive.

WildFly

  1. Download WildFly 8.2 from http://classroom.example.com:8082/downloads/wildfly-8.2.0.Final.zip

  2. Install it by clicking on the archive.

JBoss Developer Studio 9 - Beta 2

To install JBoss Developer Studio stand-alone, complete the following steps:

  1. Download http://classroom.example.com:8082/downloads/jboss-devstudio-9.0.0.Beta2-v20150609-1026-B3346-installer-standalone.jar

  2. Start the installer as:

    java -jar jboss-devstudio-9.0.0.Beta2-v20150609-1026-B3346-installer-standalone.jar

    Follow the on-screen instructions to complete the installation process.