🧘🏾 👩🏽 🎚️ कुबेरनेट्स डैशबोर्ड और गिटलैब इंटीग्रेशन 🚴🏽 🎃 🤞🏼

कुबेरनेट्स डैशबोर्ड एक कामकाजी क्लस्टर के बारे में अप-टू-डेट जानकारी प्राप्त करने और उस पर न्यूनतम नियंत्रण के लिए एक आसान-से-उपयोग उपकरण है। आप इसे तब और अधिक सराहना शुरू करते हैं, जब इन सुविधाओं तक पहुंच की आवश्यकता न केवल प्रशासकों / DevOps इंजीनियरों को होती है, बल्कि उन लोगों द्वारा भी होती है, जो कंसोल के लिए कम उपयोग करते हैं और / या डबटेल और अन्य उपयोगिताओं के साथ बातचीत करने की सभी जटिलताओं से निपटने का इरादा नहीं रखते हैं। तो यह हमारे साथ हुआ: डेवलपर्स कुबरनेट्स वेब इंटरफ़ेस तक त्वरित पहुंच चाहते थे, और चूंकि हम गिटलैब का उपयोग करते हैं, इसलिए समाधान स्वाभाविक रूप से आया था।

यह क्यों है?

प्रत्यक्ष डेवलपर्स डीबगिंग कार्यों के लिए K8s डैशबोर्ड जैसे टूल में रुचि ले सकते हैं। कभी-कभी आप लॉग और संसाधन देखना चाहते हैं, और कभी-कभी पॉड्स को मारते हैं, स्केल डिप्लॉयमेंट / स्टेटफुलसेट्स और यहां तक कि कंटेनर कंसोल में जाते हैं (यहां तक कि अनुरोध भी हैं जिनके लिए एक और तरीका है, उदाहरण के लिए, कुबेटल-डीबग के माध्यम से)।

इसके अलावा, प्रबंधकों के लिए एक मनोवैज्ञानिक क्षण है जब वे क्लस्टर को देखना चाहते हैं - यह देखने के लिए कि "सब कुछ हरा है", और इस तरह शांत हो जाओ कि "सब कुछ काम करता है" (जो, ज़ाहिर है, बहुत सापेक्ष है ... लेकिन यह लेख के दायरे से परे है। )।

हम GitLab का उपयोग एक मानक CI सिस्टम के रूप में करते हैं: सभी डेवलपर इसका उपयोग करते हैं। इसलिए, उन्हें एक्सेस देने के लिए, गीताबलैब में खातों के साथ डैशबोर्ड को एकीकृत करना तर्कसंगत था।

यह भी ध्यान दें कि हम NGINX Ingress का उपयोग कर रहे हैं। यदि आप अन्य प्रवेश समाधानों के साथ काम करते हैं , तो आपको प्राधिकरण के लिए एनोटेशन के एनालॉग्स को स्वतंत्र रूप से खोजने की आवश्यकता होगी।

हम एकीकरण की कोशिश करते हैं

डैशबोर्ड स्थापित करें

ध्यान दें : यदि आप नीचे वर्णित चरणों को दोहराने जा रहे हैं, तो - अनावश्यक संचालन से बचने के लिए - पहले अगले उपशीर्षक के माध्यम से पढ़ें।

चूंकि हम कई इंस्टॉलेशन में इस एकीकरण का उपयोग करते हैं, इसलिए हमने इसकी स्थापना को स्वचालित कर दिया है। इसके लिए जिन स्रोतों की आवश्यकता होती है, वे एक विशेष GitHub रिपॉजिटरी में प्रकाशित होते हैं। वे आधिकारिक डैशबोर्ड रिपॉजिटरी से थोड़ा संशोधित YAML कॉन्फ़िगरेशन और साथ ही त्वरित तैनाती के लिए एक बैश स्क्रिप्ट पर आधारित हैं।

स्क्रिप्ट एक क्लस्टर में डैशबोर्ड स्थापित करती है और इसे GitLab के साथ एकीकृत करने के लिए कॉन्फ़िगर करती है:

$ ./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

हालाँकि, इसका उपयोग करने से पहले, आपको GitLab: Admin area → Applications - पर जाना होगा और भविष्य के पैनल के लिए एक नया एप्लिकेशन जोड़ना होगा। चलो इसे "कुबेरनेट्स डैशबोर्ड" कहते हैं:

इसके अतिरिक्त के परिणामस्वरूप, GitLab हैश प्रदान करेगा:

उनका उपयोग स्क्रिप्ट के तर्क के रूप में किया जाता है। नतीजतन, स्थापना इस प्रकार है:

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

उसके बाद, जांचें कि सब कुछ शुरू हुआ:

 $ 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

जल्दी या बाद में सब कुछ शुरू हो जाएगा, लेकिन प्राधिकरण अभी काम नहीं करेगा ! तथ्य यह है कि उपयोग की गई छवि में (अन्य छवियों में स्थिति समान है), कॉलबैक में पुनर्निर्देशन पकड़ने की प्रक्रिया को गलत तरीके से लागू किया जाता है। यह परिस्थिति इस तथ्य की ओर ले जाती है कि ओउथ कुकी को मिटा देता है, जो स्वयं (ऑउथ) हमें प्रदान करता है ...

पैच के साथ आपकी oauth छवि बनाने से समस्या हल हो गई है।

पैच को ओहाउट और रीइनस्टॉल करें

ऐसा करने के लिए, निम्नलिखित 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 \ && go get -u github.com/golang/dep/cmd/dep \ && 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 fa2771998a98a5bfdfa3c3503757668ac4f1c8ec 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" ]

और यहाँ rd.patch पैच ही है

 diff --git a/Gopkg.lock b/Gopkg.lock index 5a3758a..1294a90 100644 --- a/Gopkg.lock +++ b/Gopkg.lock @@ -131,7 +131,7 @@ version = "v1.0.0" [[projects]] - name = "gopkg.in/fsnotify.v1" + name = "gopkg.in/fsnotify/fsnotify.v1" packages = ["."] revision = "836bfd95fecc0f1511dd66bdbf2b5b61ab8b00b6" version = "v1.2.11" @@ -149,6 +149,6 @@ [solve-meta] analyzer-name = "dep" analyzer-version = 1 - inputs-digest = "b502c41a61115d14d6379be26b0300f65d173bdad852f0170d387ebf2d7ec173" + inputs-digest = "cfdd05348394cd0597edb858bdba5681665358a963356ed248d98f39373c33b5" solver-name = "gps-cdcl" solver-version = 1 diff --git a/Gopkg.toml b/Gopkg.toml index c4005e1..422bd43 100644 --- a/Gopkg.toml +++ b/Gopkg.toml @@ -4,7 +4,7 @@ # [[constraint]] - name = "github.com/18F/hmacauth" + name = "github.com/mbland/hmacauth" version = "~1.0.1" [[constraint]] @@ -36,7 +36,7 @@ name = "google.golang.org/api" [[constraint]] - name = "gopkg.in/fsnotify.v1" + name = "gopkg.in/fsnotify/fsnotify.v1" version = "~1.2.0" [[constraint]] 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 "... running tests" -./test.sh +#./test.sh -for os in windows linux darwin; do - echo "... building v$version for $os/$arch" - EXT= - if [ $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 "... building v$version for $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/dist 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 = "/" } - + if req.FormValue("rd") != "" { + redirect_url = req.FormValue("rd") + } t := struct { ProviderName string SignInMessage string diff --git a/watcher.go b/watcher.go index bedb9f8..4b83946 100644 --- a/watcher.go +++ b/watcher.go @@ -7,8 +7,7 @@ import ( "os" "path/filepath" "time" - - "gopkg.in/fsnotify.v1" + "gopkg.in/fsnotify/fsnotify.v1" ) func WaitForReplacement(filename string, op fsnotify.Op,

अब आप छवि का निर्माण कर सकते हैं और इसे हमारे GitLab में धकेल सकते हैं। अगला, manifests/kube-dashboard-oauth2-proxy.yaml इच्छित छवि का उपयोग निर्दिष्ट करें (इसे अपने आप से बदलें):

  image: docker.io/colemickens/oauth2_proxy:latest

यदि आपके पास प्राधिकरण द्वारा रजिस्ट्री बंद है - चित्र खींचने के लिए एक रहस्य जोड़ना न भूलें:

  imagePullSecrets: - name: gitlab-registry

... और रजिस्ट्री के लिए स्वयं रहस्य जोड़ें:

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

एक चौकस पाठक यह देखेगा कि उपर्युक्त लंबी रेखा विन्यास से बेस 64 है:

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

यह GitLab में उपयोगकर्ता डेटा है, जिस कोड से कुबेरनेट्स रजिस्ट्री से छवि को खींच लेंगे।

सब कुछ हो जाने के बाद, आप करंट (गलत तरीके से काम करने वाला) डैशबोर्ड इंस्टालेशन को हटा सकते हैं

 $ ./ctl.sh -d

... और सब कुछ पुनर्स्थापित करें:

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

यह डैशबोर्ड में जाने और बल्कि आर्कटिक लॉगिन बटन खोजने का समय है:

इस पर क्लिक करने के बाद, GitLab हमसे मिलेंगे, अपने परिचित पृष्ठ पर लॉग इन करने की पेशकश करेंगे (निश्चित रूप से, अगर हम वहां पहले से अधिकृत नहीं थे):

अपने GitLab क्रेडेंशियल के साथ लॉग इन करें - और सब कुछ हुआ:

डैशबोर्ड फीचर्स के बारे में

यदि आप एक डेवलपर हैं जो पहले कुबेरनेट्स के साथ काम नहीं करते थे, या सिर्फ किसी कारण से पहले डैशबोर्ड पर नहीं आया था, तो मैं इसकी कुछ विशेषताओं का वर्णन करूंगा।

सबसे पहले, आप देख सकते हैं कि "सब कुछ हरा है":

पॉड्स पर अधिक विस्तृत डेटा उपलब्ध है, जैसे कि पर्यावरण चर, अपस्फीति छवि, स्टार्टअप तर्क, उनकी स्थिति:

परिनियोजन स्थितियाँ दिखाई देती हैं:

... और अन्य विवरण:

... साथ ही तैनाती को पैमाना करने की क्षमता:

इस ऑपरेशन का परिणाम:

लेख की शुरुआत में पहले से वर्णित अन्य उपयोगी विशेषताओं में लॉग देख रहे हैं:

... और चयनित फली के कंटेनर कंसोल में प्रवेश करने का कार्य:

उदाहरण के लिए, आप नोड्स पर सीमा / अनुरोध भी देख सकते हैं:

बेशक, यह पैनल की सभी विशेषताएं नहीं हैं, लेकिन मुझे उम्मीद है कि सामान्य विचार विकसित हुआ है।

एकीकरण और डैशबोर्ड के नुकसान

वर्णित एकीकरण में कोई अभिगम नियंत्रण नहीं है । इसके साथ, उन सभी उपयोगकर्ताओं को जिनके पास GitLab तक पहुंच है, डैशबोर्ड तक पहुंच प्राप्त करते हैं। डैशबोर्ड के अधिकार के अनुरूप ही डैशबोर्ड तक उनकी पहुंच है, जो आरबीएसी में परिभाषित हैं। जाहिर है, यह हर किसी के लिए उपयुक्त नहीं है, लेकिन हमारे मामले के लिए यह पर्याप्त है।

डैशबोर्ड में स्वयं ध्यान देने योग्य मिनीसों में से, मैं निम्नलिखित बातों पर ध्यान देता हूं:

init कंटेनर के कंसोल में जाना असंभव है;
यह डिप्लॉयमेंट और स्टेटफुलसेट्स को संपादित करना संभव नहीं है, हालांकि यह क्लस्टरस्टर में ठीक करने योग्य है;
कुबेरनेट्स के नवीनतम संस्करणों और प्रोजेक्ट के भविष्य के साथ डैशबोर्ड संगतता सवाल उठाती है।

बाद की समस्या विशेष ध्यान देने योग्य है।

डैशबोर्ड की स्थिति और विकल्प

प्रोजेक्ट के नवीनतम संस्करण ( v1.10.1 ) में प्रस्तुत कुबेरनेट्स रिलीज़ के साथ डैशबोर्ड संगतता तालिका बहुत महत्वपूर्ण नहीं है:

इसके बावजूद, वहाँ (पहले से ही जनवरी में अपनाया गया) PR # 3476 है , जो K8s 1.13 के लिए समर्थन की घोषणा करता है। इसके अलावा, परियोजना के मुद्दों के बीच आप K8s 1.14 में पैनल के साथ काम करने वाले उपयोगकर्ताओं के संदर्भ पा सकते हैं। अंत में, प्रोजेक्ट कोड आधार पर नहीं रुकता है। इसलिए (कम से कम!) परियोजना की वास्तविक स्थिति उतनी बुरी नहीं है जितनी पहली आधिकारिक संगतता तालिका से दिखाई दे सकती है।

अंत में, डैशबोर्ड में विकल्प हैं। उनमें से हैं:

K8Dash एक युवा इंटरफ़ेस है (इस वर्ष का पहला दिनांक मार्च है), पहले से ही अच्छी सुविधाओं की पेशकश कर रहा है, जैसे कि क्लस्टर की वर्तमान स्थिति और इसकी वस्तुओं के प्रबंधन का एक दृश्य प्रतिनिधित्व। यह एक "वास्तविक समय इंटरफ़ेस" के रूप में तैनात है, क्योंकि ब्राउज़र में पेज रिफ्रेश किए बिना स्वचालित रूप से प्रदर्शित डेटा को अपडेट करता है।
OpenShift कंसोल Red Hat OpenShift का एक वेब इंटरफ़ेस है, जो, हालाँकि, आपके क्लस्टर में अन्य प्रोजेक्ट उपलब्धियाँ लाएगा, जो सभी के लिए उपयुक्त नहीं है।
कुबेरनेटर एक दिलचस्प परियोजना है जो क्लस्टर में सभी ऑब्जेक्ट्स को देखने की क्षमता के साथ निचले-स्तर (डैशबोर्ड) इंटरफ़ेस के रूप में बनाई गई है। हालांकि, सब कुछ ऐसा लग रहा है कि इसका विकास रुक गया है।
पोलारिस सिर्फ दूसरे दिन एक परियोजना की घोषणा करता है जो एक पैनल के कार्यों को जोड़ती है (क्लस्टर की वर्तमान स्थिति दिखाता है, लेकिन इसकी वस्तुओं का प्रबंधन नहीं करता है) और स्वचालित "सर्वोत्तम अभ्यास सत्यापन" (इसमें चल रहे डिप्लॉयमेंट के सही कॉन्फ़िगरेशन के लिए क्लस्टर की जांच करता है)।

निष्कर्ष के बजाय

डैशबोर्ड कुबेरनेट समूहों के लिए मानक उपकरण है जिसे हम सेवा देते हैं। GitLab के साथ इसका एकीकरण हमारे "डिफ़ॉल्ट इंस्टॉलेशन" का भी हिस्सा बन गया है, क्योंकि कई डेवलपर्स इस पैनल के साथ मिले अवसरों से खुश हैं।

कुबेरनेट्स डैशबोर्ड में समय-समय पर ओपन सोर्स समुदाय से विकल्प होते हैं (और हम उन पर विचार करके खुश हैं), लेकिन इस स्तर पर हम इस समाधान के साथ बने हुए हैं।

पुनश्च

हमारे ब्लॉग में भी पढ़ें:

युपीडी। हॉक रिपोर्ट के अनुसार, पैच में एक त्रुटि पाई गई (टैब को रिक्त स्थान द्वारा प्रतिस्थापित किया गया था)। लेख में पैच अपडेट किया गया है।

कुबेरनेट्स डैशबोर्ड और गिटलैब इंटीग्रेशन