Private Cloud के लिए वर्चुअल होस्ट कॉन्फ़िगर करना

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

कंपनी की इमारत में इंस्टॉल किए जाने पर, आपको वर्चुअल होस्ट पर पूरा कंट्रोल मिलता है. आपके पास TLS का इस्तेमाल करके, किसी भी संगठन के लिए, किसी भी माहौल में वर्चुअल होस्ट बनाने का विकल्प होता है.

इस दस्तावेज़ में एक आसान वर्चुअल होस्ट बनाने का तरीका बताया गया है. इसका मतलब है कि यह TLS के साथ काम नहीं करता. ज़्यादा उदाहरणों के साथ-साथ TLS के साथ काम करने वाले वर्चुअल होस्ट बनाने के उदाहरण देखने के लिए, प्राइवेट क्लाउड के लिए, एपीआई के लिए TLS के ऐक्सेस को कॉन्फ़िगर करना देखें.

ज़्यादा जानें:

होस्ट के उपनाम के बारे में जानकारी

वर्चुअल होस्ट बनाते समय, आपको वर्चुअल होस्ट का उपनाम बताना होगा. आम तौर पर, यह वर्चुअल होस्ट का डीएनएस नाम होता है.

Edge राऊटर, अनुरोध को मैनेज करने वाले एपीआई प्रॉक्सी को तय करने के लिए, इनकमिंग अनुरोध के Host हेडर की तुलना उपलब्ध होस्ट के उपनामों की सूची से करता है. वर्चुअल होस्ट से अनुरोध करते समय, या तो ऐसा डोमेन नेम बताएं जो होस्ट के उपनाम से मेल खाता हो या फिर राऊटर का आईपी पता और होस्ट उपनाम वाला Host हेडर बताएं.

उदाहरण के लिए, अगर आपने पोर्ट 9001 पर myapis.apigee.net के होस्ट उपनाम के साथ वर्चुअल होस्ट बनाया है, तो उस वर्चुअल होस्ट की मदद से, एपीआई को किया गया cURL अनुरोध, इनमें से किसी एक फ़ॉर्म का इस्तेमाल कर सकता है:

  • अगर आपके पास myapis.apigee.net की डीएनएस एंट्री है, तो:

    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • अगर आपके पास myapis.apigee.net की डीएनएस एंट्री नहीं है, तो:

    curl http://routerIP:9001/proxy-base-path/resource-path -H 'host:myapis.apigee.net'

    इस फ़ॉर्म में, राऊटर का आईपी पता बताया जाता है और Host हेडर में होस्ट का उपनाम पास किया जाता है.

    curl http://routerIP:9001/proxy-base-path/resource-path

अगर आपके पास वर्चुअल होस्ट के लिए डीएनएस एंट्री नहीं है, तो विकल्प

अगर आपके पास डीएनएस एंट्री नहीं है, तो एक विकल्प यह है कि होस्ट के उपनाम को राऊटर के आईपी पते और वर्चुअल होस्ट के पोर्ट के आईपी पते पर सेट करें. जैसे: routerIP:port. उदाहरण के लिए:

192.168.1.31:9001

जब नीचे दिए गए फ़ॉर्म में curl निर्देश दिया जाता है:

curl http://routerIP:9001/proxy-base-path/resource-path

इस विकल्प को प्राथमिकता दी जाती है, क्योंकि यह Edge यूआई के साथ अच्छी तरह से काम करता है.

अगर आपके पास एक से ज़्यादा राऊटर हैं, तो हर राऊटर के लिए एक होस्ट उपनाम जोड़ें. साथ ही, हर राऊटर का आईपी पता और वर्चुअल होस्ट के पोर्ट की जानकारी दें.

इसके अलावा, होस्ट के उपनाम को किसी वैल्यू पर सेट किया जा सकता है, जैसे कि temp.hostalias.com. इसके बाद, आपको हर अनुरोध पर Host हेडर भेजना होगा:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

या, अपनी /etc/hosts फ़ाइल में होस्ट का उपनाम जोड़ें. उदाहरण के लिए, इस लाइन को /etc/hosts में जोड़ें:

192.168.1.31 temp.hostalias.com

इसके बाद, वैसे ही अनुरोध किया जा सकता है जैसे कि आपके पास डीएनएस एंट्री हो:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path

निजी क्लाउड 4.16.01 और इसके बाद के वर्शन के लिए, Edge पर वर्चुअल होस्ट पोर्ट के बारे में जानकारी

वर्चुअल होस्ट बनाते समय, आपको राऊटर का पोर्ट तय करना होता है, जिसका इस्तेमाल वर्चुअल होस्ट करता है. उदाहरण के लिए, पोर्ट 9001.

Apigee for Private Cloud के 4.16.01 और इसके बाद के वर्शन के लिए, राऊटर डिफ़ॉल्ट रूप से, उपयोगकर्ता "apigee" के तौर पर चलता है. इसके पास, खास अधिकार वाले पोर्ट का ऐक्सेस नहीं होता है. आम तौर पर, राऊटर 1024 और इससे पहले के वर्शन पर काम करता है. अगर आपको ऐसा वर्चुअल होस्ट बनाना है जो राऊटर को सुरक्षित पोर्ट से बाइंड करता है, तो आपको उन पोर्ट के ऐक्सेस वाले उपयोगकर्ता के तौर पर चलाने के लिए, राऊटर को कॉन्फ़िगर करना होगा. ज़्यादा जानकारी के लिए वर्चुअल होस्ट सेट अप करना देखें.

वर्चुअल होस्ट बनाना

इस सेक्शन में, Apigee Edge for Private Cloud के लिए वर्चुअल होस्ट बनाने का तरीका बताया गया है. ध्यान दें कि नया वर्चुअल होस्ट बनाने के लिए, यह ज़रूरी है कि आप संगठन के एडमिन हों.

आपके पास एपीआई या Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, प्राइवेट क्लाउड के लिए Apigee Edge के लिए वर्चुअल होस्ट बनाने का विकल्प होता है. इन सेक्शन में इनकी जानकारी दी गई है.

ब्राउज़र का इस्तेमाल करके वर्चुअल होस्ट बनाना

यह सेक्शन बताता है कि किसी ब्राउज़र (सिर्फ़ Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके) वर्चुअल होस्ट कैसे बनाया जाए.

Edge के यूज़र इंटरफ़ेस (यूआई) में नया वर्चुअल होस्ट बनाने के लिए:

  1. Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में लॉग इन करें.
  2. एडमिन > वर्चुअल होस्ट चुनें.
  3. ड्रॉप-डाउन सूची से एनवायरमेंट चुनें.

    Edge उस एनवायरमेंट के लिए वर्चुअल होस्ट की सूची दिखाता है.

  4. नया वर्चुअल होस्ट बनाने के लिए, + वर्चुअल होस्ट को चुनें.

    Edge में वर्चुअल होस्ट बनाएं फ़ॉर्म दिखता है.

    किसी मौजूदा वर्चुअल होस्ट में बदलाव करने के लिए उसके नाम पर भी क्लिक किया जा सकता है.

  5. अपना नया वर्चुअल होस्ट तय करें. ध्यान दें कि बेस यूआरएल फ़ील्ड में प्रोटोकॉल शामिल होना चाहिए. जैसे, फ़ील्ड की वैल्यू से पहले "http://" या "https://" लिखें.

    इसके अलावा, इन बातों पर भी ध्यान दें:

    • जितने चाहें उतने वर्चुअल होस्ट बनाए जा सकते हैं
    • TLS का इस्तेमाल करना ज़रूरी नहीं है. इसका वर्शन 1.0, 1.1 या 1.2 हो सकता है
    • वर्चुअल होस्ट का पोर्ट कॉन्फ़िगर किया जा सकता है
  6. अपने नए वर्चुअल होस्ट को सेव करने के लिए, बनाएं बटन पर क्लिक करें.

एपीआई की मदद से वर्चुअल होस्ट बनाना

एपीआई की मदद से वर्चुअल होस्ट बनाने के लिए, ऐसा एक्सएमएल ऑब्जेक्ट बनाएं जो वर्चुअल होस्ट के बारे में बताता हो. उदाहरण के लिए, नीचे दिया गया एक्सएमएल ऑब्जेक्ट एक वर्चुअल होस्ट के बारे में बताता है, जो एचटीटीपी प्रोटोकॉल का इस्तेमाल करता है:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:port</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

ध्यान दें कि वर्चुअल होस्ट में name प्रॉपर्टी शामिल है. वर्चुअल होस्ट का इस्तेमाल करने के लिए, एपीआई प्रॉक्सी को कॉन्फ़िगर करने के लिए name प्रॉपर्टी की वैल्यू का इस्तेमाल किया जाता है.

इसके बाद, इस वर्चुअल होस्ट से एपीआई प्रॉक्सी को ऐक्सेस करने के लिए, अनुरोध किया जा सकता है:

http://routerIP:port/proxy-base-path/resource-path
https://routerIP:port/proxy-base-path/resource-path

जगह:

  • http या https: अगर वर्चुअल होस्ट को TLS पर काम करने के लिए कॉन्फ़िगर किया गया है, तो एचटीटीपीएस का इस्तेमाल करें. अगर वर्चुअल होस्ट, TLS पर काम नहीं करता है, तो एचटीटीपी का इस्तेमाल करें.
  • routerIP:port, वर्चुअल होस्ट का आईपी पता और पोर्ट नंबर है.
  • एपीआई प्रॉक्सी बनाते समय, proxy-base-path और resource-path तय किए जाते हैं.

आम तौर पर, आईपी पते और पोर्ट नंबर वाले खरीदारों के लिए, आपके एपीआई पब्लिश नहीं किए जाते. इसके बजाय, आप राऊटर और पोर्ट के लिए डीएनएस एंट्री तय करें. उदाहरण के लिए:

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

अगर आपने डीएनएस एंट्री तय की है, तो वर्चुअल होस्ट के लिए ऐसा होस्ट उपनाम बनाना होगा जो डीएनएस एंट्री के डोमेन नेम से मेल खाता हो. होस्ट का उपनाम, उस स्ट्रिंग से मेल खाना चाहिए जिसे क्लाइंट, Host हेडर में पास करता है. ऊपर दिए गए उदाहरण से, आप api.myCompany.com का एक होस्ट उपनाम तय करेंगे.

<VirtualHost name="myVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9005</Port>
</VirtualHost>

एचटीटीपी प्रोटोकॉल का इस्तेमाल करने वाला वर्चुअल होस्ट बनाने के लिए, यह तरीका अपनाएं:

  1. वर्चुअल होस्ट बनाएं एपीआई का इस्तेमाल करके, वर्चुअल होस्ट बनाएं. इसमें ms-IP, मैनेजमेंट सर्वर नोड का आईपी पता या डोमेन नेम है:
    $ curl -X POST -H "Content-Type:application/xml" \
    http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
    -d '<VirtualHost name="newVHost">
        <HostAliases>
          <HostAlias>api.myCompany.com</HostAlias>
        </HostAliases>
        <Interfaces/>
        <Port>9005</Port>
      </VirtualHost>' \
    -u sysAdminEmail:password
    
  2. उस वर्चुअल होस्ट के लिए डीएनएस रिकॉर्ड बनाएं जो होस्ट के उपनाम से मेल खाता हो.
  3. अगर आपके पास कोई मौजूदा एपीआई प्रॉक्सी है, तो प्रॉक्सी एंडपॉइंट में <HTTPConnection> एलिमेंट में वर्चुअल होस्ट जोड़ें. वर्चुअल होस्ट, सभी नई एपीआई प्रॉक्सी में अपने-आप जुड़ जाता है. वर्चुअल होस्ट का इस्तेमाल करने के लिए, एपीआई प्रॉक्सी को कॉन्फ़िगर करना देखें.

वर्चुअल होस्ट में बदलाव करना

वर्चुअल होस्ट में बदलाव करने के लिए, ये काम करें:

  1. वर्चुअल होस्ट अपडेट करें एपीआई का इस्तेमाल करके, वर्चुअल होस्ट को अपडेट करें. इसमें <ms-IP>, मैनेजमेंट सर्वर नोड का आईपी पता या डोमेन नेम है. आपको अनुरोध के मुख्य हिस्से में वर्चुअल होस्ट की पूरी जानकारी देनी होगी, न कि सिर्फ़ वे एलिमेंट जिन्हें आपको बदलना है. इस उदाहरण में, वर्चुअल होस्ट के पोर्ट नंबर को 9008 से बदलकर 9009 किया गया है:

    curl -X PUT -H "Content-Type:application/xml" \
      http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
      -d '<VirtualHost name="newVHost">
        <HostAliases>
          <HostAlias>api.myCompany.com</HostAlias>
        </HostAliases>
        <Interfaces/>
        <Port>9009</Port>
      </VirtualHost>' \
      -u email:password
  2. Edge for Private Cloud के 4.16.01 और 4.16.05 वर्शन के लिए, किसी मौजूदा वर्चुअल होस्ट में बदलाव करने पर, पोर्ट नंबर बदले बिना TLS को चालू या बंद कर देने पर:
    1. राऊटर बंद करने के लिए:

      /opt/apigee/apigee-service/bin/apigee-service edge-router stop
    2. /opt/nginx/conf.d में मौजूद किसी भी फ़ाइल को मिटाएं:

      rm -f /opt/nginx/conf.d/*
    3. राऊटर चालू करें:

      /opt/apigee/apigee-service/bin/apigee-service edge-router start
    4. सभी राऊटर के लिए यह तरीका दोहराएं.