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

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

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

इस विषय में इन विषयों पर चर्चा की गई है:

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

अपने Cubernetes क्लस्टर के लिए ज़रूरी शर्तें

आपके Cubernetes क्लस्टर को इनकी ज़रूरत है:

• Cubernetes 1.9 या इसके बाद का वर्शन.
• Cubernetes सीएलआई kubectl v1.9 या इसके बाद का वर्शन.
• कम से कम तीन नोड वाला ऐसा क्लस्टर जिसमें हर नोड में दो vCPU हों.

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

अपनी Cubernetes एडमिन मशीन सेट अप करें

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

आपको Cubernetes एडमिन मशीन पर ये सुविधाएं इंस्टॉल करनी होंगी:

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

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

GKE (जीकेई) पर Cubernetes क्लस्टर बनाएं

1. Google Cloud Platform (GCP) पर, Google Cubernetes 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 (जीकेई) डैशबोर्ड को दिखाया गया है, जैसा कि पिछले चरणों में बताया गया था:

   

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

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, आपके बनाए गए Cubernetes क्लस्टर का नाम है.
   • zone वह ज़ोन है जहां आपका क्लस्टर मौजूद है.
   • project-name, आपके GCP प्रोजेक्ट का नाम है.

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

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

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

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

Cubernetes के लिए Edge माइक्रोगेटवे इंस्टॉल करें

1. Cubernetes के लिए Edge माइक्रोगेटवे डाउनलोड करें. अगर 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 कमांड ने एज माइक्रोगेटवे को कुबेरनेट्स में इंजेक्ट किया

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

   export PATH=$PWD/bin:$PATH

5. Cubernetes क्लस्टर में, बेस Edge माइक्रोगेटवे सेटअप को लागू करें. यह निर्देश, edgemicro-system नेमस्पेस और क्लस्टर रोल बनाता है.

   kubectl apply -f install/kubernetes/edgemicro.yaml

6. क्लस्टर में NGINX इन्ग्रेस कंट्रोलर इंस्टॉल करें. पक्का करें कि कोई दूसरा Ngnix कंट्रोलर न चल रहा हो. आप 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. इस कमांड को चलाकर देखें कि Cubernetes सेवाएं डिप्लॉय की गई हैं या नहीं. आपको यहां उदाहरण के तौर पर दिखाए गए आउटपुट के जैसा आउटपुट देखना चाहिए:

   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 माइक्रोगेटवे इंस्टॉल करें

1. आपके डिवाइस में Edge माइक्रोगेटवे 2.5.26 या उसके बाद का कोई वर्शन इंस्टॉल होना चाहिए. नीचे दी गई जानकारी से जांच की जा सकती है:

   edgemicro --version

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

   npm install edgemicro -g

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

   edgemicro init

   अगर आपको और मदद चाहिए, तो Edge Microgateway इंस्टॉल करना देखें.

अगला कदम

अब आप Cubernetes पर एज माइक्रोगेटवे को डिप्लॉय करने के लिए तैयार हैं.

• एज माइक्रोगेटवे को सेवा के तौर पर डिप्लॉय करें देखें.