From f741cf5b23e9443c35f2a26becd5efff7af4ee39 Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Tue, 10 Apr 2018 14:33:49 -0500 Subject: [PATCH 01/12] Clarify error message upon start --- slides/kube/kubectlexpose.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/slides/kube/kubectlexpose.md b/slides/kube/kubectlexpose.md index 391e2144..a18d8ef4 100644 --- a/slides/kube/kubectlexpose.md +++ b/slides/kube/kubectlexpose.md @@ -137,7 +137,12 @@ Note: please DO NOT call the service `search`. It would collide with the TLD. -- -Our requests are load balanced across multiple pods. +We may see `curl: (7) Failed to connect to _IP_ port 9200: Connection refused` +This is normal while the service starts up + +-- + +Once it's running, our requests are load balanced across multiple pods. --- From af1347ca172e42355ab271539197df21eae0fdfe Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Tue, 10 Apr 2018 15:07:42 -0500 Subject: [PATCH 02/12] Clarify endpoints --- slides/kube/kubectlexpose.md | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/slides/kube/kubectlexpose.md b/slides/kube/kubectlexpose.md index a18d8ef4..dc1f2f95 100644 --- a/slides/kube/kubectlexpose.md +++ b/slides/kube/kubectlexpose.md @@ -213,12 +213,15 @@ class: extra-details ## Viewing endpoint details -- When we have many endpoints, the previous command truncates the list +- When we have many endpoints, our display commands truncate the list + ```bash + kubectl get endpoints + ``` - If we want to see the full list, we can use one of the following commands: ```bash - kubectl describe endpoint elastic - kubectl get endpoint elastic -o yaml + kubectl describe endpoints elastic + kubectl get endpoints elastic -o yaml ``` - These addresses will show us a list of IP addresses @@ -227,3 +230,23 @@ class: extra-details ```bash kubectl get pods -l run=elastic -o wide ``` + +--- + +class: extra-details + +## endpoints not endpoint + +- `endpoints` is the only resource that cannot be singular + +```bash +kubectl get endpoint +kubectl describe endpoint +``` + +-- + +.warning[error: the server doesn't have a resource type "endpoint"] + +- This is because the type itself is plural (unlike every other resource) +- There is no `endpoint` object: `type Endpoints struct` From 1183e2e4bf9bdc793f1655537a98cd4df1e75217 Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Wed, 11 Apr 2018 18:55:23 -0500 Subject: [PATCH 03/12] Making slide easier to read --- slides/kube/namespaces.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/slides/kube/namespaces.md b/slides/kube/namespaces.md index aa06ace6..110ee4f5 100644 --- a/slides/kube/namespaces.md +++ b/slides/kube/namespaces.md @@ -2,21 +2,23 @@ - We cannot have two resources with the same name + (Or can we...?) + -- - We cannot have two resources *of the same type* with the same name - (But it's OK to have a `rng` service, a `rng` deployment, and a `rng` daemon set) + (But it's OK to have a `rng` service, a `rng` deployment, and a `rng` daemon set!) -- - We cannot have two resources of the same type with the same name *in the same namespace* - (But it's OK to have e.g. two `rng` services in different namespaces) + (But it's OK to have e.g. two `rng` services in different namespaces!) -- -- In other words: the tuple *(type, name, namespace)* needs to be unique +- In other words: the tuple *(type, name, namespace)* needs to be unique (In the resource YAML, the type is called `Kind`) @@ -190,4 +192,4 @@ Note: it might take a minute or two for the app to be up and running. - the [Kubernetes documentation about network policies](https://kubernetes.io/docs/concepts/services-networking/network-policies/) - - this [talk about network policies at KubeCon 2017 US](https://www.youtube.com/watch?v=3gGpMmYeEO8) by [@ahmetb](https://twitter.com/ahmetb) \ No newline at end of file + - this [talk about network policies at KubeCon 2017 US](https://www.youtube.com/watch?v=3gGpMmYeEO8) by [@ahmetb](https://twitter.com/ahmetb) From fce69b6bb29b301e357176ac09dc4988759a20af Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Wed, 11 Apr 2018 19:34:51 -0500 Subject: [PATCH 04/12] Azure directions are also included --- prepare-vms/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/prepare-vms/README.md b/prepare-vms/README.md index 03678fbb..8c09a60f 100644 --- a/prepare-vms/README.md +++ b/prepare-vms/README.md @@ -1,4 +1,4 @@ -# Trainer tools to create and prepare VMs for Docker workshops on AWS +# Trainer tools to create and prepare VMs for Docker workshops on AWS or Azure ## Prerequisites @@ -14,7 +14,7 @@ And if you want to generate printable cards: ## General Workflow - fork/clone repo -- set required environment variables for AWS +- set required environment variables (for AWS; placeholders otherwise) - create your own setting file from `settings/example.yaml` - if necessary, increase allowed open files: `ulimit -Sn 10000` - run `./workshopctl` commands to create instances, install docker, setup each users environment in node1, other management tasks From 5ef96a29ac731a17b18c0377fa7f7531831f6941 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Petazzoni?= Date: Thu, 12 Apr 2018 00:37:18 -0500 Subject: [PATCH 05/12] Update kubectlexpose.md --- slides/kube/kubectlexpose.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/slides/kube/kubectlexpose.md b/slides/kube/kubectlexpose.md index dc1f2f95..ec655327 100644 --- a/slides/kube/kubectlexpose.md +++ b/slides/kube/kubectlexpose.md @@ -235,18 +235,17 @@ class: extra-details class: extra-details -## endpoints not endpoint +## `endpoints` not `endpoint` - `endpoints` is the only resource that cannot be singular ```bash -kubectl get endpoint -kubectl describe endpoint +$ kubectl get endpoint +error: the server doesn't have a resource type "endpoint" ``` --- - -.warning[error: the server doesn't have a resource type "endpoint"] - - This is because the type itself is plural (unlike every other resource) + - There is no `endpoint` object: `type Endpoints struct` + +- The type doesn't represent a single endpoint, but a list of endpoints From 053bbe7028ff885e1f1a2be613f0bc5f155494b0 Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Thu, 12 Apr 2018 07:39:02 -0500 Subject: [PATCH 06/12] Bold instead of highlighting --- slides/kube/namespaces.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/slides/kube/namespaces.md b/slides/kube/namespaces.md index 110ee4f5..00caedac 100644 --- a/slides/kube/namespaces.md +++ b/slides/kube/namespaces.md @@ -18,7 +18,7 @@ -- -- In other words: the tuple *(type, name, namespace)* needs to be unique +- In other words: **the tuple *(type, name, namespace)* needs to be unique** (In the resource YAML, the type is called `Kind`) From c3324cf64c49fcf61adde5cfc7744a599f71cffc Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Thu, 12 Apr 2018 07:41:43 -0500 Subject: [PATCH 07/12] More general --- prepare-vms/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/prepare-vms/README.md b/prepare-vms/README.md index 8c09a60f..7de6fb00 100644 --- a/prepare-vms/README.md +++ b/prepare-vms/README.md @@ -14,7 +14,7 @@ And if you want to generate printable cards: ## General Workflow - fork/clone repo -- set required environment variables (for AWS; placeholders otherwise) +- set required environment variables - create your own setting file from `settings/example.yaml` - if necessary, increase allowed open files: `ulimit -Sn 10000` - run `./workshopctl` commands to create instances, install docker, setup each users environment in node1, other management tasks From 25d560cf46285eb8b5cd45ae4b919463f6a89aa7 Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Thu, 12 Apr 2018 07:48:25 -0500 Subject: [PATCH 08/12] Directory missing --- slides/kube/helm.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/slides/kube/helm.md b/slides/kube/helm.md index ce31cad3..9a688d25 100644 --- a/slides/kube/helm.md +++ b/slides/kube/helm.md @@ -154,9 +154,10 @@ The chart's metadata includes an URL to the project's home page. helm create dockercoins ``` -- Move away the sample templates: +- Move away the sample templates and create an empty template directory: ```bash mv dockercoins/templates dockercoins/default-templates + mkdir dockercoins/templates ``` ] From 2c3a442a4cb65cec1ce35847c36451a4bc5c6a99 Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Thu, 12 Apr 2018 08:11:43 -0500 Subject: [PATCH 09/12] wording correction The addresses aren't what show us the addresses - it seems clear from context that this should be "commands". --- slides/kube/kubectlexpose.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/slides/kube/kubectlexpose.md b/slides/kube/kubectlexpose.md index ec655327..4b6ef285 100644 --- a/slides/kube/kubectlexpose.md +++ b/slides/kube/kubectlexpose.md @@ -224,7 +224,7 @@ class: extra-details kubectl get endpoints elastic -o yaml ``` -- These addresses will show us a list of IP addresses +- These commands will show us a list of IP addresses - These IP addresses should match the addresses of the corresponding pods: ```bash From a12a38a7a97e07932239ebccdbcbec3999d18016 Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Thu, 12 Apr 2018 09:50:12 -0500 Subject: [PATCH 10/12] Use prometheus as example --- slides/kube/helm.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/slides/kube/helm.md b/slides/kube/helm.md index ce31cad3..99909995 100644 --- a/slides/kube/helm.md +++ b/slides/kube/helm.md @@ -88,9 +88,9 @@ fine for personal and development clusters.) helm search ``` -- View charts related to `gitlab`: +- View charts related to `prometheus`: ```bash - helm search gitlab + helm search prometheus ``` ] From da064a60056671bd359e5090ee673d1d980bb3eb Mon Sep 17 00:00:00 2001 From: Bridget Kromhout Date: Thu, 12 Apr 2018 10:24:01 -0500 Subject: [PATCH 11/12] Clarify chart install --- slides/kube/helm.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/slides/kube/helm.md b/slides/kube/helm.md index ce31cad3..8dec2d00 100644 --- a/slides/kube/helm.md +++ b/slides/kube/helm.md @@ -193,12 +193,19 @@ The chart's metadata includes an URL to the project's home page. --- -## Testing our chart +## Testing our helm chart -- We can now install our chart with `helm install dockercoins` +.exercise[ - (In that case, `dockercoins` is the path to the chart) +- Let's install our helm chart! (`dockercoins` is the path to the chart) + ```bash + helm install dockercoins + ``` +] -- However, since the application is already deployed, this will fail +-- + +- Since the application is already deployed, this will fail:
+`Error: release loitering-otter failed: services "hasher" already exists` - To avoid naming conflicts, we will deploy the application in another *namespace* From 56e47c35502beaaa9dd16cc240acd1cb2f5dbd3d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Petazzoni?= Date: Fri, 13 Apr 2018 08:06:23 +0200 Subject: [PATCH 12/12] Update kubectlexpose.md Add line break for readability --- slides/kube/kubectlexpose.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/slides/kube/kubectlexpose.md b/slides/kube/kubectlexpose.md index 4b6ef285..8b91773c 100644 --- a/slides/kube/kubectlexpose.md +++ b/slides/kube/kubectlexpose.md @@ -137,8 +137,9 @@ Note: please DO NOT call the service `search`. It would collide with the TLD. -- -We may see `curl: (7) Failed to connect to _IP_ port 9200: Connection refused` -This is normal while the service starts up +We may see `curl: (7) Failed to connect to _IP_ port 9200: Connection refused`. + +This is normal while the service starts up. --