Skip to content

Commit 8319549

Browse files
committed
content: replace rancher-based edu cluster with data science cluster
* NS_NAME convention * docu links * re-add FAQ section on how to configure kubectl
1 parent 66107e6 commit 8319549

File tree

5 files changed

+28
-23
lines changed

5 files changed

+28
-23
lines changed

content/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Or maybe you are already overwhelmed? No worries, try [How to learn DevOps](http
5252

5353
## External resources/repositories
5454

55-
* [Education Kubernetes Cluster Documentation](https://gitlab.bht-berlin.de/ris/doku/-/wikis/educluster) 📖
55+
* [Education Kubernetes Cluster Documentation](https://docs.cluster.ris.bht-berlin.de/) 📖
5656
* [showcase](https://gitlab.bht-berlin.de/fb6-wp11-devops/showcase)
5757
* [Tutorial solutions](https://github.com/lucendio/lecture-devops-code/tutorials)
5858
* [code examples](https://github.com/lucendio/lecture-devops-code)

content/exercises/deploy-app-on-kubernetes.md

Lines changed: 10 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -58,15 +58,9 @@ can be found
5858

5959
### (0) Preparations {id="0-prep-edu-cluster"}
6060

61-
{{< hint info >}}
62-
📖 [__Upstream documentation__ (german)](https://gitlab.bht-berlin.de/ris/doku/-/wikis/educluster#nutzung-des-clusters-mit-kubectl)
63-
{{< /hint >}}
64-
65-
1. [login and obtain the *Kubeconfig File*]({{< ref "/faq/cloud-and-infrastructure#kubeconfig-of-edu-cluster">}})
66-
2. navigate to *Projects/Namespaces*, click on *Add Namespace* (right) in the area where the project is named after
67-
this module; give the namespace a meaningful & unique name (e.g. university/student account ID)
68-
3. [install `kubectl`](https://kubernetes.io/docs/tasks/tools/#kubectl) on your workstation, if it doesn't
69-
exist already
61+
Assuming [prerequisites](#prerequisites) are meet and you can access the cluster with `kubectl`, the
62+
Kubernetes *namespace* (`{{ NS_NAME }}`) for you to use moving forward, is named the same as the
63+
username of your university account.
7064

7165
{{< hint warning >}}
7266
Moving forward, either use `-n {{ NS_NAME }}` whenever namespaced objects are involved, or configure it as the
@@ -240,11 +234,10 @@ To eventually make the application available from outside the cluster, write an
240234
pointing to the `Service` that you just created.
241235

242236
{{< hint warning >}}
243-
The ingress controller of the education cluster runs on a single node (`141.64.89.201`)
244-
directly on the cluster. The respective DNS entry is an A record pointing to `*.lehre.ris.bht-berlin.de`,
245-
which is why the ingress host must be set to `{{ SUB_DOMAIN }}.lehre.ris.bht-berlin.de`, where `SUB_DOMAIN`
246-
is a virtual but globally unique host name with the format: `{{ SERVICE_NAME }}-{{ NS_NAME }}`, e.g.
247-
`myservice-987456.lehre.ris.bht-berlin.de` (see [*Preparations* section]({{< relref "#0-prep-edu-cluster" >}}))
237+
All cluster users share the same DNS zone `project.ris.bht-berlin.de`, which is why the ingress *host* must be set
238+
to `{{ SUB_DOMAIN }}.project.ris.bht-berlin.de`, where `SUB_DOMAIN` is a virtual but globally unique host name with
239+
the format: `{{ SERVICE_NAME }}-{{ NS_NAME }}`, e.g. `myservice-abcd1234.project.ris.bht-berlin.de`
240+
(see [*Preparations* section]({{< relref "#0-prep-edu-cluster" >}}))
248241
{{< /hint >}}
249242

250243
```bash
@@ -256,8 +249,9 @@ Finally, verify that the application is indeed accessible from your browser (or
256249

257250
### (4) Cleaning up
258251

259-
Use the [cluster management web console](https://rancher.ris.beuth-hochschule.de) to delete your namespace,
260-
which will then delete all associated objects.
252+
```bash
253+
kubectl delete all --all
254+
```
261255

262256

263257
## Solution: Minikube {id="solution-minikube"}

content/exercises/manage-kubernetes-objects-with-helm.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -202,8 +202,8 @@ helm uninstall {{ RELEASE_NAME }}
202202
### (4) Enable TLS
203203

204204
The feature is covered in the upstream documentation
205-
([TLS](https://gitlab.bht-berlin.de/ris/doku/-/wikis/educluster#ressourcen-service-ingress),
206-
You just have to integrate the respective attributes and objects into you chart(s) and make them
205+
([TLS](https://docs.cluster.ris.bht-berlin.de/user/ingress/)) and may require additional permission upon request.
206+
If permitted, you just have to integrate the respective attributes and objects into you chart(s) and make them
207207
configurable via Helm values if needed.
208208

209209

content/exercises/persist-state-on-kubernetes.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,8 @@ TODO
4949
### (1) Enable TLS and Data persistence
5050

5151
Both features are covered in the upstream documentation
52-
([TLS](https://gitlab.bht-berlin.de/ris/doku/-/wikis/educluster#ressourcen-service-ingress),
53-
[Storage](https://gitlab.bht-berlin.de/ris/doku/-/wikis/educluster#ressourcen-volumes-persistener-speicher-f%C3%BCr-deployments-und-pods)).
52+
([TLS](https://docs.cluster.ris.bht-berlin.de/user/ingress/),
53+
[Storage](https://docs.cluster.ris.bht-berlin.de/user/storage/)).
5454
You just have to integrate the respective attributes and objects into you chart(s) and make them
5555
configurable via Helm values if needed.
5656

content/faq/cloud-and-infrastructure.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,7 @@ a) your workstation has enough resources (CPU, memory) to host one or more virtu
1616

1717
b) have a look at the link section on [*cloud providers*]({{< ref "/links#cloud-providers" >}})
1818

19-
c) the university provides a Kubernetes cluster managed with Rancher (requires student account, and VPN access if you
20-
are not on-site)
19+
c) the university provides a Kubernetes cluster (requires student account, and VPN access)
2120

2221

2322
## Which cloud provider should I use?
@@ -107,6 +106,18 @@ __*Example with DNS delegation (AWS + Name.com):*__
107106
4. Create additional records, e.g. `sub.doamin.tld` in the *Hosted Zone* on AWS Route 53 with OpenTofu
108107

109108

109+
## How to configure `~/.kube/config` (`KUBECONFIG`) for `kubectl` in order to access the university's Kubernetes cluster? {id="kubeconfig-of-edu-cluster"}
110+
111+
{{< hint warning >}}
112+
Did you already enter your university email address in the respective account list?
113+
{{< /hint >}}
114+
115+
1. connect to the internal network via [VPN](https://doku.bht-berlin.de/zugang/vpn)
116+
2. [test](https://auth.cluster.ris.bht-berlin.de) whether your university account is permitted
117+
to access the cluster
118+
3. follow the [cluster documentation](https://docs.cluster.ris.bht-berlin.de/user/kubectl/)
119+
120+
110121
## Which registry supports pushing container images?
111122

112123
The following registries are hosted offerings:

0 commit comments

Comments
 (0)