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

Edge for Private Cloud v4.18.05

इंस्टॉल करने के बाद 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" बनाने के लिए, chown का इस्तेमाल करें या, अगर आपने "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 फ़ाइलों के लिए, तीन सबसे ऊपर के लेवल की डायरेक्ट्री हैं कॉम्पोनेंट: इंस्टॉलेशन, मालिक, और ग्राहक. डिफ़ॉल्ट स्थान निम्न में दिखाए गए हैं तालिका:

मालिक डिफ़ॉल्ट टोकन रूट डायरेक्ट्री
कॉम्पोनेंट
/opt/apigee/component_name/conf

जहां component_name, कॉम्पोनेंट की पहचान करता है. संभावित वैल्यू शामिल करें:

  • apigee-cassandra (कैसंड्रा)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (PostgreSQL डेटाबेस)
  • apigee-qpidd (सवाल और जवाब)
  • apigee-sso (Edge एसएसओ)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (मैनेजमेंट सर्वर)
  • edge-management-ui (नया Edge यूज़र इंटरफ़ेस (यूआई))
  • edge-message-processor (मैसेज प्रोसेस करने वाला)
  • edge-postgres-server (पोस्टग्रेस सर्वर)
  • edge-qpid-server (Qpid सर्वर)
  • edge-router (एज राऊटर)
  • edge-ui (क्लासिक यूज़र इंटरफ़ेस (यूआई))
इंस्टॉल करना
/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

.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-router restart
  3. टोकन की वैल्यू देखें:
    /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

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

कुछ टोकन, वैल्यू की कॉमा-सेपरेटेड लिस्ट लेते हैं. उदाहरण के लिए, conf_security_rbac.restricted.resources टोकन, प्रतिबंधित यूआरआई की सूची को लेता है, ताकि केवल sysadmin उन्हें कॉल कर सकता है. 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/*

टोकन ढूंढें

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

उदाहरण के लिए, अगर आपको पता है कि 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