Integracija Kubernetes Dashboards i GitLab korisnika

Integracija Kubernetes Dashboards i GitLab korisnika

Kubernetes Dashboard — jednostavan alat za pristup informacijama o aktivnom klasteru i minimalno upravljanje njime. Počnete ga više ceniti kada su vam ove mogućnosti potrebne ne samo administratorima/DevOps inženjerima, već i onima koji manje koriste konzolu i/ili ne žele da se bave svim nijansama interakcije sa kubectl-om i drugim alatima. Tako je bilo i kod nas: programerima je bio potreban brz pristup web interfejsu Kubernetes-a, a pošto koristimo GitLab, rešenje se samo nametnulo.

Zašto ovo?

Samoprogrameri mogu biti zainteresovani za alat kao što je K8s Dashboard za zadatke debug-ovanja. Ponekad žele da pregledaju logove i resurse, a ponekad i da unište pod-ove, skaliraju Deployments/StatefulSets i čak uđu u konzolu kontejnera (dešavaju se takvi zahtevi, za čije rešavanje, međutim, postoji drugi put — na primer, putem kubectl-debug).

Osim toga, postoji i psihološki moment za rukovodioce, kada žele da pogledaju na klaster — da vide da je "sve zeleno", i na taj način se umire da "sve radi" (što, naravno, veoma relativno… ali to već izlazi iz okvira ovog članka).

Kao standardni CI sistem imamo se koristi GitLab: koristi ga sav naš razvojni tim. Tako da je bilo logično omogućiti im pristup integracijom Dashboard-a sa GitLab nalozima.

Takođe, napominjem da koristimo NGINX Ingress. Ako radite sa drugim ingress-rešenjima, biće potrebno da sami pronađete analoge anotacija za autorizaciju.

Probamo integraciju

Instalacija Dashboard-a

Pažnja: Ako planirate da ponavljate dolenavedene korake, prvo pročitajte do sledeće podnaslove kako biste izbegli nepotrebne operacije.

Pošto ovu integraciju koristimo u mnogim instalacijama, automatizovali smo njenu instalaciju. Izvori koje će vam biti potrebni su objavljeni u posebnom GitHub repozitorijumu. Njihova osnova su malo modifikovane YAML konfiguracije iz službenog repozitorijuma Dashboard-a, kao i Bash skripta za brzo postavljanje.

Skripta instalira Dashboard u klaster i podešava ga na integraciju sa GitLab-om:

$ ./ctl.sh  
Usage: ctl.sh [OPTION]... --gitlab-url GITLAB_URL --oauth2-id ID --oauth2-secret SECRET --dashboard-url DASHBOARD_URL
Install kubernetes-dashboard to Kubernetes cluster.
Mandatory arguments:
 -i, --install                install into 'kube-system' namespace
 -u, --upgrade                upgrade existing installation, will reuse password and host names
 -d, --delete                 remove everything, including the namespace
     --gitlab-url             set gitlab url with schema (https://gitlab.example.com)
     --oauth2-id              set OAUTH2_PROXY_CLIENT_ID from gitlab
     --oauth2-secret          set OAUTH2_PROXY_CLIENT_SECRET from gitlab
     --dashboard-url          set dashboard url without schema (dashboard.example.com)
Optional arguments:
 -h, --help                   output this message

Međutim, pre nego što ga koristite, potrebno je da odete u GitLab: Administratorska oblast → Aplikacije — i dodate novu aplikaciju za buduću tablu. Nazivamo je "kubernetes dashboard":

Integracija Kubernetes Dashboards i GitLab korisnika

Kao rezultat dodavanja, GitLab će pružiti hešove:

Integracija Kubernetes Dashboards i GitLab korisnika

Oni se koriste kao argumenti za skriptu. Kao rezultat, instalacija izgleda ovako:

$ ./ctl.sh -i --gitlab-url https://gitlab.example.com --oauth2-id 6a52769e… --oauth2-secret 6b79168f… --dashboard-url dashboard.example.com

Nakon toga proverićemo da li je sve pokrenuto:

$ kubectl -n kube-system get pod | egrep '(dash|oauth)'
kubernetes-dashboard-76b55bc9f8-xpncp   1/1       Running   0          14s
oauth2-proxy-5586ccf95c-czp2v           1/1       Running   0          14s

Pre ili kasnije sve će se pokrenuti, međutim odmah autorizacija neće raditi! Problem je u tome što je u korišćenom imidžu (situacija je slična u drugim imidžima) proces hvatanja preusmerenja u callback neispravno implementiran. Ova okolnost dovodi do toga da oauth briše kolačić koji nam sam (oauth) pruža…

Problem se rešava izradom svog imidža oauth sa zakrpom.

Zakrpa za oauth i ponovna instalacija

Za to ćemo koristiti sledeći Dockerfile:

FROM golang:1.9-alpine3.7
WORKDIR /go/src/github.com/bitly/oauth2_proxy

RUN apk --update add make git build-base curl bash ca-certificates wget 
&& update-ca-certificates 
&& curl -sSO https://raw.githubusercontent.com/pote/gpm/v1.4.0/bin/gpm 
&& chmod +x gpm 
&& mv gpm /usr/local/bin
RUN git clone https://github.com/bitly/oauth2_proxy.git . 
&& git checkout bfda078caa55958cc37dcba39e57fc37f6a3c842  
ADD rd.patch .
RUN patch -p1 < rd.patch 
&& ./dist.sh

FROM alpine:3.7
RUN apk --update add curl bash  ca-certificates && update-ca-certificates
COPY --from=0 /go/src/github.com/bitly/oauth2_proxy/dist/ /bin/

EXPOSE 8080 4180
ENTRYPOINT [ "/bin/oauth2_proxy" ]
CMD [ "--upstream=http://0.0.0.0:8080/", "--http-address=0.0.0.0:4180" ]

A ovako izgleda sama zakrpa rd.patch

diff --git a/dist.sh b/dist.sh
index a00318b..92990d4 100755
--- a/dist.sh
+++ b/dist.sh
@@ -14,25 +14,13 @@ goversion=$(go version | awk '{print $3}')
sha256sum=()
 
echo "... pokreće testove"
-.\/test.sh
+#.\/test.sh
 
-za os u windows linux darwin; uradi
-    echo "... gradnja v$version za $os/$arch"
-    EXT=
-    ako [ $os = windows ]; then
-        EXT=".exe"
-    fi
-    BUILD=$(mktemp -d ${TMPDIR:-\/tmp}\/oauth2_proxy.XXXXXX)
-    TARGET="oauth2_proxy-$version.$os-$arch.$goversion"
-    FILENAME="oauth2_proxy-$version.$os-$arch$EXT"
-    GOOS=$os GOARCH=$arch CGO_ENABLED=0 
-        go build -ldflags="-s -w" -o $BUILD\/$TARGET\/$FILENAME || exit 1
-    pushd $BUILD\/$TARGET
-    sha256sum+=("$(shasum -a 256 $FILENAME || exit 1)")
-    cd .. && tar czvf $TARGET.tar.gz $TARGET
-    mv $TARGET.tar.gz $DIR\/dist
-    popd
-done
+os='linux'
+echo "... gradnja v$version za $os/$arch"
+TARGET="oauth2_proxy-$version.$os-$arch.$goversion"
+GOOS=$os GOARCH=$arch CGO_ENABLED=0 
+    go build -ldflags="-s -w" -o .\/dist\/oauth2_proxy || exit 1
  
checksum_file="sha256sum.txt"
cd $DIR\/dists
diff --git a/oauthproxy.go b/oauthproxy.go
index 21e5dfc..df9101a 100644
--- a/oauthproxy.go
+++ b/oauthproxy.go
@@ -381,7 +381,9 @@ func (p *OAuthProxy) SignInPage(rw http.ResponseWriter, req *http.Request, code
       if redirect_url == p.SignInPath {
               redirect_url = "\/"
       }
-
+       ako req.FormValue("rd") != "" {
+               redirect_url = req.FormValue("rd")
+       }
       t := struct {
               ProviderName  string
               SignInMessage string

Sada možemo izgraditi sliku i 'push' je na naš GitLab. Dalje u manifests/kube-dashboard-oauth2-proxy.yaml navest ćemo korišćenje potrebne slike (zamijenite je svojom):

 image: docker.io/colemickens/oauth2_proxy:latest

Ako imate registry zatvoren za autorizaciju — ne zaboravite dodati korišćenje tajne za preuzimanje slika:

      imagePullSecrets:
     - name: gitlab-registry

… i dodajte samu tajnu za registry:

---
apiVersion: v1
data:
 .dockercfg: eyJyZWdpc3RyeS5jb21wYW55LmNvbSI6IHsKICJ1c2VybmFtZSI6ICJvYXV0aDIiLAogInBhc3N3b3JkIjogIlBBU1NXT1JEIiwKICJhdXRoIjogIkFVVEhfVE9LRU4iLAogImVtYWlsIjogIm1haWxAY29tcGFueS5jb20iCn0KfQoK
=
kind: Secret
metadata:
 annotations:
 name: gitlab-registry
 namespace: kube-system
type: kubernetes.io/dockercfg

Pažljiv čitatelj će primijetiti da je dugačka linija iznad — to je base64 konfiguracije:

{"registry.company.com": {
 "username": "oauth2",
 "password": "PASSWORD",
 "auth": "AUTH_TOKEN",
 "email": "mail@company.com"
}
}

To su podaci korisnika u GitLabu, kod kojim će Kubernetes preuzeti sliku iz registryja.

Nakon što je sve završeno, možete obrisati trenutnu (neispravnu) instalaciju Dashboard komandom:

$ .\/ctl.sh -d

… i instalirati sve iznova:

$ ./ctl.sh -i --gitlab-url https://gitlab.example.com --oauth2-id 6a52769e… --oauth2-secret 6b79168f… --dashboard-url dashboard.example.com

Došlo je vreme da se prijavite u Dashboard i pronađete prilično arhaičnu dugmad za autorizaciju:

Integracija Kubernetes Dashboards i GitLab korisnika

Nakon što je pritisnemo, sastaće nas GitLab, nudeći nam da se prijavimo na svojoj poznatoj stranici (naravno, ako već nismo bili tamo prijavljeni):

Integracija Kubernetes Dashboards i GitLab korisnika

Prijavljujemo se sa podacima iz GitLaba — i sve se dogodilo:

Integracija Kubernetes Dashboards i GitLab korisnika

O mogućnostima Dashboard

Ako ste programer koji prethodno nije radio sa Kubernetesom, ili iz nekog razloga niste imali iskustva s Dashboard-om, prikazaću neke njegove mogućnosti.

Prvo, možete pogledati što je "sve zeleno":

Integracija Kubernetes Dashboards i GitLab korisnika

Za pod-ove su dostupni i detaljniji podaci, kao što su varijable okruženja, preuzeta slika, argumenti pokretanja, njihovo stanje:

Integracija Kubernetes Dashboards i GitLab korisnika

Za deployment-e se vide statusi:

Integracija Kubernetes Dashboards i GitLab korisnika

… i druge pojedinosti:

Integracija Kubernetes Dashboards i GitLab korisnika

… a također postoji mogućnost skaliranja deployment-a:

Integracija Kubernetes Dashboards i GitLab korisnika

Rezultat ove operacije:

Integracija Kubernetes Dashboards i GitLab korisnika

Među drugim korisnim mogućnostima, već spomenutim na početku članka, je i pregled logova:

Integracija Kubernetes Dashboards i GitLab korisnika

… i funkcija ulaska u konzolu kontejnera odabranog pod-a:

Integracija Kubernetes Dashboards i GitLab korisnika

Također, na primjer, možete pogledati i limit-e/request-e na čvorovima:

Integracija Kubernetes Dashboards i GitLab korisnika

Naravno, ovo nisu sve mogućnosti panela, ali se nadam da ste stekli opšti uvid.

Nedostaci integracije i Dashboard-a

U opisanom integraciji nema nikakvog razdvajanja pristupa. S njom svi korisnici koji imaju bilo kakav pristup GitLabu imaju pristup Dashboard-u. Pristup u samom Dashboard-u im je jednak, u skladu sa pravima same Dashboard-a, koja određuju se u RBAC-u. Očigledno je da to neće odgovarati svima, ali se za naš slučaj pokazalo kao dovoljno.

Od značajnih nedostataka u samom Dashboard-u, izdvojio bih sledeće:

  • nije moguće ući u konzolu init-kontejnera;
  • nije moguće uređivati Deployments i StatefulSets, iako se to može ispraviti u ClusterRole;
  • kompatibilnost Dashboard-a sa najnovijim verzijama Kubernetes-a i budućnost projekta dovodi u pitanje.

Poslednji problem zaslužuje posebnu pažnju.

Status i alternative Dashboard-u

Tabela kompatibilnosti Dashboard-a sa izdanjima Kubernetes-a, predstavljena u poslednjoj verziji projekta (v1.10.1), ne deluje baš ohrabrujuće:

Integracija Kubernetes Dashboards i GitLab korisnika

I pored toga, postoji (već usvojen u januaru) PR #3476, koji najavljuje podršku za K8s 1.13. Pored toga, među issues projekta možete pronaći mention-e korisnika koji rade sa panelom u K8s 1.14. Na kraju, commit-i u kodnu bazu projekta se ne zaustavljaju. Tako da (barem!) stvarni status projekta nije toliko loš, koliko može izgledati iz zvanične tabele kompatibilnosti.

Na kraju, Dashboard ima alternative. Među njima:

  1. K8Dash — mladi interfejs (prvi komit stvoren u martu ove godine), već nudi dobre mogućnosti, kao što su vizuelno predstavljanje trenutnog statusa klastera i upravljanje njegovim objektima. Pozicionira se kao "interfejs u realnom vremenu", jer automatski ažurira prikazane podatke, ne zahtevajući osvežavanje stranice u pretraživaču.
  2. OpenShift Console — veb interfejs od Red Hat OpenShift, koji, međutim, donosi u vaš klaster i druge radne rezultate projekta, što ne odgovara svima.
  3. Kubernator — zanimljiv projekat, stvoren kao niskonivo v (od Dashboard) interfejs sa mogućnošću pregleda svih objekata klastera. Međutim, izgleda da je razvoj stao.
  4. Polaris — bukvalno u poslednjih nekoliko dana najavljen projekat koji kombinuje funkcije panela (prikazuje trenutno stanje klastera, ali ne upravlja njegovim objektima) i automatske "validacije najboljih praksi" (proverava klaster na ispravnost konfiguracija pokrenutih u njemu Deployments).

Umesto zaključaka

Dashboard — standardni alat za klastere Kubernetes koje održavamo. Njegova integracija sa GitLabom takođe je postala deo naše "podrazumevane instalacije", budući da su mnogi programeri zadovoljni mogućnostima koje imaju sa ovom trajnom.

Alternativna rešenja za Kubernetes Dashboard povremeno se pojavljuju iz Open Source zajednice (i rado ih razmatramo), ali u ovom trenutku ostajemo sa ovim rešenjem.

P.S.

Takođe pročitajte na našem blogu:

Izvor: habr.com

Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere 🔥 Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere | ProHoster