add basic hello world

Author: vorburger

README.md

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

TODO.md

@@ -1,5 +1,9 @@
-- [ ] More lessons:
+- [ ] Lessons:
 
+  - [ ] API: Build your first Kubernetes Resource Model (KRM) Custom Resource Definition (CRD)
+  - [ ] API: Build an Operator
+
+  - [ ] https://googlecontainertools.github.io/kpt/
   - [ ] 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 ?)

docs/hello-world.md

@@ -0,0 +1,15 @@
+# hello, world
+
+## echoserver
+
+    k create deployment echoserver --image=k8s.gcr.io/echoserver:1.10
+    k expose deployment echoserver --type=LoadBalancer --port=8080
+    curl $(minikube service --url=true echoserver)
+
+<!-- TODO where is the source code of this echoserver? -->
+
+## Dashboard
+
+    minikube dashboard
+
+If you run `minikube` inside a Virtual Machine (VM) instead of on your Laptop/Desktop workstation, then you'll need to set up some port forwarding to be able to access services in your local web browser.

docs/install.md

@@ -1,11 +1,14 @@
 # Install Kubernetes
 
-To follow the next lessons in this tutorial, you need to have the following prerequisites:
+To follow the 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. configuration to access it (in a `~/.kube/config` 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.
+There are many ways to set this up. One of easiest ways to get started is to use https://minikube.sigs.k8s.io/docs/start, and:
 
-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).
+    minikube start
+    alias k="minikube kubectl -- "
+
+Alternatives include 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. We may add documentation about such other approaches later.