Kubernetes इंटिग्रेशन से जुड़ी ज़रूरी शर्तें

यहां Apigee Edge से जुड़े दस्तावेज़ देखे जा रहे हैं.
Apigee X से जुड़े दस्तावेज़ पर जाएं. info

इस विषय में, Edge Microgateway को Kubernetes क्लस्टर में सेवा के तौर पर इंस्टॉल करने से पहले पूरे किए जाने वाले चरणों के बारे में बताया गया है.

इस विषय में, इन विषयों के बारे में बताया गया है:

  • आपके Kubernetes क्लस्टर के लिए ज़रूरी शर्तें.
  • Edge Microgateway को इंस्टॉल और कॉन्फ़िगर करने का तरीका.
  • Edge Microgateway के बुनियादी कॉन्फ़िगरेशन को अपने Kubernetes क्लस्टर में इंस्टॉल करने का तरीका.

आपके Kubernetes क्लस्टर के लिए ज़रूरी शर्तें

आपके Kubernetes क्लस्टर के लिए ये ज़रूरी शर्तें हैं:

  • Kubernetes का वर्शन 1.9 या इसके बाद का वर्शन.
  • Kubernetes CLI kubectl का वर्शन 1.9 या इसके बाद का वर्शन.
  • ऐसा क्लस्टर जिसमें कम से कम तीन नोड हों और हर नोड में दो vCPU हों.

उदाहरण: Google Kubernetes Engine (GKE) पर Kubernetes क्लस्टर बनाना

Kubernetes को मैनेज करने के लिए मशीन सेट अप करना

Kubernetes को मैनेज करने के लिए मशीन, आपकी लोकल मशीन होती है. इसका इस्तेमाल, Kubernetes क्लस्टर के लिए कमांड चलाने के लिए किया जाता है. आम तौर पर, यह एक डेस्कटॉप मशीन होती है, जिसके पास आपके Kubernetes वीएम का ऐक्सेस होता है.

आपको Kubernetes को मैनेज करने के लिए मशीन पर, ये यूटिलिटी इंस्टॉल करनी होंगी:

  • kubectl कमांड लाइन इंटरफ़ेस का वर्शन 1.9 या इसके बाद का वर्शन इंस्टॉल करें.

  • (सिर्फ़ GKE के लिए) अगर GKE पर Kubernetes चल रहा है, तो gcloud इंस्टॉल करें.

GKE पर Kubernetes क्लस्टर बनाना

  1. Google Cloud Platform (GCP) पर, Google Kubernetes Engine (GKE) डैशबोर्ड में लॉग इन करें.
  2. क्लस्टर बनाएं पर क्लिक करें.
  3. स्टैंडर्ड क्लस्टर चुनें.
  4. अपने क्लस्टर के लिए कोई नाम डालें.
  5. कोई ज़ोन चुनें.
  6. Cluster Version 1.9.7-gke-* चुनें. उदाहरण के लिए, 1.9.7-gke.6.
  7. तीन नोड का साइज़ चुनें.
  8. 7.5 जीबी मेमोरी के साथ दो vCPU चुनें.

  9. बनाएं पर क्लिक करें.

    यहां दिए गए स्क्रीनशॉट में, GKE डैशबोर्ड को पिछले चरणों में बताए गए तरीके से भरा गया है:

    GKE डैशबोर्ड

अपने क्लस्टर के क्रेडेंशियल पाना

  1. अपना GKE प्रोजेक्ट का नाम सेट करें:

    gcloud config set project projectName

  2. अपना GKE प्रोजेक्ट का ज़ोन सेट करें:

    gcloud config set compute/zone zoneName

  3. अपने gcloud कंटेनर के क्रेडेंशियल पाएं:

    gcloud container clusters get-credentials cluster-name --zone zone --project project-name

    कहां:

    • cluster-name , आपके बनाए गए Kubernetes क्लस्टर का नाम है.
    • zone वह ज़ोन है जहां आपका क्लस्टर मौजूद है.
    • project-name , आपके GCP प्रोजेक्ट का नाम है.

    उदाहरण के लिए:

    gcloud container clusters get-credentials edgemicrogateway-cluster --zone us-central1-a --project edgemicro-project

  4. यहां दिखाया गया कमांड ठीक वैसे ही चलाएं. इस कमांड से, मौजूदा उपयोगकर्ता को क्लस्टर के एडमिन की अनुमतियां मिलती हैं. Edge Microgateway सेवा के लिए ज़रूरी RBAC नियम बनाने के लिए, एडमिन की अनुमतियों की ज़रूरत होती है:

    kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)

Kubernetes के लिए Edge Microgateway इंस्टॉल करना

  1. Kubernetes के लिए Edge Microgateway डाउनलोड करें. अगर MacOS या Linux मशीन का इस्तेमाल किया जा रहा है, तो वर्शन का नाम डालकर, नया वर्शन या कोई खास वर्शन डाउनलोड किया जा सकता है.

    नया वर्शन पाने के लिए:

    curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -

    वर्शन नंबर डालकर, कोई खास वर्शन पाने के लिए. ध्यान दें कि वर्शन नंबर से पहले "v" अक्षर होना चाहिए. उदाहरण के लिए: v3.0.2

    curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s  version

    उदाहरण के लिए:

    curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s v3.0.2

  2. डायरेक्ट्री को इंस्टॉल डायरेक्ट्री microgateway_Version_OS_ARCH में बदलें. उदाहरण के लिए:

    cd microgateway_2.5.26_Darwin_x86_64

  3. इंस्टॉल डायरेक्ट्री की जांच करें:

    • /install/kubernetes - Kubernetes पर डिप्लॉयमेंट के लिए, कॉन्फ़िगरेशन .yaml फ़ाइलें.
    • /samples - इंस्टॉलेशन की जांच के लिए, सैंपल ऐप्लिकेशन.
    • /bin - edgemicroctl एक्ज़ीक्यूटेबल. edgemicroctl कमांड, Edge Microgateway को Kubernetes में इंजेक्ट करता है

  4. edgemicroctl क्लाइंट को अपने PATH में जोड़ें. उदाहरण के लिए, MacOS या Linux सिस्टम पर यह कमांड चलाएं:

    export PATH=$PWD/bin:$PATH

  5. Kubernetes क्लस्टर पर, Edge Microgateway का बुनियादी सेटअप लागू करें. इस कमांड से, edgemicro-system नेमस्पेस और क्लस्टर की भूमिकाएं बनती हैं.

    kubectl apply -f install/kubernetes/edgemicro.yaml

  6. क्लस्टर में NGINX Ingress कंट्रोलर इंस्टॉल करें. पक्का करें कि कोई दूसरा Nginix कंट्रोलर न चल रहा हो. kubectl get pods चलाकर, इसकी पुष्टि की जा सकती है.

    kubectl apply -f install/kubernetes/edgemicro-nginx-gke.yaml

इंस्टॉलेशन की पुष्टि करना

  1. यह देखने के लिए कि इनग्रेस कंट्रोलर शुरू हुआ है या नहीं, यह कमांड चलाएं:

    kubectl get pods --all-namespaces -l app=edgemicro-ingress --watch

    यहां दिए गए सैंपल आउटपुट से पता चलता है कि प्रोसेस शुरू होने में एक या दो मिनट लगते हैं. STATUS बदलकर Running होने से पहले, कई बार गड़बड़ी और रीस्टार्ट साइकल दिखना आम बात है.

    NAMESPACE          NAME                                            READY     STATUS             RESTARTS   AGE
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   1          33s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Error              2          33s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   2          40s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Running            3          1m
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running            3          1m

  2. इनग्रेस के चालू होने के बाद, Ctrl+C टाइप करके ऊपर दिए गए कमांड को रद्द किया जा सकता है.

  3. यह देखने के लिए कि Kubernetes की सेवाएं डिप्लॉय की गई हैं या नहीं, यह कमांड चलाएं. आपको यहां दिए गए उदाहरण के आउटपुट जैसा आउटपुट दिखेगा:

    kubectl get svc -n edgemicro-system

    आउटपुट का उदाहरण:

    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP    PORT(S)                     AGE
default-http-backend        ClusterIP      10.19.255.106  <none>         80/TCP                       2h
edgemicro-ingress           LoadBalancer   10.19.247.156  35.224.24.13   80:30176/TCP,443:32325/TCP   2h

  4. पुष्टि करें कि सभी पॉड चल रहे हैं:

    kubectl get pods -n edgemicro-system

    आउटपुट का उदाहरण:

    NAME                                            READY     STATUS    RESTARTS   AGE
default-http-backend-55c6c69b88-2lvtw           1/1       Running   0          4m
edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running   3          4m

Edge Microgateway इंस्टॉल करना

  1. आपके पास Edge Microgateway का वर्शन 2.5.26 या इसके बाद का वर्शन इंस्टॉल होना चाहिए. यह देखने के लिए, यह डालें:

    edgemicro --version

  2. अगर आपके पास Edge Microgateway का वर्शन 2.5.26 या इसके बाद का वर्शन इंस्टॉल नहीं है, तो इंस्टॉल स्क्रिप्ट चलाएं:

    npm install edgemicro -g

  3. अगर आपने Edge Microgateway को पहली बार इंस्टॉल किया है या उसे अपग्रेड किया है, तो यह कमांड चलाएं:

    edgemicro init

    ज़्यादा मदद पाने के लिए, Edge Microgateway इंस्टॉल करना लेख देखें.

अगला चरण

अब Edge Microgateway को Kubernetes पर डिप्लॉय किया जा सकता है.