Edge को कॉन्फ़िगर करने का तरीका

Edge for Private Cloud v. 4.17.09

इंस्टॉल करने के बाद Edge को कॉन्फ़िगर करने के लिए, .property फ़ाइलों और Edge की सुविधाओं के कॉम्बिनेशन का इस्तेमाल करें. उदाहरण के लिए, Edge यूज़र इंटरफ़ेस (यूआई) पर TLS/एसएसएल को कॉन्फ़िगर करने के लिए, आपको ज़रूरी प्रॉपर्टी सेट करने के लिए .properties फ़ाइलों में बदलाव करना होगा. .properties फ़ाइलों में बदलाव करने के लिए, आपको उस Edge कॉम्पोनेंट को रीस्टार्ट करना होगा जिस पर असर हुआ है.

Apigee, .properties फ़ाइलों में बदलाव करने की तकनीक है. इसमें, कॉन्फ़िगरेशन वाले कोड के तौर पर बदलाव किया जाता है. असल में, कॉन्फ़िगरेशन वाला कोड एक 'की/वैल्यू लुकअप' टूल है जो .properties फ़ाइलों की सेटिंग पर आधारित होता है. कॉन्फ़िगरेशन वाले कोड में, कुंजियों को टोकन कहा जाता है. इसलिए, Edge को कॉन्फ़िगर करने के लिए, आप .property फ़ाइलों में टोकन सेट करते हैं.

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

अगर आपको यह किसी हैरारकी के तौर पर लगता है, तो सेटिंग इस तरह से व्यवस्थित होती है: ग्राहक सेटिंग को इंस्टॉलर टीम या Apigee की किसी भी सेटिंग को बदलने की सबसे ज़्यादा प्राथमिकता दी जाती है:

  1. ग्राहक
  2. इंस्टॉलर
  3. Apigee

.properties फ़ाइलों को इस्तेमाल करने का तरीका

ग्राहक के तौर पर, आपके पास सिर्फ़ /opt/apigee/customer/application डायरेक्ट्री में मौजूद .properties फ़ाइलों में बदलाव करने का विकल्प होता है. उस डायरेक्ट्री में हर कॉम्पोनेंट की अपनी .properties फ़ाइल होती है. उदाहरण के लिए, router.properties और management-server.property.

उदाहरण के लिए, .properties फ़ाइल बनाने के लिए:

  1. किसी भी उपयोगकर्ता के तौर पर, एडिटर में फ़ाइल बनाएं.
  2. फ़ाइल के मालिक को apigee:apigee पर मार्क करें. इसके अलावा, अगर आपने Edge की सेवा इस्तेमाल करने वाले उपयोगकर्ता की जगह, apigee उपयोगकर्ता की जगह पर बदलाव किया है, तो उस फ़ाइल का मालिकाना हक उस उपयोगकर्ता को दें जो Edge सेवा इस्तेमाल कर रहा है.

किसी कॉम्पोनेंट के लिए प्रॉपर्टी सेट करने के लिए, उससे जुड़ी .property फ़ाइल में बदलाव करें और टोकन सेट करें. इसके बाद, कॉम्पोनेंट को रीस्टार्ट करें:

> /opt/apigee/apigee-service/bin/apigee-service component restart

उदाहरण के लिए, router.properties में बदलाव करने के बाद, राऊटर को रीस्टार्ट करें:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Edge को अपग्रेड करने पर, /opt/apigee/customer/application डायरेक्ट्री में .property फ़ाइलें पढ़ी जाती हैं. इसका मतलब है कि कॉम्पोनेंट पर सेट की गई सभी प्रॉपर्टी, अपग्रेड के बाद सेव रहेंगी.

.properties फ़ाइलों की जगह

Edge कॉम्पोनेंट के लिए .properties फ़ाइलों के लिए सबसे ऊपर के लेवल की तीन डायरेक्ट्री होती हैं: इंस्टॉल करने का मालिक और ग्राहक. डिफ़ॉल्ट जगहों को नीचे दी गई टेबल में दिखाया गया है:

चेतावनी: Edge के ग्राहक, /opt/apigee/customer में जाकर सिर्फ़ .property फ़ाइलों में बदलाव कर सकते हैं. कॉम्पोनेंट और इंस्टॉलेशन डायरेक्ट्री में फ़ाइलें देखी जा सकती हैं. हालांकि, किसी फ़ाइल में बदलाव न करें.

मालिक

डिफ़ॉल्ट टोकन रूट डायरेक्ट्री

कॉम्पोनेंट

/opt/apigee/<prefix>-<component>/conf

जहां /<prefix>-<component> कॉम्पोनेंट की पहचान करता है, जैसे कि एज-रूटर या apigee-cassandra.

इंस्टॉल करना

/opt/apigee/token

ग्राहक

/opt/apigee/customer

किसी टोकन की मौजूदा वैल्यू का पता लगाना

कॉम्पोनेंट के लिए .properties फ़ाइल में टोकन सेट करने से पहले, नीचे दिए गए निर्देश का इस्तेमाल करके इसकी मौजूदा वैल्यू तय की जा सकती है:

> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token

यहां comp कॉम्पोनेंट का नाम है और comp, जांच करने के लिए टोकन है.

यह निर्देश टोकन की मौजूदा वैल्यू का पता लगाने के लिए, .property फ़ाइलों की हैरारकी में खोज करता है.

उदाहरण के लिए, राऊटर के लिए conf_http_HTTPRequest.line.limit टोकन की मौजूदा वैल्यू देखने के लिए:

> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

आपको फ़ॉर्म में आउटपुट दिखेगा:

Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

.properties फ़ाइलों में टोकन सेट करना

किसी टोकन की वैल्यू को बदलने के लिए:

  1. टोकन वैल्यू को सेट करने के लिए, कॉम्पोनेंट की .properties फ़ाइल में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो इसे बनाएं.
  2. कॉम्पोनेंट को रीस्टार्ट करें.
  3. टोकन की वैल्यू देखें.

उदाहरण के लिए, Edge राऊटर के लिए अनुरोध के लिए लाइन की सीमा सेट करने के लिए:

  1. conf_http_HTTPRequest.line.limit टोकन को सेट करने के लिए, /opt/apigee/customer/application/router.properties फ़ाइल में बदलाव करें:

    conf_http_HTTPRequest.line.limit=8k
  2. Edge राऊटर को रीस्टार्ट करें:

    > /opt/apigee/apigee-service/bin/apigee-serviceedge-router फिर से शुरू करें
  3. टोकन की वैल्यू देखें:

    > /opt/apigee/apigee-service/bin/apigee-serviceedge-router कॉन्फ़िगर -search conf_http_HTTPRequest.line.limit

एक से ज़्यादा वैल्यू लेने वाला टोकन सेट करना

कुछ टोकन, वैल्यू की कॉमा लगाकर अलग की गई सूची लेते हैं. उदाहरण के लिए, conf_security_rbac.restricted.resources टोकन, प्रतिबंधित यूआरआई की सूची लेता है, ताकि सिर्फ़ सिस्टम एडमिन ही उन्हें कॉल कर सके. conf_security_rbac.restricted.resources की वैल्यू देखने के लिए:

> cd /opt/apigee/edge-management-server
> grep -ri "conf_security_rbac.restricted.resources" *

आउटपुट में ये चीज़ें शामिल होती हैं:

token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status

वैल्यू की सूची लेने वाले टोकन को सेट करने के लिए, .properties फ़ाइल के टोकन की मौजूदा वैल्यू में कोई नई वैल्यू जोड़ें. इसलिए, conf_security_rbac.restricted.resources में यूआरआई /myuri/* को जोड़ने के लिए, /opt/apigee/customer/application/management-server.property फ़ाइल में बदलाव करें, जैसा कि नीचे दिखाया गया है:

conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

टोकन ढूंढना

ज़्यादातर मामलों में, आपको जिन टोकन को सेट करना होता है उनकी जानकारी इस गाइड में दी गई है. हालांकि, अगर आपको यह तय करना है कि किसी प्रॉपर्टी को बदलने के लिए इस्तेमाल किया गया टोकन कौनसा है, तो कॉम्पोनेंट के सोर्स फ़ोल्डर में grep डालें.

उदाहरण के लिए, अगर आपको पता है कि Edge की पिछली रिलीज़ में, आपने session.maxAge प्रॉपर्टी सेट की थी और उसे सेट करने के लिए इस्तेमाल की गई टोकन वैल्यू के बारे में जानना है, तो /opt/apigee/edge-ui/source डायरेक्ट्री में प्रॉपर्टी के लिए grep पर सेट करें:

> grep -ri "session.maxAge" /opt/apigee/edge-ui/source

आपको इस फ़ॉर्म में नतीजा दिखेगा:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

{T}{/T} टैग के बीच की स्ट्रिंग वह टोकन होती है जिसे .properties फ़ाइल में सेट किया जाता है.

ऐसा टोकन सेट करना जिस पर फ़िलहाल टिप्पणी की गई हो

कुछ टोकन पर Edge की कॉन्फ़िगरेशन फ़ाइलों में टिप्पणी की जाती है. अगर कोई ऐसा टोकन सेट करने की कोशिश की जाती है जिस पर टिप्पणी की गई है, तो इस सेटिंग को अनदेखा कर दिया जाता है.

जिस टोकन पर टिप्पणी की गई है उसे सेट करने के लिए, इस फ़ॉर्म में एक खास सिंटैक्स का इस्तेमाल करें:

conf/file.extension+propertyName=propertyValue

उदाहरण के लिए, आपको Message प्रोसेसर पर HTTPClient.proxy.host नाम की प्रॉपर्टी सेट करनी है. इसके बाद, आपको प्रॉपर्टी के लिए grep का इस्तेमाल करके उसका टोकन तय करना होगा:

> cd /opt/apigee/edge-message-processor
> grep -ri "HTTPClient.proxy.host" *

grep कमांड ऐसे फ़ॉर्म में नतीजे दिखाता है जिसमें टोकन वैल्यू शामिल होती है. ध्यान दें कि प्रॉपर्टी के नाम के बारे में क्या बताया गया है, जैसा कि प्रॉपर्टी के नाम के # प्रीफ़िक्स से पता चला है:

source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=

प्रॉपर्टी को सेट करने के लिए, /opt/apigee/customer/application/message-processor.properties में बदलाव करें, ताकि प्रॉपर्टी को इस तरह सेट किया जा सके:

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

ध्यान दें कि प्रॉपर्टी के नाम के आगे conf/http.properties+ कैसे जोड़ा जाता है, जो प्रॉपर्टी वाली कॉन्फ़िगरेशन फ़ाइल की जगह और नाम के बाद "+" से शुरू होता है.

मैसेज प्रोसेसर को रीस्टार्ट करने के बाद, फ़ाइल /opt/apigee/edge-message-processor/conf/http.properties की जांच करें:

> cat /opt/apigee/edge-message-processor/conf/http.properties

फ़ाइल के आखिर में, आपको प्रॉपर्टी सेट इस फ़ॉर्मैट में दिखेगा:

conf/http.properties:HTTPClient.proxy.host=myhost.name.com