diff --git a/docs/examples.md b/docs/examples.md new file mode 100644 index 0000000000000000000000000000000000000000..ed374cd275f9f0a17433f0b4b13cc8ebf3e9463f --- /dev/null +++ b/docs/examples.md @@ -0,0 +1,8 @@ +# Példa konfiguráció + +A konfigurációt `kubectl`-el, a namespace kiválasztása után pl. a +`kubectl apply -f deployment.yaml` paranccsal lehet érvényesíteni. + +- [example deployment.yaml](https://git.sch.bme.hu/snippets/33) +- [example service.yaml](https://git.sch.bme.hu/snippets/35) +- [example ingress.yaml](https://git.sch.bme.hu/snippets/34) diff --git a/docs/index.md b/docs/index.md index 57a4eb4f8833d4921c7bb9eb5ff2fca7929f1be4..825644dedbefbdb0c48cbc08f3709531c96bf3d4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,2 +1,34 @@ # Kubernetes a KSZK-ban +A KSZK lehetőséget nyújt alkalmazások üzemeltetésére saját Kubernetes-ében. + +Ha érdeklődsz ez iránt kérlek adjt fel egy [ticketet](https://support.sch.bme.hu/open.php). + +## K8s elérése +Az SCH-ban üzemelő kubernetes API-ját SCHNET-en belülről lehet elérni. +Ezt [VPN](http://intro.kszk.bme.hu/#vpn)-nel vagy +[terminál szerverrel](https://kszk.sch.bme.hu/szolgaltatasaink/centaur-sch/) +lehet áthidalni, amennyiben nem eleve a koliból szeretnéd elérni a k8s-t. + +### kubectl +A kubectl parancssori eszközzel lehet beállításokat eszközölni k8s-ben. +Ezen parancsot futtató felhasználónak szükséges autentikálnia magát a +[kubectl.k8s.sch.bme.hu](https://kubectl.k8s.sch.bme.hu/) oldalon és az ott +található parancsokat kaidnia parancssorában. Ez korlátozott idejű hozzáférést biztosít a felhasználóhoz rendelt namespace-ekhez. + +## Dashboard +A [dashboard.k8s.sch.bme.hu](https://dashboard.k8s.sch.bme.hu/) egy jó +vizuális áttekintést ad a felhasználóhoz tartozó namespace-ek állapotáról. + +## Git.sch +Automatikus deployment-et, CI/CD lehetőséget a legkönnyebben +[git.sch](https://git.sch.bme.hu/)-n lehet beállítani, mert a hozzá tartozó +CI runner (ami a deployment-hez szükséges scripteket futtatja) a kolin belül +üzemel. + +## Példa konfiguráció +Lásd a [példák](examples/) oldalán. + +## Monitoring +Lehetőség van monitoring-ot kérni az üzemeltetett alkalmazásokra. +Ennek megvalósítása Prometheus és Grafana programokkal történik. diff --git a/mkdocs.yml b/mkdocs.yml index b4d3311c67122e01ee85a2389423b4385ab94fe9..9050034db611ad75006fd12ca9f154aa7a4575be 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,4 +1,5 @@ site_name: k8s@kszk nav: - - Home: index.md + - Kezdőlap: index.md + - Példák: examples.md theme: readthedocs