add install with minikube et al

extend About Kubernetes
and more TODO

Author: vorburger

Diff for: README.md

@@ -2,7 +2,7 @@
 
 This is a Code Lab style course for learning Kubernetes, with the following lessons:
 
-1. Your Kubernetes Environment (prerequisite)
+1. [Installation](docs/install.md) (prerequisite)
 1. hello, world
 1. Appendix
    * [About Kubernetes](docs/appendix/about-kubernetes.md)

Diff for: TODO.md

@@ -1,3 +1,41 @@
+- [ ] More lessons:
+
+  - [ ] https://github.com/kvaps/kubectl-build (or https://github.com/vmware-tanzu/buildkit-cli-for-kubectl)
+  - [ ] https://BuildPacks.io, see [KubeCon Prez](https://static.sched.com/hosted_files/kccnceu2021/f3/IntroductionToCloudNativeBuildpacks_StephenLevineJesseBrown_v1.pdf)
+  - [ ] https://github.com/kvaps/kubectl-node-shell (+ https://github.com/containers/toolbox ?)
+  - [ ] https://knative.dev
+  - [ ] https://www.openfaas.com
+
+- [ ] Other Kubernetes distributions than `minikube`:
+
+  - [ ] kubeadm
+  - [ ] kind
+  - [ ] https://github.com/rootless-containers/usernetes
+  - [ ] https://microk8s.io
+  - [ ] https://k3s.io (https://k3d.io)
+  - [ ] https://k0sproject.io
+
+- [ ] CoreOS instead of Debian on GCP: Debian works, but CoreOS SSH keys are somehow missing:
+  (update https://docs.fedoraproject.org/en-US/fedora-coreos/provisioning-gcp/)
+
+      gcloud compute instances create kubernetes-codelab --zone europe-west4-c --min-cpu-platform "Intel Haswell" --image-project debian-cloud --image-family debian-10
+      gcloud compute ssh kubernetes-codelab
+
+      gcloud compute instances create coreos2 --zone europe-west4-c  --min-cpu-platform "Intel Haswell" --image-project fedora-coreos-cloud --image-family fedora-coreos-next
+      gcloud compute ssh core@coreos2
+      Using OS Login user [$USER] instead of requested user [core]
+      $USER@$IP: Permission denied (publickey,gssapi-keyex,gssapi-with-mic).
+
+      gcloud compute instances create coreos1 --zone europe-west4-c --min-cpu-platform "Intel Haswell" --image-project fedora-coreos-cloud --image-family fedora-coreos-stable
+      gcloud compute ssh coreos1
+      $YOU@$IP: Permission denied (publickey,gssapi-keyex,gssapi-with-mic).
+
+      gcloud compute ssh core@coreos1
+      Using OS Login user [$YOU] instead of requested user [core]
+
+      ssh: connect to host $IP port 22: Connection timed out
+      ERROR: (gcloud.compute.ssh) [/usr/bin/ssh] exited with return code [255].
+
 - [ ] GitHub Action (pre-commit hook) to lint all markdown, check links, etc.
 
 - [ ] https://github.com/googlecodelabs/tools ? 

Diff for: docs/appendix/about-kubernetes.md

@@ -2,8 +2,8 @@
 
 [Kubernetes](https://kubernetes.io) is an
 [open source](https://github.com/kubernetes/kubernetes) container orchestrator.
-Google initiated this project in 2014, [inspired by Borg](https://kubernetes.io/blog/2015/04/borg-predecessor-to-kubernetes/) (see [original article](https://static.googleusercontent.com/media/research.google.com/en//pubs/archive/44843.pdf), the [original paper](https://storage.googleapis.com/pub-tools-public-publication-data/pdf/43438.pdf), and [second paper](https://dl.acm.org/doi/pdf/10.1145/3342195.3387517)). It has turned into one
-of / the most successful and active open source community, overshadowing earlier
+Google initiated this project in 2014, [inspired by Borg](https://kubernetes.io/blog/2015/04/borg-predecessor-to-kubernetes/) (see [original article](https://static.googleusercontent.com/media/research.google.com/en//pubs/archive/44843.pdf), the [original paper](https://storage.googleapis.com/pub-tools-public-publication-data/pdf/43438.pdf), and [second paper](https://dl.acm.org/doi/pdf/10.1145/3342195.3387517)). It has turned into [one
+of the most successful and active open source communities](https://www.cncf.io/blog/2017/06/05/30-highest-velocity-open-source-projects/), eclipsing earlier
 similar projects such as Apache Mesos or Docker Swarm et al. Google is the
 [company with most contributions](https://k8s.devstats.cncf.io/d/9/companies-table?orgId=1)
 to this open source community.

Diff for: docs/install.md

@@ -0,0 +1,11 @@
+# Install Kubernetes
+
+To follow the next lessons in this tutorial, you need to have the following prerequisites:
+
+1. a Kubernetes cluster
+1. access to that Kubernets cluster (i.e. credentials to it, in the form of a private key in a `kubectl.yaml` file)
+1. the `kubectl` CLI binary, aliased to `k`
+
+There are many ways to get this. One of easiest ways to get started is to use https://minikube.sigs.k8s.io/docs/start.
+
+We may add documentation about other approaches later (e.g. `kind`, `kubeadm`; or cloud hosted managed Kubernetes offerings like Google's GKE; or local distributions like k3s.io, k3s.io, OpenShift, et al).