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

Edge for Private Cloud v4.18.01

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मालिक	डिफ़ॉल्ट टोकन रूट डायरेक्ट्री
कॉम्पोनेंट	/opt/apigee/<prefix>-<component>/conf जहां /<prefix>-<component> कॉम्पोनेंट की पहचान करता है, जैसे कि एज-राऊटर या apigee-कैसांद्रा.
इंस्टॉल करना	/opt/apigee/token
ग्राहक	/opt/apigee/customer

टोकन की मौजूदा वैल्यू तय करना

कॉम्पोनेंट के लिए, .properties फ़ाइल में कोई टोकन सेट करने से पहले, आप पहले निम्न कमांड का उपयोग करके इसका वर्तमान मान निर्धारित कर सकते हैं:

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

जहां comp कॉम्पोनेंट का नाम है, और टोकन एक टोकन है, जिसकी मदद से जांच की जाती है.

यह निर्देश .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

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

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

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

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

1. /opt/apigee/customer/application/router.properties में बदलाव करें इस फ़ाइल में conf_http_HTTPRequest.line.limit टोकन सेट करें:
   
   conf_http_HTTPRequest.line.limit=8k
2. Edge राऊटर को रीस्टार्ट करें:
   
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है > /opt/apigee/apigee-service/bin/apigee-service Edge-रूटर रीस्टार्ट
3. टोकन की वैल्यू जांचें:
   
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है > /opt/apigee/apigee-service/bin/apigee-service Edge-रूटर कॉन्फ़िगर करें -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/*

टोकन का पता लगाया जा रहा है

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

उदाहरण के लिए, अगर आपको पता है कि 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 नाम की प्रॉपर्टी सेट करनी है प्रोसेसर. इसके बाद, आपको प्रॉपर्टी का टोकन निर्धारित करें:

> 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