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

Edge for Private Cloud v4.18.05

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

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

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

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

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

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

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

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

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

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

/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 डायरेक्ट्री में मौजूद .properties फ़ाइलें पढ़ी जाती हैं. इसका मतलब है कि कॉम्पोनेंट पर सेट की गई सभी प्रॉपर्टी, अपग्रेड में बनी रहेंगी.

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

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

/opt/apigee/component_name/conf

/opt/apigee/token

/opt/apigee/customer

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

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

/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token

यहां component_name, कॉम्पोनेंट का नाम है और token वह टोकन है जिसकी जांच करनी है.

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

उदाहरण के लिए, राउटर के लिए 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. एज राउटर को रीस्टार्ट करें:

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

3. टोकन की वैल्यू देखें:

   /opt/apigee/apigee-service/bin/apigee-service edge-router configure -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 फ़ाइल में टोकन की मौजूदा वैल्यू में कोई नई वैल्यू जोड़ें. इसलिए, /myuri/* को conf_security_rbac.restricted.resources में जोड़ने के लिए, /opt/apigee/customer/application/management-server.properties फ़ाइल में नीचे दिखाए गए तरीके से बदलाव करें:

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

टोकन ढूंढना

ज़्यादातर मामलों में, आपको जिन टोकन को सेट करना है उनकी पहचान इस गाइड में की गई है. हालांकि, अगर आपको किसी प्रॉपर्टी को बदलने के लिए इस्तेमाल किए गए टोकन का पता लगाना है, तो कॉम्पोनेंट के source फ़ोल्डर में 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

उदाहरण के लिए, आपको मैसेज प्रोसेसर पर 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