Skip to content

abstractinfrastructure/k8s-intro-tutorials

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kubernetes Tutorials

Before you begin

These tutorials accompany the presentation Introduction to Kubernetes and make use of kind. A tool that allows users to quickly spin up and run a single instance of Kubernetes locally using Docker. To install it and the other tutorial dependencies, see the Installation Guides section.

Each section assumes an instance of kind is up and running. To start kind for the first time, use the command:

kind create cluster

Tutorials have been validated against kind v0.14.0 running Kubernetes v1.24.x and kubectl 1.24.0


Tutorial Index

  • cli - Covers the basics of using kubectl to interact with a Kubernetes cluster.
  • core - Tutorial of the core concepts, or building blocks of Kubernetes.
  • workloads - Walkthrough of the different types of application workloads.
  • storage - Explores the relationship between Persistent Volumes, Persistent Volume Claims, and Volumes themselves.
  • configuration - Tutorials going over how to use the two Configuration objects ConfigMaps and Secrets.
  • Examples - Examples of full blown applications to explore after the tutorials have been completed.

Installation Guides

The Installation guides are centered around using Docker. Please ensure you have Docker installed by following their installation guide for your platform.


OSX Installation Guide

Installation on OSX is done with Homebrew, an OSX package manager. If you have not installed it previously, please see their installation guide before continuing.

Install git, kubectl, and kind

brew install git kubernetes-cli kind

Once done, verify your Install.

Optional: You can improve the general user experience of working with kubectl by installing command-completion


Windows Installation Guide

Installation on Windows is done with chocolatey, a Windows Package Manager. If you have not installed it previously, please see their installation guide before continuing.

dism.exe /Online /Disable-Feature:Microsoft-Hyper-V

Install git, kubectl, and kind.

choco install git kubernetes-cli kind

Once done, verify your Install.


Linux

Linux installation is different for each distro. General install information is linked below:

Once done, verify your Install.

Optional: You can improve the general user experience of working with kubectl by installing command-completion


Verifying Install

With the software installed you can verify it is working correctly by executing:

kind create cluster

This will take a little bit of time the first time it is run as it will download its needed dependencies and starts the container. When it completes, you can verify it is working correctly by executing:

kubectl version

You should get output similar to the following:

Client Version: version.Info{Major:"1", Minor:"19", GitVersion:"v1.19.3", GitCommit:"1e11e4a2108024935ecfcb2912226cedeafd99df", GitTreeState:"clean", BuildDate:"2020-10-14T12:50:19Z", GoVersion:"go1.15.2", Compiler:"gc", Platform:"linux/amd64"}
Server Version: version.Info{Major:"1", Minor:"24", GitVersion:"v1.24.0", GitCommit:"4ce5a8954017644c5420bae81d72b09b735c21f0", GitTreeState:"clean", BuildDate:"2022-05-19T15:39:43Z", GoVersion:"go1.18.1", Compiler:"gc", Platform:"linux/amd64"}

After that you may stop the container with:

kind delete cluster

Troubleshooting Install Problems

(This tutorial has been recently updated. After running tutorials it will be updated with what we've learned!)