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

Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

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

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

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

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

आपके Kubernetes क्लस्टर के लिए:

  • Kubernetes का 1.9 या इसके बाद का वर्शन.
  • Kubernetes CLI kubectl v1.9 या इसके बाद का वर्शन.
  • कम से कम तीन नोड वाला क्लस्टर, जिसमें हर नोड में दो वर्चुअल सीपीयू हों.

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

Kubernetes एडमिनिस्ट्रेशन मशीन सेट अप करना

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

आपको 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 जीबी मेमोरी वाले दो वर्चुअल सीपीयू चुनें.

  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 सेवा के लिए, आरबीएसी के ज़रूरी नियम बनाने के लिए, एडमिन की अनुमतियां ज़रूरी हैं:

    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. अपने PATH में edgemicroctl क्लाइंट जोड़ें. उदाहरण के लिए, 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. यह देखने के लिए कि Ingress कंट्रोलर शुरू हो गया है या नहीं, यह कमांड चलाएं:

    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. Ingress के चलने के बाद, ऊपर दिए गए निर्देश को रद्द करने के लिए, 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 इंस्टॉल करना लेख पढ़ें.

अगला चरण

अब आपके पास Kubernetes में Edge Microgateway को डिप्लॉय करने का विकल्प है.