Skip to content

Latest commit

 

History

History
82 lines (49 loc) · 3.76 KB

01-prerequisites.md

File metadata and controls

82 lines (49 loc) · 3.76 KB
Raw

Prerequisites

VM Hardware Requirements

8 GB of RAM (Preferably 16 GB) 50 GB Disk space

Virtual Box

Download and Install VirtualBox on any one of the supported platforms:

  • Windows hosts
  • OS X hosts (x86 only, not Apple Silicon M-series)
  • Linux distributions
  • Solaris hosts

Vagrant

Once VirtualBox is installed you may chose to deploy virtual machines manually on it. Vagrant provides an easier way to deploy multiple virtual machines on VirtualBox more consistently.

Download and Install Vagrant on your platform.

  • Windows
  • Debian
  • Centos
  • Linux
  • macOS (x86 only, not M1)

This tutorial assumes that you have also installed Vagrant.

Lab Defaults

The labs have been configured with the following networking defaults. If you change any of these after you have deployed any of the lab, you'll need to completely reset it and start again from the beginning:

vagrant destroy -f
vagrant up

If you do change any of these, please consider that a personal preference and don't submit a PR for it.

Virtual Machine Network

The network used by the Virtual Box virtual machines is 192.168.56.0/24.

To change this, edit the Vagrantfile in your cloned copy (do not edit directly in github), and set the new value for the network prefix at line 9. This should not overlap any of the other network settings.

Note that you do not need to edit any of the other scripts to make the above change. It is all managed by shell variable computations based on the assigned VM IP addresses and the values in the hosts file (also computed).

It is recommended that you leave the pod and service networks with the following defaults. If you change them then you will also need to edit one or both of the CoreDNS and Weave networking manifests to accommodate your change.

Pod Network

The network used to assign IP addresses to pods is 10.244.0.0/16.

To change this, open all the .md files in the docs directory in your favourite IDE and do a global replace on
POD_CIDR=10.244.0.0/16
with the new CDIR range. This should not overlap any of the other network settings.

Service Network

The network used to assign IP addresses to Cluster IP services is 10.96.0.0/16.

To change this, open all the .md files in the docs directory in your favourite IDE and do a global replace on
SERVICE_CIDR=10.96.0.0/16
with the new CDIR range. This should not overlap any of the other network settings.

Additionally edit line 164 of coredns.yaml to set the new DNS service address (should still end with .10)

Running Commands in Parallel with tmux

tmux can be used to run commands on multiple compute instances at the same time. Labs in this tutorial may require running the same commands across multiple compute instances, in those cases consider using tmux and splitting a window into multiple panes with synchronize-panes enabled to speed up the provisioning process.

The use of tmux is optional and not required to complete this tutorial.

tmux screenshot

Enable synchronize-panes by pressing CTRL+B followed by " to split the window into two panes. In each pane (selectable with mouse), ssh to the host(s) you will be working with.
Next type CTRL+X at the prompt to begin sync. In sync mode, the dividing line between panes will be red. Everything you type or paste in one pane will be echoed in the other.
To disable synchronization type CTRL+X again.

Note that the CTRL-X key binding is provided by a .tmux.conf loaded onto the VM by the vagrant provisioner.

Next: Compute Resources