Project

General

Profile

The ungleich kubernetes infrastructure » History » Version 103

Nico Schottelius, 05/24/2022 12:07 PM

1 22 Nico Schottelius
h1. The ungleich kubernetes infrastructure and ungleich kubernetes manual
2 1 Nico Schottelius
3 3 Nico Schottelius
{{toc}}
4
5 1 Nico Schottelius
h2. Status
6
7 28 Nico Schottelius
This document is **pre-production**.
8
This document is to become the ungleich kubernetes infrastructure overview as well as the ungleich kubernetes manual.
9 1 Nico Schottelius
10 10 Nico Schottelius
h2. k8s clusters
11
12 95 Nico Schottelius
| Cluster         | Purpose/Setup     | Maintainer | Master(s)                  | argo                                                | v4 http proxy | last verified |
13
| c0.k8s.ooo      | Dev               | -          | UNUSED                     |                                                     |               |    2021-10-05 |
14
| c1.k8s.ooo      | retired           |            | -                          |                                                     |               |    2022-03-15 |
15
| c2.k8s.ooo      | Dev p7 HW         | Nico       | server47 server53 server54 | "argo":https://argocd-server.argocd.svc.c2.k8s.ooo  |               |    2021-10-05 |
16
| c3.k8s.ooo      | retired           | -          | -                          |                                                     |               |    2021-10-05 |
17
| c4.k8s.ooo      | Dev2 p7 HW        | Jin-Guk    | server52 server53 server54 |                                                     |               |             - |
18
| c5.k8s.ooo      | retired           |            | -                          |                                                     |               |    2022-03-15 |
19
| c6.k8s.ooo      | Dev p6 VM Jin-Guk | Jin-Guk    |                            |                                                     |               |               |
20
| [[p5.k8s.ooo]]  | production        |            | server34 server36 server38 | "argo":https://argocd-server.argocd.svc.p5.k8s.ooo  |             - |               |
21
| [[p6.k8s.ooo]]  | production        |            | server67 server69 server71 | "argo":https://argocd-server.argocd.svc.p6.k8s.ooo  | 147.78.194.13 |    2021-10-05 |
22
| [[p10.k8s.ooo]] | production        |            | server63 server65 server83 | "argo":https://argocd-server.argocd.svc.p10.k8s.ooo | 147.78.194.12 |    2021-10-05 |
23
| fnnf            | development       | Nico       | server75                   |                                                     |               |               |
24 78 Nico Schottelius
25 21 Nico Schottelius
26 1 Nico Schottelius
h2. General architecture and components overview
27
28
* All k8s clusters are IPv6 only
29
* We use BGP peering to propagate podcidr and serviceCidr networks to our infrastructure
30
* The main public testing repository is "ungleich-k8s":https://code.ungleich.ch/ungleich-public/ungleich-k8s
31 18 Nico Schottelius
** Private configurations are found in the **k8s-config** repository
32 1 Nico Schottelius
33
h3. Cluster types
34
35 28 Nico Schottelius
| **Type/Feature**            | **Development**                | **Production**         |
36
| Min No. nodes               | 3 (1 master, 3 worker)         | 5 (3 master, 3 worker) |
37
| Recommended minimum         | 4 (dedicated master, 3 worker) | 8 (3 master, 5 worker) |
38
| Separation of control plane | optional                       | recommended            |
39
| Persistent storage          | required                       | required               |
40
| Number of storage monitors  | 3                              | 5                      |
41 1 Nico Schottelius
42 43 Nico Schottelius
h2. General k8s operations
43 1 Nico Schottelius
44 46 Nico Schottelius
h3. Cheat sheet / external great references
45
46
* "kubectl cheatsheet":https://kubernetes.io/docs/reference/kubectl/cheatsheet/
47
48 69 Nico Schottelius
h3. Allowing to schedule work on the control plane
49
50
* Mostly for single node / test / development clusters
51
* Just remove the master taint as follows
52
53
<pre>
54
kubectl taint nodes --all node-role.kubernetes.io/master-
55
</pre>
56
57
58 44 Nico Schottelius
h3. Get the cluster admin.conf
59
60
* On the masters of each cluster you can find the file @/etc/kubernetes/admin.conf@
61
* To be able to administrate the cluster you can copy the admin.conf to your local machine
62
* Multi cluster debugging can very easy if you name the config ~/cX-admin.conf (see example below)
63
64
<pre>
65
% scp root@server47.place7.ungleich.ch:/etc/kubernetes/admin.conf ~/c2-admin.conf
66
% export KUBECONFIG=~/c2-admin.conf    
67
% kubectl get nodes
68
NAME       STATUS                     ROLES                  AGE   VERSION
69
server47   Ready                      control-plane,master   82d   v1.22.0
70
server48   Ready                      control-plane,master   82d   v1.22.0
71
server49   Ready                      <none>                 82d   v1.22.0
72
server50   Ready                      <none>                 82d   v1.22.0
73
server59   Ready                      control-plane,master   82d   v1.22.0
74
server60   Ready,SchedulingDisabled   <none>                 82d   v1.22.0
75
server61   Ready                      <none>                 82d   v1.22.0
76
server62   Ready                      <none>                 82d   v1.22.0               
77
</pre>
78
79 18 Nico Schottelius
h3. Installing a new k8s cluster
80 8 Nico Schottelius
81 9 Nico Schottelius
* Decide on the cluster name (usually *cX.k8s.ooo*), X counting upwards
82 28 Nico Schottelius
** Using pXX.k8s.ooo for production clusters of placeXX
83 9 Nico Schottelius
* Use cdist to configure the nodes with requirements like crio
84
* Decide between single or multi node control plane setups (see below)
85 28 Nico Schottelius
** Single control plane suitable for development clusters
86 9 Nico Schottelius
87 28 Nico Schottelius
Typical init procedure:
88 9 Nico Schottelius
89 28 Nico Schottelius
* Single control plane: @kubeadm init --config bootstrap/XXX/kubeadm.yaml@
90
* Multi control plane (HA): @kubeadm init --config bootstrap/XXX/kubeadm.yaml --upload-certs@
91 10 Nico Schottelius
92 29 Nico Schottelius
h3. Deleting a pod that is hanging in terminating state
93
94
<pre>
95
kubectl delete pod <PODNAME> --grace-period=0 --force --namespace <NAMESPACE>
96
</pre>
97
98
(from https://stackoverflow.com/questions/35453792/pods-stuck-in-terminating-status)
99
100 42 Nico Schottelius
h3. Listing nodes of a cluster
101
102
<pre>
103
[15:05] bridge:~% kubectl get nodes
104
NAME       STATUS   ROLES                  AGE   VERSION
105
server22   Ready    <none>                 52d   v1.22.0
106
server23   Ready    <none>                 52d   v1.22.2
107
server24   Ready    <none>                 52d   v1.22.0
108
server25   Ready    <none>                 52d   v1.22.0
109
server26   Ready    <none>                 52d   v1.22.0
110
server27   Ready    <none>                 52d   v1.22.0
111
server63   Ready    control-plane,master   52d   v1.22.0
112
server64   Ready    <none>                 52d   v1.22.0
113
server65   Ready    control-plane,master   52d   v1.22.0
114
server66   Ready    <none>                 52d   v1.22.0
115
server83   Ready    control-plane,master   52d   v1.22.0
116
server84   Ready    <none>                 52d   v1.22.0
117
server85   Ready    <none>                 52d   v1.22.0
118
server86   Ready    <none>                 52d   v1.22.0
119
</pre>
120
121 41 Nico Schottelius
h3. Removing / draining a node
122
123
Usually @kubectl drain server@ should do the job, but sometimes we need to be more aggressive:
124
125 1 Nico Schottelius
<pre>
126 103 Nico Schottelius
kubectl drain --delete-emptydir-data --ignore-daemonsets serverXX
127 42 Nico Schottelius
</pre>
128
129
h3. Readding a node after draining
130
131
<pre>
132
kubectl uncordon serverXX
133 1 Nico Schottelius
</pre>
134 43 Nico Schottelius
135 50 Nico Schottelius
h3. (Re-)joining worker nodes after creating the cluster
136 49 Nico Schottelius
137
* We need to have an up-to-date token
138
* We use different join commands for the workers and control plane nodes
139
140
Generating the join command on an existing control plane node:
141
142
<pre>
143
kubeadm token create --print-join-command
144
</pre>
145
146 50 Nico Schottelius
h3. (Re-)joining control plane nodes after creating the cluster
147 1 Nico Schottelius
148 50 Nico Schottelius
* We generate the token again
149
* We upload the certificates
150
* We need to combine/create the join command for the control plane node
151
152
Example session:
153
154
<pre>
155
% kubeadm token create --print-join-command
156
kubeadm join p10-api.k8s.ooo:6443 --token xmff4i.ABC --discovery-token-ca-cert-hash sha256:longhash 
157
158
% kubeadm init phase upload-certs --upload-certs
159
[upload-certs] Storing the certificates in Secret "kubeadm-certs" in the "kube-system" Namespace
160
[upload-certs] Using certificate key:
161
CERTKEY
162
163
# Then we use these two outputs on the joining node:
164
165
kubeadm join p10-api.k8s.ooo:6443 --token xmff4i.ABC --discovery-token-ca-cert-hash sha256:longhash --control-plane --certificate-key CERTKEY
166
</pre>
167
168
Commands to be used on a control plane node:
169
170
<pre>
171
kubeadm token create --print-join-command
172
kubeadm init phase upload-certs --upload-certs
173
</pre>
174
175
Commands to be used on the joining node:
176
177
<pre>
178
JOINCOMMAND --control-plane --certificate-key CERTKEY
179
</pre>
180 49 Nico Schottelius
181 51 Nico Schottelius
SEE ALSO
182
183
* https://stackoverflow.com/questions/63936268/how-to-generate-kubeadm-token-for-secondary-control-plane-nodes
184
* https://blog.scottlowe.org/2019/08/15/reconstructing-the-join-command-for-kubeadm/
185
186 53 Nico Schottelius
h3. How to fix etcd does not start when rejoining a kubernetes cluster as a control plane
187 52 Nico Schottelius
188
If during the above step etcd does not come up, @kubeadm join@ can hang as follows:
189
190
<pre>
191
[control-plane] Creating static Pod manifest for "kube-apiserver"                                                              
192
[control-plane] Creating static Pod manifest for "kube-controller-manager"                                                     
193
[control-plane] Creating static Pod manifest for "kube-scheduler"                                                              
194
[check-etcd] Checking that the etcd cluster is healthy                                                                         
195
error execution phase check-etcd: etcd cluster is not healthy: failed to dial endpoint https://[2a0a:e5c0:10:1:225:b3ff:fe20:37
196
8a]:2379 with maintenance client: context deadline exceeded                                                                    
197
To see the stack trace of this error execute with --v=5 or higher         
198
</pre>
199
200
Then the problem is likely that the etcd server is still a member of the cluster. We first need to remove it from the etcd cluster and then the join works.
201
202
To fix this we do:
203
204
* Find a working etcd pod
205
* Find the etcd members / member list
206
* Remove the etcd member that we want to re-join the cluster
207
208
209
<pre>
210
# Find the etcd pods
211
kubectl -n kube-system get pods -l component=etcd,tier=control-plane
212
213
# Get the list of etcd servers with the member id 
214
kubectl exec -n kube-system -ti ETCDPODNAME -- etcdctl --endpoints '[::1]:2379' --cacert /etc/kubernetes/pki/etcd/ca.crt --cert  /etc/kubernetes/pki/etcd/server.crt --key /etc/kubernetes/pki/etcd/server.key member list
215
216
# Remove the member
217
kubectl exec -n kube-system -ti ETCDPODNAME -- etcdctl --endpoints '[::1]:2379' --cacert /etc/kubernetes/pki/etcd/ca.crt --cert  /etc/kubernetes/pki/etcd/server.crt --key /etc/kubernetes/pki/etcd/server.key member remove MEMBERID
218
</pre>
219
220
Sample session:
221
222
<pre>
223
[10:48] line:~% kubectl -n kube-system get pods -l component=etcd,tier=control-plane
224
NAME            READY   STATUS    RESTARTS     AGE
225
etcd-server63   1/1     Running   0            3m11s
226
etcd-server65   1/1     Running   3            7d2h
227
etcd-server83   1/1     Running   8 (6d ago)   7d2h
228
[10:48] line:~% kubectl exec -n kube-system -ti etcd-server65 -- etcdctl --endpoints '[::1]:2379' --cacert /etc/kubernetes/pki/etcd/ca.crt --cert  /etc/kubernetes/pki/etcd/server.crt --key /etc/kubernetes/pki/etcd/server.key member list
229
356891cd676df6e4, started, server65, https://[2a0a:e5c0:10:1:225:b3ff:fe20:375c]:2380, https://[2a0a:e5c0:10:1:225:b3ff:fe20:375c]:2379, false
230
371b8a07185dee7e, started, server63, https://[2a0a:e5c0:10:1:225:b3ff:fe20:378a]:2380, https://[2a0a:e5c0:10:1:225:b3ff:fe20:378a]:2379, false
231
5942bc58307f8af9, started, server83, https://[2a0a:e5c0:10:1:3e4a:92ff:fe79:bb98]:2380, https://[2a0a:e5c0:10:1:3e4a:92ff:fe79:bb98]:2379, false
232
233
[10:48] line:~% kubectl exec -n kube-system -ti etcd-server65 -- etcdctl --endpoints '[::1]:2379' --cacert /etc/kubernetes/pki/etcd/ca.crt --cert  /etc/kubernetes/pki/etcd/server.crt --key /etc/kubernetes/pki/etcd/server.key member remove 371b8a07185dee7e
234
Member 371b8a07185dee7e removed from cluster e3c0805f592a8f77
235 1 Nico Schottelius
236
</pre>
237
238
SEE ALSO
239
240
* We found the solution using https://stackoverflow.com/questions/67921552/re-installed-node-cannot-join-kubernetes-cluster
241 56 Nico Schottelius
242 101 Nico Schottelius
h3. Hardware Maintenance using ungleich-hardware
243
244
Use the following manifest and replace the HOST with the actual host:
245
246
<pre>
247
apiVersion: v1
248
kind: Pod
249
metadata:
250
  name: ungleich-hardware-HOST
251
spec:
252
  containers:
253
  - name: ungleich-hardware
254
    image: ungleich/ungleich-hardware:0.0.5
255
    args:
256
    - sleep
257
    - "1000000"
258
    volumeMounts:
259
      - mountPath: /dev
260
        name: dev
261
    securityContext:
262
      privileged: true
263
  nodeSelector:
264
    kubernetes.io/hostname: "HOST"
265
266
  volumes:
267
    - name: dev
268
      hostPath:
269
        path: /dev
270
</pre>
271
272 102 Nico Schottelius
Also see: [[The_ungleich_hardware_maintenance_guide]]
273
274 62 Nico Schottelius
h2. Calico CNI
275
276
h3. Calico Installation
277
278
* We install "calico using helm":https://docs.projectcalico.org/getting-started/kubernetes/helm
279
* This has the following advantages:
280
** Easy to upgrade
281
** Does not require os to configure IPv6/dual stack settings as the tigera operator figures out things on its own
282
283
Usually plain calico can be installed directly using:
284
285
<pre>
286
helm repo add projectcalico https://docs.projectcalico.org/charts
287 94 Nico Schottelius
helm install calico projectcalico/tigera-operator --version v3.20.4
288 1 Nico Schottelius
</pre>
289 92 Nico Schottelius
290
* Check the tags on https://github.com/projectcalico/calico/tags for the latest release
291 62 Nico Schottelius
292
h3. Installing calicoctl
293
294
To be able to manage and configure calico, we need to 
295
"install calicoctl (we choose the version as a pod)":https://docs.projectcalico.org/getting-started/clis/calicoctl/install#install-calicoctl-as-a-kubernetes-pod
296
297
<pre>
298
kubectl apply -f https://docs.projectcalico.org/manifests/calicoctl.yaml
299
</pre>
300
301 93 Nico Schottelius
Or version specific:
302
303
<pre>
304
kubectl apply -f https://github.com/projectcalico/calico/blob/v3.20.4/manifests/calicoctl.yaml
305 97 Nico Schottelius
306
# For 3.22
307
kubectl apply -f https://projectcalico.docs.tigera.io/archive/v3.22/manifests/calicoctl.yaml
308 93 Nico Schottelius
</pre>
309
310 70 Nico Schottelius
And making it easier accessible by alias:
311
312
<pre>
313
alias calicoctl="kubectl exec -i -n kube-system calicoctl -- /calicoctl"
314
</pre>
315
316 62 Nico Schottelius
h3. Calico configuration
317
318 63 Nico Schottelius
By default our k8s clusters "BGP peer":https://docs.projectcalico.org/networking/bgp
319
with an upstream router to propagate podcidr and servicecidr.
320 62 Nico Schottelius
321
Default settings in our infrastructure:
322
323
* We use a full-mesh using the @nodeToNodeMeshEnabled: true@ option
324
* We keep the original next hop so that *only* the server with the pod is announcing it (instead of ecmp)
325 1 Nico Schottelius
* We use private ASNs for k8s clusters
326 63 Nico Schottelius
* We do *not* use any overlay
327 62 Nico Schottelius
328
After installing calico and calicoctl the last step of the installation is usually:
329
330 1 Nico Schottelius
<pre>
331 79 Nico Schottelius
calicoctl create -f - < calico-bgp.yaml
332 62 Nico Schottelius
</pre>
333
334
335
A sample BGP configuration:
336
337
<pre>
338
---
339
apiVersion: projectcalico.org/v3
340
kind: BGPConfiguration
341
metadata:
342
  name: default
343
spec:
344
  logSeverityScreen: Info
345
  nodeToNodeMeshEnabled: true
346
  asNumber: 65534
347
  serviceClusterIPs:
348
  - cidr: 2a0a:e5c0:10:3::/108
349
  serviceExternalIPs:
350
  - cidr: 2a0a:e5c0:10:3::/108
351
---
352
apiVersion: projectcalico.org/v3
353
kind: BGPPeer
354
metadata:
355
  name: router1-place10
356
spec:
357
  peerIP: 2a0a:e5c0:10:1::50
358
  asNumber: 213081
359
  keepOriginalNextHop: true
360
</pre>
361
362 64 Nico Schottelius
h2. ArgoCD / ArgoWorkFlow
363 56 Nico Schottelius
364 60 Nico Schottelius
h3. Argocd Installation
365 1 Nico Schottelius
366 60 Nico Schottelius
As there is no configuration management present yet, argocd is installed using
367
368 1 Nico Schottelius
<pre>
369 60 Nico Schottelius
kubectl create namespace argocd
370 86 Nico Schottelius
371 96 Nico Schottelius
# Specific Version
372
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v2.3.2/manifests/install.yaml
373 86 Nico Schottelius
374
# OR: latest stable
375 60 Nico Schottelius
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
376 1 Nico Schottelius
</pre>
377 56 Nico Schottelius
378 60 Nico Schottelius
* See https://argo-cd.readthedocs.io/en/stable/
379 1 Nico Schottelius
380 60 Nico Schottelius
h3. Get the argocd credentials
381
382
<pre>
383
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo ""
384
</pre>
385 52 Nico Schottelius
386 87 Nico Schottelius
h3. Accessing argocd
387
388
In regular IPv6 clusters:
389
390
* Navigate to https://argocd-server.argocd.CLUSTERDOMAIN
391
392
In legacy IPv4 clusters
393
394
<pre>
395
kubectl --namespace argocd port-forward svc/argocd-server 8080:80
396
</pre>
397
398 88 Nico Schottelius
* Navigate to https://localhost:8080
399
400 68 Nico Schottelius
h3. Using the argocd webhook to trigger changes
401 67 Nico Schottelius
402
* To trigger changes post json https://argocd.example.com/api/webhook
403
404 72 Nico Schottelius
h3. Deploying an application
405
406
* Applications are deployed via git towards gitea (code.ungleich.ch) and then pulled by argo
407 73 Nico Schottelius
* Always include the *redmine-url* pointing to the (customer) ticket
408
** Also add the support-url if it exists
409 72 Nico Schottelius
410
Application sample
411
412
<pre>
413
apiVersion: argoproj.io/v1alpha1
414
kind: Application
415
metadata:
416
  name: gitea-CUSTOMER
417
  namespace: argocd
418
spec:
419
  destination:
420
    namespace: default
421
    server: 'https://kubernetes.default.svc'
422
  source:
423
    path: apps/prod/gitea
424
    repoURL: 'https://code.ungleich.ch/ungleich-intern/k8s-config.git'
425
    targetRevision: HEAD
426
    helm:
427
      parameters:
428
        - name: storage.data.storageClass
429
          value: rook-ceph-block-hdd
430
        - name: storage.data.size
431
          value: 200Gi
432
        - name: storage.db.storageClass
433
          value: rook-ceph-block-ssd
434
        - name: storage.db.size
435
          value: 10Gi
436
        - name: storage.letsencrypt.storageClass
437
          value: rook-ceph-block-hdd
438
        - name: storage.letsencrypt.size
439
          value: 50Mi
440
        - name: letsencryptStaging
441
          value: 'no'
442
        - name: fqdn
443
          value: 'code.verua.online'
444
  project: default
445
  syncPolicy:
446
    automated:
447
      prune: true
448
      selfHeal: true
449
  info:
450
    - name: 'redmine-url'
451
      value: 'https://redmine.ungleich.ch/issues/ISSUEID'
452
    - name: 'support-url'
453
      value: 'https://support.ungleich.ch/Ticket/Display.html?id=TICKETID'
454
</pre>
455
456 80 Nico Schottelius
h2. Helm related operations and conventions
457 55 Nico Schottelius
458 61 Nico Schottelius
We use helm charts extensively.
459
460
* In production, they are managed via argocd
461
* In development, helm chart can de developed and deployed manually using the helm utility.
462
463 55 Nico Schottelius
h3. Installing a helm chart
464
465
One can use the usual pattern of
466
467
<pre>
468
helm install <releasename> <chartdirectory>
469
</pre>
470
471
However often you want to reinstall/update when testing helm charts. The following pattern is "better", because it allows you to reinstall, if it is already installed:
472
473
<pre>
474
helm upgrade --install <releasename> <chartdirectory>
475 1 Nico Schottelius
</pre>
476 80 Nico Schottelius
477
h3. Naming services and deployments in helm charts [Application labels]
478
479
* We always have {{ .Release.Name }} to identify the current "instance"
480
* Deployments:
481
** use @app: <what it is>@, f.i. @app: nginx@, @app: postgres@, ...
482 81 Nico Schottelius
* See more about standard labels on
483
** https://kubernetes.io/docs/concepts/overview/working-with-objects/common-labels/
484
** https://helm.sh/docs/chart_best_practices/labels/
485 55 Nico Schottelius
486 43 Nico Schottelius
h2. Rook / Ceph Related Operations
487
488 71 Nico Schottelius
h3. Executing ceph commands
489
490
Using the ceph-tools pod as follows:
491
492
<pre>
493
kubectl exec -n rook-ceph -ti $(kubectl -n rook-ceph get pods -l app=rook-ceph-tools -o jsonpath='{.items[*].metadata.name}') -- ceph -s
494
</pre>
495
496 43 Nico Schottelius
h3. Inspecting the logs of a specific server
497
498
<pre>
499
# Get the related pods
500
kubectl -n rook-ceph get pods -l app=rook-ceph-osd-prepare 
501
...
502
503
# Inspect the logs of a specific pod
504
kubectl -n rook-ceph logs -f rook-ceph-osd-prepare-server23--1-444qx
505
506 71 Nico Schottelius
</pre>
507
508
h3. Inspecting the logs of the rook-ceph-operator
509
510
<pre>
511
kubectl -n rook-ceph logs -f -l app=rook-ceph-operator
512 43 Nico Schottelius
</pre>
513
514
h3. Triggering server prepare / adding new osds
515
516
The rook-ceph-operator triggers/watches/creates pods to maintain hosts. To trigger a full "re scan", simply delete that pod:
517
518
<pre>
519
kubectl -n rook-ceph delete pods -l app=rook-ceph-operator
520
</pre>
521
522
This will cause all the @rook-ceph-osd-prepare-..@ jobs to be recreated and thus OSDs to be created, if new disks have been added.
523
524
h3. Removing an OSD
525
526
* See "Ceph OSD Management":https://rook.io/docs/rook/v1.7/ceph-osd-mgmt.html
527 77 Nico Schottelius
* More specifically: https://github.com/rook/rook/blob/release-1.7/cluster/examples/kubernetes/ceph/osd-purge.yaml
528 99 Nico Schottelius
* Then delete the related deployment
529 41 Nico Schottelius
530 98 Nico Schottelius
Set osd id in the osd-purge.yaml and apply it. OSD should be down before.
531
532
<pre>
533
apiVersion: batch/v1
534
kind: Job
535
metadata:
536
  name: rook-ceph-purge-osd
537
  namespace: rook-ceph # namespace:cluster
538
  labels:
539
    app: rook-ceph-purge-osd
540
spec:
541
  template:
542
    metadata:
543
      labels:
544
        app: rook-ceph-purge-osd
545
    spec:
546
      serviceAccountName: rook-ceph-purge-osd
547
      containers:
548
        - name: osd-removal
549
          image: rook/ceph:master
550
          # TODO: Insert the OSD ID in the last parameter that is to be removed
551
          # The OSD IDs are a comma-separated list. For example: "0" or "0,2".
552
          # If you want to preserve the OSD PVCs, set `--preserve-pvc true`.
553
          #
554
          # A --force-osd-removal option is available if the OSD should be destroyed even though the
555
          # removal could lead to data loss.
556
          args:
557
            - "ceph"
558
            - "osd"
559
            - "remove"
560
            - "--preserve-pvc"
561
            - "false"
562
            - "--force-osd-removal"
563
            - "false"
564
            - "--osd-ids"
565
            - "SETTHEOSDIDHERE"
566
          env:
567
            - name: POD_NAMESPACE
568
              valueFrom:
569
                fieldRef:
570
                  fieldPath: metadata.namespace
571
            - name: ROOK_MON_ENDPOINTS
572
              valueFrom:
573
                configMapKeyRef:
574
                  key: data
575
                  name: rook-ceph-mon-endpoints
576
            - name: ROOK_CEPH_USERNAME
577
              valueFrom:
578
                secretKeyRef:
579
                  key: ceph-username
580
                  name: rook-ceph-mon
581
            - name: ROOK_CEPH_SECRET
582
              valueFrom:
583
                secretKeyRef:
584
                  key: ceph-secret
585
                  name: rook-ceph-mon
586
            - name: ROOK_CONFIG_DIR
587
              value: /var/lib/rook
588
            - name: ROOK_CEPH_CONFIG_OVERRIDE
589
              value: /etc/rook/config/override.conf
590
            - name: ROOK_FSID
591
              valueFrom:
592
                secretKeyRef:
593
                  key: fsid
594
                  name: rook-ceph-mon
595
            - name: ROOK_LOG_LEVEL
596
              value: DEBUG
597
          volumeMounts:
598
            - mountPath: /etc/ceph
599
              name: ceph-conf-emptydir
600
            - mountPath: /var/lib/rook
601
              name: rook-config
602
      volumes:
603
        - emptyDir: {}
604
          name: ceph-conf-emptydir
605
        - emptyDir: {}
606
          name: rook-config
607
      restartPolicy: Never
608
609
610 99 Nico Schottelius
</pre>
611
612
Deleting the deployment:
613
614
<pre>
615
[18:05] bridge:~% kubectl -n rook-ceph delete deployment rook-ceph-osd-6
616
deployment.apps "rook-ceph-osd-6" deleted
617 98 Nico Schottelius
</pre>
618
619 76 Nico Schottelius
h2. Harbor
620
621
* We user "Harbor":https://goharbor.io/ for caching and as an image registry. Internal app reference: apps/prod/harbor.
622
* The admin password is in the password store, auto generated per cluster
623
* At the moment harbor only authenticates against the internal ldap tree
624
625
h3. LDAP configuration
626
627
* The url needs to be ldaps://...
628
* uid = uid
629
* rest standard
630 75 Nico Schottelius
631 89 Nico Schottelius
h2. Monitoring / Prometheus
632
633 90 Nico Schottelius
* Via "kube-prometheus":https://github.com/prometheus-operator/kube-prometheus/
634 89 Nico Schottelius
635 91 Nico Schottelius
Access via ...
636
637
* http://prometheus-k8s.monitoring.svc:9090
638
* http://grafana.monitoring.svc:3000
639
* http://alertmanager.monitoring.svc:9093
640
641
642 100 Nico Schottelius
h3. Prometheus Options
643
644
* "helm/kube-prometheus-stack":https://github.com/prometheus-community/helm-charts/tree/main/charts/kube-prometheus-stack
645
** Includes dashboards and co.
646
* "manifest based kube-prometheus":https://github.com/prometheus-operator/kube-prometheus
647
** Includes dashboards and co.
648
* "Prometheus Operator (mainly CRD manifest":https://github.com/prometheus-operator/prometheus-operator
649
650 91 Nico Schottelius
651 82 Nico Schottelius
h2. Nextcloud
652
653 85 Nico Schottelius
h3. How to get the nextcloud credentials 
654 84 Nico Schottelius
655
* The initial username is set to "nextcloud"
656
* The password is autogenerated and saved in a kubernetes secret
657
658
<pre>
659 85 Nico Schottelius
kubectl get secret RELEASENAME-nextcloud -o jsonpath="{.data.PASSWORD}" | base64 -d; echo "" 
660 84 Nico Schottelius
</pre>
661
662 83 Nico Schottelius
h3. How to fix "Access through untrusted domain"
663
664 82 Nico Schottelius
* Nextcloud stores the initial domain configuration
665 1 Nico Schottelius
* If the FQDN is changed, it will show the error message "Access through untrusted domain"
666 82 Nico Schottelius
* To fix, edit /var/www/html/config/config.php and correct the domain
667 83 Nico Schottelius
* Then delete the pods
668 82 Nico Schottelius
669 1 Nico Schottelius
h2. Infrastructure versions
670 35 Nico Schottelius
671 57 Nico Schottelius
h3. ungleich kubernetes infrastructure v5 (2021-10)
672 1 Nico Schottelius
673 57 Nico Schottelius
Clusters are configured / setup in this order:
674
675
* Bootstrap via kubeadm
676 59 Nico Schottelius
* "Networking via calico + BGP (non ECMP) using helm":https://docs.projectcalico.org/getting-started/kubernetes/helm
677
* "ArgoCD for CD":https://argo-cd.readthedocs.io/en/stable/
678
** "rook for storage via argocd":https://rook.io/
679 58 Nico Schottelius
** haproxy for in IPv6-cluster-IPv4-to-IPv6 proxy via argocd
680
** "kubernetes-secret-generator for in cluster secrets":https://github.com/mittwald/kubernetes-secret-generator
681
** "ungleich-certbot managing certs and nginx":https://hub.docker.com/repository/docker/ungleich/ungleich-certbot
682
683 57 Nico Schottelius
684
h3. ungleich kubernetes infrastructure v4 (2021-09)
685
686 54 Nico Schottelius
* rook is configured via manifests instead of using the rook-ceph-cluster helm chart
687 1 Nico Schottelius
* The rook operator is still being installed via helm
688 35 Nico Schottelius
689 57 Nico Schottelius
h3. ungleich kubernetes infrastructure v3 (2021-07)
690 1 Nico Schottelius
691 10 Nico Schottelius
* rook is now installed via helm via argocd instead of directly via manifests
692 28 Nico Schottelius
693 57 Nico Schottelius
h3. ungleich kubernetes infrastructure v2 (2021-05)
694 28 Nico Schottelius
695
* Replaced fluxv2 from ungleich k8s v1 with argocd
696 1 Nico Schottelius
** argocd can apply helm templates directly without needing to go through Chart releases
697 28 Nico Schottelius
* We are also using argoflow for build flows
698
* Planned to add "kaniko":https://github.com/GoogleContainerTools/kaniko for image building
699
700 57 Nico Schottelius
h3. ungleich kubernetes infrastructure v1 (2021-01)
701 28 Nico Schottelius
702
We are using the following components:
703
704
* "Calico as a CNI":https://www.projectcalico.org/ with BGP, IPv6 only, no encapsulation
705
** Needed for basic networking
706
* "kubernetes-secret-generator":https://github.com/mittwald/kubernetes-secret-generator for creating secrets
707
** Needed so that secrets are not stored in the git repository, but only in the cluster
708
* "ungleich-certbot":https://hub.docker.com/repository/docker/ungleich/ungleich-certbot
709
** Needed to get letsencrypt certificates for services
710
* "rook with ceph rbd + cephfs":https://rook.io/ for storage
711
** rbd for almost everything, *ReadWriteOnce*
712
** cephfs for smaller things, multi access *ReadWriteMany*
713
** Needed for providing persistent storage
714
* "flux v2":https://fluxcd.io/
715
** Needed to manage resources automatically