From f1e9efc38c594ab4632a3285a565c6fdd192491e Mon Sep 17 00:00:00 2001
From: Jerome Petazzoni <jerome.petazzoni@gmail.com>
Date: Wed, 22 Aug 2018 11:05:20 -0500
Subject: [PATCH] Explain how to access internal services

By using kubectl proxy and kubectl port-forward
---
 slides/k8s/accessinternal.md | 130 +++++++++++++++++++++++++++++++++++
 slides/kube-fullday.yml      |   1 +
 slides/kube-halfday.yml      |   1 +
 slides/kube-selfpaced.yml    |   1 +
 4 files changed, 133 insertions(+)
 create mode 100644 slides/k8s/accessinternal.md

diff --git a/slides/k8s/accessinternal.md b/slides/k8s/accessinternal.md
new file mode 100644
index 00000000..ac8bf42a
--- /dev/null
+++ b/slides/k8s/accessinternal.md
@@ -0,0 +1,130 @@
+# Accessing internal services
+
+- When we are logged on a cluster node, we can access internal services
+
+  (by virtue of the CNI model: all nodes can reach all pods and services)
+
+- When we are accessing a remote cluster, things are different
+
+  (generally, our local machine won't have access to the cluster's internal subnet)
+
+- How can we temporarily access to a service without exposing it to everyone?
+
+--
+
+- `kubectl proxy`: gives us access to the API, which includes a proxy for HTTP resources
+
+- `kubectl port-forward`: allows forwarding of TCP ports to arbitrary pods, services, ...
+
+---
+
+## Suspension of disbelief
+
+The exercises in this section assume that we have set up `kubectl` on our
+local machine in order to access a remote cluster.
+
+We will therefore show how to access services and pods of the remote cluster,
+from our local machine.
+
+You can also run these exercises directly on the cluster (if you haven't
+installed and set up `kubectl` locally).
+
+It will be less useful (since you could access services and pods directly),
+but keep in mind that these commands will work anywhere as long as you have
+installed and setup `kubectl` to communicate with your cluster.
+
+---
+
+## `kubectl proxy` in theory
+
+- Running `kubectl proxy` gives us access to the entire Kubernetes API
+
+- The API includes routes to proxy HTTP traffic
+
+- These routes look like the following:
+
+  `/api/v1/namespaces/<namespace>/services/<service>/proxy`
+
+- We just add the URI to the end of the request, for instance:
+
+  `/api/v1/namespaces/<namespace>/services/<service>/proxy/index.html`
+
+- We can access `services` and `pods` this way
+
+---
+
+## `kubectl proxy` in practice
+
+- Let's access the `webui` service through `kubectl proxy`
+
+.exercise[
+
+- Run an API proxy in the background:
+  ```bash
+  kubectl proxy &
+  ```
+
+- Access the `webui` service:
+  ```bash
+  curl localhost:8001/api/v1/namespaces/default/services/webui/proxy/index.html
+  ```
+
+- Terminate the proxy:
+  ```bash
+  kill %1
+  ```
+
+]
+
+---
+
+## `kubectl port-forward` in theory
+
+- What if we want to access a TCP service?
+
+- We can use `kubectl port-forward` instead
+
+- It will create a TCP relay to forward connections to a specific port
+
+  (of a pod, service, deployment...)
+
+- The syntax is:
+
+  `kubectl port-forward service/name_of_service local_port:remote_port`
+
+- If only one port number is specified, it is used for both local and remote ports
+
+---
+
+## `kubectl port-forward` in practice
+
+- Let's access our remote Redis server
+
+.exercise[
+
+- Forward connections from local port 10000 to remote port 6379:
+  ```bash
+  kubectl port-forward svc/redis 10000:6379 &
+  ```
+
+- Connect to the Redis server:
+  ```bash
+  telnet localhost 10000
+  ```
+
+- Issue a few commands, e.g. `INFO server` then `QUIT`
+
+<!--
+```wait Connected to localhost```
+```keys INFO server```
+```keys ^J```
+```keys QUIT```
+```keys ^J```
+-->
+
+- Terminate the port forwarder:
+  ```bash
+  kill %1
+  ```
+
+]
\ No newline at end of file
diff --git a/slides/kube-fullday.yml b/slides/kube-fullday.yml
index cd13b334..e1caba02 100644
--- a/slides/kube-fullday.yml
+++ b/slides/kube-fullday.yml
@@ -35,6 +35,7 @@ chapters:
 - - k8s/ourapponkube.md
   - k8s/kubectlproxy.md
   - k8s/localkubeconfig.md
+  - k8s/accessinternal.md
   - k8s/dashboard.md
   - k8s/kubectlscale.md
   - k8s/daemonset.md
diff --git a/slides/kube-halfday.yml b/slides/kube-halfday.yml
index 92c227c7..9ec6a3f1 100644
--- a/slides/kube-halfday.yml
+++ b/slides/kube-halfday.yml
@@ -37,6 +37,7 @@ chapters:
   - k8s/ourapponkube.md
   #- k8s/kubectlproxy.md
   #- k8s/localkubeconfig.md
+  #- k8s/accessinternal.md
 - - k8s/dashboard.md
   - k8s/kubectlscale.md
   - k8s/daemonset.md
diff --git a/slides/kube-selfpaced.yml b/slides/kube-selfpaced.yml
index df3fc8a3..54d1d906 100644
--- a/slides/kube-selfpaced.yml
+++ b/slides/kube-selfpaced.yml
@@ -34,6 +34,7 @@ chapters:
 - - k8s/ourapponkube.md
   - k8s/kubectlproxy.md
   - k8s/localkubeconfig.md
+  - k8s/accessinternal.md
   - k8s/dashboard.md
   - k8s/kubectlscale.md
   - k8s/daemonset.md