Haufe Kubernetes Lab/Workshop

This repository contains material for a Kubernetes Workshop/Lab, hopefully just about enough for until lunch (3-4 hours).

Prerequisites

Check the following prerequisites:

• You should be familiar with containers and docker, even if it's not a true prerequisite. But it does help.
• Basic familiarity with the Azure Portal; make sure you are able to log in using your <login>@haufe.com ID
• Installed Azure Command Line 2.0
  • macOS: In case you already had it installed, please run a az component update (applicable only to macOS)
  • Windows: Use the MSI installation package at https://aka.ms/InstallAzureCliWindows
• A usable bash console, e.g.
  • "Terminal" or "iTerm2" on macOS,
  • "git bash" on Windows. If you don't already have "git bash" installed, get git for Windows here. Using the Ubuntu Subsystem will probably NOT work. Use git bash. Thanks.
• An ssh identity in ~/.ssh/id_rsa[.pub], without password protection
  • In case you don't have such an identity, run ssh-keygen in your terminal (or git bash window)
• A recent openssl installation (check whether openssl in bash gives you a prompt, otherwise install it)
  • For macOS users: Please update to the latest homebrew version of OpenSSL (brew update, brew install openssl)
  • Recent Windows installation of Git for Windows should be sufficient
• A GitHub account (we need this to provision OAuth2 credentials)

For Windows: After starting a git bash window, issue the following command:

MartinD@HGDECWFR002121 MINGW64 ~
$ alias az=az.cmd

This will make the Azure command line utility available as az in git bash as well (otherwise it only works in cmd.exe, isn't cross platform tooling awesome?).

Creating an env.sh

After you have received the credentials from the organizers (the service principal definition), create a env.sh from the template file at the root of this repository and fill in the information needed (Service Principal credentials and so on). The data you need for the first section should have been sent to you just prior to the workshop via Rocket.Chat; if not, contact one of the organizers.

Important: For YOUR_NAME, use your first name, without any delimiters or spaces, in lowercase! E.g., martin, annemarie, but not Trevor Hannigan, MEMYSELFANDI or what-ever. Most things will still work, but you will run into trouble with VHOST entries and certificate definitions later on in the workshop.

Clone this repository before you start

You will need all the things inside this repository, so please clone the repository onto your local machine. Throughout the entire workshop/lab, it's assumed that the repository is placed in ~/Projects/k8s-workshop, so wherever you see commands which need to be issued from the command line, this is the directory you should have cd:d into.

~/Projects$ git clone https://github.com/DonMartin76/k8s-workshop
Cloning into "k8s-workshop"...
~/Projects$ cd k8s-workshop
~/Projects/k8s-workshop$ # Happy labbing!

Following along

Go through the workshop/lab description in the order of the steps; each step usually needs what's created in the previous step(s), so skipping steps will most probably not work. Like, at all.

Additionally, to get the big picture, you should have a look at the presentation which belongs to this workshop.

So, start here:

• Provision the cluster
• Deploy a simple application
• On Ingress Controllers and stuff
• Deploying the entire application
• Updating a deployment (rolling updates)
• Cleaning up after yourself
• Appendix - Useful Kubernetes commands

HAVE FUN!

Please feedback into the issues of this repository, so that I can improve for the next time.