4.15.07.00 - Private Cloud के लिए Apigee Edge के रिलीज़ नोट

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

हमने 8 सितंबर, 2015 को मंगलवार को, Private Cloud के लिए Apigee Edge की एक बड़ी सुविधा रिलीज़ की थी.

प्राइवेट क्लाउड के लिए Edge की पिछली तिमाही रिलीज़ (4.15.04.00) के बाद से, ये रिलीज़ हुई हैं और इन्हें इस तिमाही की रिलीज़ में शामिल किया गया है:

• Cloud: 15.04.15, 15.04.29, 15.05.27, 15.06.10, और 15.06.24
• निजी क्लाउड: 4.15.04.01

Edge के किन वर्शन को 4.15.07.00 पर अपग्रेड किया जा सकता है

Edge के मौजूदा वर्शन के आधार पर, ये काम किए जा सकते हैं:

• सीधे 4.15.07.00 पर अपग्रेड करना
• धीरे-धीरे अपग्रेड करना. इसका मतलब है कि आपको अपने मौजूदा वर्शन से Edge के किसी दूसरे वर्शन पर अपग्रेड करना होगा और फिर 4.15.07.00 पर अपग्रेड करना होगा.

ज़्यादा जानकारी के लिए, Edge for Private Cloud के किन वर्शन को 4.15.07.00 पर अपग्रेड किया जा सकता है लेख पढ़ें.

4.15.01.x या इससे पहले के वर्शन से अपग्रेड करने से पहले

1. Cassandra SSTable का वर्शन देखें:
   1. डायरेक्ट्री को /<install-root>/apigee4/data/cassandra/data पर बदलें.
   2. 
      > find खोजने का निर्देश चलाएं . -name *-ic-*
      अगर Cassandra 1 .2 SSTable का इस्तेमाल किया जा रहा है, तो नतीजों में.db फ़ाइलों का एक सेट दिखेगा.
   3. 'खोजें' निर्देश को चलाएं:
      > find . -name *-hf-*
      नतीजे खाली होने चाहिए. इसका मतलब है कि कोई भी .db फ़ाइल hf फ़ॉर्मैट में नहीं है. अगर आपको hf फ़ॉर्मैट में कोई फ़ाइल नहीं दिखती है, तो इसका मतलब है कि आपका काम हो गया है और अब 4.15.07.00 पर अपग्रेड किया जा सकता है.
      
      hf फ़ॉर्मैट, Cassandra 1.0 SSTables के लिए है. अगर आपके पास hf फ़ॉर्मैट में कोई *.db फ़ाइल है, तो आपको इस प्रोसेस के बाकी हिस्से में बताए गए तरीके से, SSTable को अपग्रेड करना होगा.
2. अगर आपको hf फ़ॉर्मैट में कोई *.db फ़ाइल मिलती है, तो SSTable को अपग्रेड करें. इसके लिए, हर Cassandra नोड पर यह कमांड चलाएं. ऐसा तब तक करें, जब तक सभी Cassandra नोड अपग्रेड न हो जाएं:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. पहला चरण दोहराकर देखें कि Cassandra 1.2 के वर्शन के लिए, सभी *.db फ़ाइलें ic फ़ॉर्मैट में हैं या नहीं.
4. अपने Edge इंस्टॉलेशन के हर Cassandra नोड पर, पहले से तीसरे चरण तक दोहराएं.
5. Edge 4.15.07.00 पर अपग्रेड करें.
6. 4.15.07.00 वर्शन पर अपग्रेड करने के बाद, *.db फ़ाइलों की जांच करें. इससे यह पक्का किया जा सकता है कि सभी फ़ाइलों को C* 2.0 स्टाइल के sstable में अपग्रेड कर दिया गया है:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   अगर Cassandra 2 .0 का इस्तेमाल किया जा रहा है, तो यह कमांड.db फ़ाइलों का सेट दिखाएगा.

नई सुविधाएं और सुधार

इस रिलीज़ में जोड़ी गई नई सुविधाएं और किए गए सुधार यहां दिए गए हैं.

इंस्टॉलेशन और अपग्रेड

चुनिंदा कॉम्पोनेंट को अपग्रेड और अनइंस्टॉल करना

apigee-upgrade.sh और apigee-uninstall.sh स्क्रिप्ट की मदद से, अब Edge के उन कंपोनेंट को चुना जा सकता है जिन्हें अपडेट करना है या अनइंस्टॉल करना है. पहले, यह नोड पर मौजूद सभी कॉम्पोनेंट को अपग्रेड या अनइंस्टॉल करता था. (OPDK-1377, OPDK-1175)

अपग्रेड को रोलबैक करना

अगर अपग्रेड के दौरान apigee-upgrade.sh काम नहीं करता है, तो अपग्रेड को रोल-बैक करने के लिए, अब apigee-rollback.sh स्क्रिप्ट का इस्तेमाल किया जा सकता है. अपग्रेड से जुड़ी समस्याओं को ठीक करने के बाद, अपग्रेड की प्रक्रिया को फिर से शुरू किया जा सकता है. (OPDK-1275)

इंस्टॉलर स्क्रिप्ट के छोटे विकल्प

इंस्टॉल स्क्रिप्ट में अब --help जैसे लंबे विकल्प नहीं काम करते. अब इनमें सिर्फ़ एक अक्षर वाले विकल्प इस्तेमाल किए जा सकते हैं, जैसे कि -h. (OPDK-1356)

SmartDocs इंस्टॉल करना

setup-smartdocs.sh स्क्रिप्ट की मदद से SmartDocs इंस्टॉल करते समय, आपसे संगठन, एनवायरमेंट, और वर्चुअल होस्ट डालने के लिए कहा जाता है. इससे यह पक्का होता है कि SmartDocs, सही जगह पर इंस्टॉल हो. पहले, उन वैल्यू को स्क्रिप्ट में हार्ड-कोड किया जाता था. (OPDK-1310)

प्रॉम्प्ट के बिना update-cass-pwd-in-config.sh को चलाना

ENABLE_CASS_AUTH, CASS_USERNAME, और CASS_PASSWORD एनवायरमेंट वैरिएबल सेट करने पर, update-cass-pwd-in-config.sh स्क्रिप्ट बिना प्रॉम्प्ट के चल सकती है. (OPDK-1309)

Edge Platform

इस रिलीज़ में, Edge प्लैटफ़ॉर्म की नई सुविधाएं शामिल हैं.

Edge Private Cloud पर काम करने वाला OpenJDK 1.7

Edge का यह वर्शन, Oracle JDK 1.7 और OpenJDK 7 के साथ काम करता है. साथ ही, इसमें JDK 1.6 के साथ काम करने की सुविधा हटा दी गई है. (OPDK-1187)

ऑपरेटिंग सिस्टम (ओएस) के लिए सहायता

Private Cloud के लिए Apigee Edge ने अपने ऑपरेटिंग सिस्टम के साथ काम करने की सुविधा को बढ़ाया है. अब यह Red Hat Enterprise Linux 6.6 और 7.0 (64-बिट), CentOS 6.5, 6.6, और 7.0 (64-बिट), और Oracle Linux 6.5 के साथ काम करेगा.

OPDK 15.07 में Cassandra 2.0.15 शामिल है

इस रिलीज़ में Cassandra 2.0.15 इंस्टॉल होता है. अगर आपको किसी पिछली रिलीज़ पर अपग्रेड करना है, तो Cassandra का आपका वर्शन अपडेट हो जाएगा. (OPDK-1197)

OAuth टोकन को हैश करने के लिए SHA2 का इस्तेमाल करना

डेटाबेस की सुरक्षा में किसी तरह की गड़बड़ी होने पर, OAuth टोकन को बेहतर तरीके से सुरक्षित रखने के लिए, Edge में SHA1 के अलावा, OAuth टोकन को हैश करने के लिए SHA2 एल्गोरिदम का इस्तेमाल किया जाता है. संगठन-लेवल की नई प्रॉपर्टी की मदद से, नए टोकन के लिए हैशिंग को चालू और कॉन्फ़िगर किया जा सकता है. साथ ही, इस नई सुविधा से पहले मौजूद किसी भी टोकन पर, लेगसी हैशिंग को बनाए रखा जा सकता है. पहले, Private Cloud के लिए Edge में, आपके मैनेजमेंट सर्वर और मैसेज प्रोसेसर पर मौजूद keymanagement.properties फ़ाइल में, hash.oauth.tokens.enabled नाम की एक प्रॉपर्टी होती थी. यह प्रॉपर्टी, OAuth टोकन के लिए SHA1 हैशिंग की सुविधा को अपने-आप चालू करती थी. यह प्रॉपर्टी अब काम नहीं करती.

अगर आपने पहले SHA1 हैशिंग की सुविधा चालू करने के लिए, hash.oauth.tokens.enabled प्रॉपर्टी का इस्तेमाल किया था, तो इस रिलीज़ के लिए अपग्रेड स्क्रिप्ट, आपके लिए संगठन के लेवल की नई प्रॉपर्टी अपने-आप जनरेट करेगी. अपग्रेड के बाद पुष्टि करने के लिए, इस एपीआई का इस्तेमाल करके सिस्टम एडमिन के तौर पर GET करें: https://{host}:{port}/v1/o/{your_org}.

• नई प्रॉपर्टी की मदद से, अपने संगठन में टोकन हैश करने की सुविधा चालू करने के बारे में जानने के लिए, ऐक्सेस टोकन का अनुरोध करना विषय में "डेटाबेस में टोकन हैश करना" देखें.
• मौजूदा टोकन को एक साथ हैश करने के बारे में जानकारी पाने के लिए, Edge for Private Cloud के ऑपरेशंस की गाइड देखें. (APIRT-1389)

लॉग फ़ाइलों के लिए फ़्लैट डायरेक्ट्री स्ट्रक्चर

Edge को फ़्लैट डायरेक्ट्री स्ट्रक्चर में लॉग फ़ाइलें सेव करने के लिए कॉन्फ़िगर किया जा सकता है. इसके लिए, message-logging.properties फ़ाइल में नई enable.flat.directory.structure प्रॉपर्टी को 'सही' पर सेट करें. ज़्यादा जानकारी के लिए, मैसेज को लॉग करने की नीति देखें. (APIRT-1394)

एनवायरमेंट कैश मेमोरी की परफ़ॉर्मेंस

इन-मेमोरी कैश को बेहतर तरीके से मैनेज करने और इस्तेमाल करने के लिए, एनवायरमेंट कैश संसाधनों पर "मेमोरी में ज़्यादा से ज़्यादा एलिमेंट" सेटिंग का इस्तेमाल बंद कर दिया गया है. सभी कैश मेमोरी संसाधनों (डिफ़ॉल्ट कैश मेमोरी के साथ) में मौजूद कुल एलिमेंट, कैश मेमोरी के लिए तय की गई कुल मेमोरी पर निर्भर करते हैं. डिफ़ॉल्ट रूप से, किसी मैसेज प्रोसेसर पर इन-मेमोरी कैश मेमोरी के लिए, उपलब्ध कुल मेमोरी का 40% हिस्सा तय किया जाता है. यह आपके मैसेज प्रोसेसर की cache.properties फ़ाइल में कैश प्रॉपर्टी की सेटिंग से तय होता है. एलिमेंट को इन-मेमोरी कैश से सिर्फ़ तब हटाया जाएगा, जब कैश मेमोरी काफ़ी न हो या एलिमेंट की समयसीमा खत्म हो गई हो.

कैश मैनेजमेंट के लिए, "मेमोरी में ज़्यादा से ज़्यादा एलिमेंट" प्रॉपर्टी का इस्तेमाल करने के पुराने तरीके पर वापस जाने के लिए, cache.properties फ़ाइल में प्रॉपर्टी overrideMaxElementsInCacheResource=false सेट करें. (APIRT-1140)

एपीआई सेवाएं

इस रिलीज़ में, API Services की नई सुविधाएं शामिल हैं.

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

एपीआई प्रॉक्सी एडिटर का नया वर्शन, मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट रूप से चालू होता है. नए एडिटर में, इस्तेमाल करने के तरीके से जुड़े कई सुधार किए गए हैं. इनमें खास जानकारी वाले पेज पर, शर्तों के हिसाब से फ़्लो और एंडपॉइंट के ज़्यादा बेहतर व्यू, डेवलप पेज पर सभी कॉन्फ़िगरेशन, शर्तों के हिसाब से फ़्लो, एंडपॉइंट, और नीतियों को आसानी से जोड़ने की सुविधा, छोटे स्निपेट के बजाय ज़्यादा बेहतर एक्सएमएल व्यू, फ़ाइल नाम और टेक्स्ट को क्रॉल करने वाली खोज, और अन्य सुविधाएं शामिल हैं. (MGMT-2279)

OAuth v2.0 की जानकारी मिटाने से जुड़ी नई नीति

"OAuth 2.0 की जानकारी मिटाएं" की नई नीति की मदद से, OAuth 2 ऐक्सेस टोकन और ऑथराइज़ेशन कोड मिटाए जा सकते हैं. यह नीति, मैनेजमेंट एपीआई की सुविधाओं की जगह ले लेगी. ज़्यादा जानकारी के लिए, OAuthV2 से जुड़ी जानकारी मिटाने की नीति देखें. (MGMT-2257)

OAuth v1.0 की जानकारी मिटाने से जुड़ी नई नीति

"OAuth v1.0 की जानकारी मिटाएं" की नई नीति की मदद से, OAuth v1.0 के अनुरोध टोकन, ऐक्सेस टोकन, और पुष्टि करने वाले कोड मिटाए जा सकते हैं. यह नीति, मैनेजमेंट एपीआई की पहले दी गई सुविधाओं की जगह ले लेगी. ज़्यादा जानकारी के लिए, OAuth V1 की जानकारी मिटाने की नीति देखें. (APIRT-1351)

ऐक्सेस कंट्रोल की नीति

ऐक्सेस कंट्रोल की नीति को बेहतर बनाया गया है, ताकि X-FORWARDED-FOR एचटीटीपी हेडर में आईपी पते शामिल होने पर, अनुमति वाली सूची और पाबंदी वाली सूची में शामिल करने के लिए, आईपी पतों का बेहतर तरीके से आकलन किया जा सके.

हेडर पर कई आईपी पतों की जांच करने की सुविधा चालू होने पर (feature.enableMultipleXForwardCheckForACL को सेट करने के लिए सहायता टीम से संपर्क करें), नीति में मौजूद नए <ValidateBasedOn> एलिमेंट की मदद से, हेडर में पहले आईपी, आखिरी आईपी या सभी आईपी की जांच की जा सकती है. ज़्यादा जानकारी के लिए, ऐक्सेस कंट्रोल से जुड़ी नीति देखें.

इकाई के ऐक्सेस से जुड़ी नीति में नई इकाइयां

इकाई का ऐक्सेस देने वाली नीति, इन नई इकाइयों का ऐक्सेस देती है: consumerkey-scopes, authorizationcode, requesttoken, और verifier. ज़्यादा जानकारी के लिए, ऐक्सेस इकाई की नीति देखें.

आंकड़ों को इकट्ठा करने वाले टूल से जुड़ी नीति: आंकड़ों के नाम को अपने-आप लोअरकेस में बदलना

एपीआई प्रॉक्सी एडिटर (डेवलप पेज > टूल > कस्टम Analytics कलेक्शन) में कस्टम Analytics कलेक्शन बनाते समय, कलेक्टर वैरिएबल (आंकड़ा) "नाम" को छोटा अक्षर में रखना ज़रूरी है. अगर आपने नाम अपरकेस में डाला है, तो टूल, आंकड़ों के कलेक्टर की नीति में, आंकड़ों के नाम को अपने-आप लोअरकेस में बदल देता है. (MGMT-740)

एपीआई प्रॉक्सी एडिटर में क्लासिक ट्रेस को हटाना

एपीआई प्रॉक्सी एडिटर में, ट्रैक करने की सुविधा का नया वर्शन, बीटा वर्शन से सामान्य वर्शन में बदल गया है. "ट्रैस के क्लासिक वर्शन को ऐक्सेस करें" लिंक का इस्तेमाल करके, "क्लासिक ट्रैस" को ऐक्सेस करने की सुविधा अब उपलब्ध नहीं है.

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के सहायता मेन्यू से Apigee कम्यूनिटी का ऐक्सेस

Apigee कम्यूनिटी को मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के सहायता मेन्यू से ऐक्सेस किया जा सकता है.

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी के मैसेज

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, गड़बड़ी के मैसेज को बेहतर बनाने के लिए ये बदलाव किए गए हैं:

• मैनेजमेंट यूज़र इंटरफ़ेस (यूआई), पूरे लॉगिन सेशन के लिए यूआई पर गड़बड़ी के सभी मैसेज को ग्रुप करने और दिखाने के लिए इस्तेमाल किया जाता है. ऐसा तब तक किया जाता है, जब तक आप उन्हें खारिज नहीं कर देते. इस अपडेट के बाद, गड़बड़ी के मैसेज अपने-आप हट जाते हैं. ऐसा तब होता है, जब आप उस पेज से दूसरे पेज पर जाते हैं जिस पर गड़बड़ी हुई थी. (MGMT-2254)
• मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) अब डुप्लीकेट गड़बड़ी के मैसेज को नहीं छिपाता. (MGMT-2242)

यूज़र इंटरफ़ेस (यूआई) की परफ़ॉर्मेंस और गड़बड़ी को ठीक करने की सुविधा को बेहतर बनाया गया

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के अलग-अलग हिस्सों में सामान्य सुधार किए गए हैं. इनमें पेज डिसप्ले की परफ़ॉर्मेंस और गड़बड़ी के मैसेज को हटाना शामिल है.

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, संगठन के उपयोगकर्ता पेज पर भूमिका के हाइपरलिंक

मैनेजमेंट यूज़र इंटरफ़ेस (एडमिन > संगठन के उपयोगकर्ता) में संगठन के उपयोगकर्ता पेज पर, भूमिका के नाम अब हाइपरलिंक किए गए हैं. इससे, भूमिका वाले पेजों पर तुरंत नेविगेट किया जा सकता है. (MGMT-1055)

मैसेज फ़्लो में नए टारगेट वैरिएबल

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

• TargetEndpoint: request.url, target.basepath.with.query की जगह लेता है.
• TargetServer: loadbalancing.targetserver, targetserver.name की जगह लेता है. साथ ही, target.basepath एलिमेंट सिर्फ़ तब पॉप्युलेट होता है, जब TargetEndpoint के HTTPTargetConnection <LoadBalancer> एलिमेंट में <Path> एलिमेंट का इस्तेमाल किया जाता है.

सर्वर नेम इंंडिकेशन (SNI) की सुविधा

Edge, सर्वर नेम इंंडिकेशन (एसएनआई) का इस्तेमाल, दक्षिण की ओर (मैसेज प्रोसेसर से टारगेट एंडपॉइंट तक) करता है. अगर आपको एसएनआई का इस्तेमाल करना है, तो Apigee की सहायता टीम से संपर्क करें.

Java 1.7 ज़रूरी है.

एसएनआई, TLS/एसएसएल का एक एक्सटेंशन है. इसकी मदद से, एक ही आईपी पते और पोर्ट से कई एचटीटीपीएस टारगेट दिखाए जा सकते हैं. इसके लिए, उन सभी टारगेट को एक ही सर्टिफ़िकेट का इस्तेमाल करने की ज़रूरत नहीं होती.

इसके लिए, Edge के लिए खास तौर पर कॉन्फ़िगरेशन करने की ज़रूरत नहीं है. अगर आपका एनवायरमेंट, दक्षिण की ओर जाने वाले ट्रैफ़िक के लिए कॉन्फ़िगर किया गया है, तो Edge इस पर काम करता है. डिफ़ॉल्ट रूप से, Edge Cloud पर यह सुविधा काम करती है.

Edge, अनुरोध यूआरएल से होस्टनेम को अपने-आप निकालता है और उसे एसएसएल हैंडशेक अनुरोध में जोड़ता है. उदाहरण के लिए, अगर टारगेट होस्ट https://example.com/request/path है, तो Edge server_name एक्सटेंशन जोड़ता है, जैसा कि यहां दिखाया गया है:

SNI के बारे में ज़्यादा जानकारी के लिए, http://en.wikipedia.org/wiki/Server_Name_Indication पर जाएं.

एसएसएल सर्टिफ़िकेट की जानकारी में "हस्ताक्षर का एल्गोरिदम"

एसएसएल सर्टिफ़िकेट की जानकारी में एक नया "हस्ताक्षर एल्गोरिदम" फ़ील्ड जोड़ा गया है. इसे मैनेजमेंट यूज़र इंटरफ़ेस (एडमिन > एसएसएल सर्टिफ़िकेट) और मैनेजमेंट एपीआई (किसी पासकोड या ट्रस्टस्टोर से सर्टिफ़िकेट की जानकारी पाएं) में देखा जा सकता है. सर्टिफ़िकेट जनरेट करने के लिए इस्तेमाल किए गए हैश एल्गोरिदम के आधार पर, फ़ील्ड में "sha1WithRSAEncryption" या "sha256WithRSAEncryption" दिखता है.

ऐसे एसएसएल सर्टिफ़िकेट दिखाना जिनकी समयसीमा खत्म होने वाली है

मैनेजमेंट यूज़र इंटरफ़ेस (एडमिन > एसएसएल सर्टिफ़िकेट) में एसएसएल सर्टिफ़िकेट पेज से पता चलता है कि एसएसएल सर्टिफ़िकेट की समयसीमा कब खत्म हो रही है. यह समयसीमा, समयसीमा खत्म होने के नए ड्रॉप-डाउन फ़ील्ड में आपके चुने गए विकल्प के आधार पर, 10, 15, 30 या 90 दिनों की हो सकती है.

खतरों से सुरक्षा से जुड़ी गड़बड़ी का कॉन्फ़िगरेशन

अगर कोई मैसेज, JSON या एक्सएमएल खतरे से सुरक्षा से जुड़ी नीति को पूरा नहीं करता है, तो Edge डिफ़ॉल्ट रूप से एचटीटीपी 500 इंटरनल सर्वर गड़बड़ी का स्टेटस कोड और ExecutionFailed गड़बड़ी दिखाता है. संगठन-लेवल की नई प्रॉपर्टी की मदद से, उस गड़बड़ी के व्यवहार को बदला जा सकता है. संगठन की प्रॉपर्टी features.isPolicyHttpStatusEnabled को 'सही है' पर सेट करने पर, यह व्यवहार होता है:

• अनुरोध: किसी भी अनुरोध फ़्लो से जुड़ी खतरे से सुरक्षा की नीति के साथ, अमान्य मैसेज के लिए 400 स्टेटस कोड दिखता है. साथ ही, नीति से जुड़ी गड़बड़ी का मैसेज भी दिखता है.
• जवाब: किसी भी रिस्पॉन्स फ़्लो से जुड़ी खतरे से सुरक्षा करने वाली नीति के साथ, अमान्य मैसेज के लिए अब भी 500 स्टेटस कोड दिखता है. साथ ही, नीति से जुड़ी गड़बड़ी का कोई एक मैसेज दिखता है, न कि सिर्फ़ 'कार्रवाई पूरी नहीं हो सकी' मैसेज.

Cloud के ग्राहकों को संगठन की प्रॉपर्टी सेट करने के लिए, Apigee की सहायता टीम से संपर्क करना होगा. यह सुविधा, Edge Private Cloud के ग्राहकों के लिए, अगली तिमाही में रिलीज़ होने वाले Private Cloud के वर्शन में उपलब्ध होगी.

एंडपॉइंट, प्रॉक्सी, और अन्य इकाइयों के लिए अपडेट किए गए स्कीमा

रेफ़रंस स्कीमा को नीति से जुड़ी इकाइयों के लिए अपडेट किया गया है. जैसे, TargetEndpoint, ProxyEndpoint, APIProxy वगैरह. https://github.com/apigee/api-platform-samples/tree/master/schemas पर जाएं. (APIRT-1249)

डेवलपर सेवाएं

इस रिलीज़ में, Developer Services की नई सुविधाएं शामिल हैं.

SmartDocs की सामान्य रूप से उपलब्धता

SmartDocs अब बीटा वर्शन से बाहर निकलकर, सामान्य रूप से उपलब्ध हो गया है. अपडेट और नई सुविधाओं में ये शामिल हैं:

• Swagger 2.0 के साथ काम करने की सुविधा. इसमें, फ़ाइल या यूआरएल से इंपोर्ट करने की सुविधा के साथ-साथ, पसंद के मुताबिक नाम वाले सुरक्षा ऑब्जेक्ट के साथ काम करने की सुविधा भी शामिल है.
• SmartDocs जनरेट करने वाले टेंप्लेट में विज़ुअल डिज़ाइन में सुधार.
• डेवलपर पोर्टल में इस्तेमाल करने और वर्कफ़्लो को बेहतर बनाने की सुविधाएं. ये सुविधाएं, Drupal में कॉन्टेंट > SmartDocs मेन्यू में उपलब्ध हैं.
• "कस्टम टोकन" की पुष्टि करने की सुविधा को अब "एपीआई पासकोड" कहा जाता है.
• बदलाव के लेवल पर तय किए गए पुष्टि करने वाले "सुरक्षा" ऑब्जेक्ट.
• टेंप्लेट लेवल पर क्लाइंट की पुष्टि करने की सुविधा का कॉन्फ़िगरेशन. नए बदलावों से, पहले से कॉन्फ़िगर किए गए स्मार्ट दस्तावेज़ों के क्लाइंट के क्रेडेंशियल अब रीसेट नहीं होते.

इस सुविधा के बारे में ज़्यादा जानने के लिए, यह ब्लॉग पोस्ट देखें.

SmartDocs दस्तावेज़ के लिए, एपीआई का दस्तावेज़ बनाने के लिए SmartDocs का इस्तेमाल करना देखें.

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में दिखाया गया, डेवलपर ऐप्लिकेशन का नाम

Edge में डेवलपर ऐप्लिकेशन का एक इंटरनल नाम होता है, जो नहीं बदलता. साथ ही, एक डिसप्ले नेम होता है, जिसे बदला जा सकता है. मैनेजमेंट यूज़र इंटरफ़ेस (पब्लिश करें > डेवलपर ऐप्लिकेशन > ऐप्लिकेशन का नाम) में मौजूद डेवलपर ऐप्लिकेशन पेज पर, ऐप्लिकेशन का "नाम" और "डिसप्ले नेम", दोनों दिखते हैं. इससे, ऐप्लिकेशन के इंटरनल नेम से, उन्हें आसानी से पहचाना जा सकता है. इससे, समस्या हल करने और एपीआई मैनेज करने में मदद मिलती है.

Analytics की सेवाएं

इस रिलीज़ में Analytics Services की ये नई सुविधाएं शामिल हैं.

सेव किए गए डेटा की समयसीमा

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) या एपीआई की मदद से आंकड़ों की रिपोर्ट जनरेट करते समय, मौजूदा तारीख से छह महीने से ज़्यादा पुराना डेटा डिफ़ॉल्ट रूप से ऐक्सेस नहीं किया जा सकता. अगर आपको छह महीने से ज़्यादा पुराना डेटा ऐक्सेस करना है, तो Apigee की सहायता टीम से संपर्क करें.

कस्टम रिपोर्ट का क्लासिक वर्शन, मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) से हटाया जा रहा है

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

डेवलपर ऐक्टिविटी विजेट की परफ़ॉर्मेंस

बेहतर परफ़ॉर्मेंस देने के लिए, मुख्य आंकड़ों के डैशबोर्ड (डेवलपर ऐक्टिविटी सेक्शन) पर फ़नल विजेट को बेहतर बनाया गया है.

कमाई करना

इस रिलीज़ में, कमाई करने की ये नई सुविधाएं शामिल हैं.

प्लान की कीमत से जुड़ी ईमेल सूचनाएं

किराया प्लान की नई ईमेल सूचना के टाइप की मदद से, डेवलपर को सूचना दी जा सकती है. इससे उन्हें पता चलता है कि खरीदे गए वॉल्यूम-बैंड वाले या बंडल किराया प्लान में, ट्रांज़ैक्शन या डॉलर की तय सीमा पूरी हो गई है. ज़्यादा जानकारी के लिए, सूचना टेंप्लेट का इस्तेमाल करके सूचनाएं सेट अप करना लेख पढ़ें.

बार-बार लगने वाले शुल्क और डेटा इकट्ठा करने की अवधि को सिंक करना

किराये के प्लान में, दो अलग-अलग समयावधि लागू थीं:

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

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

अगर बार-बार होने वाला कोई शुल्क नहीं है, तो बंडल, रेट कार्ड पर बताए गए एग्रीगेशन के आधार पर रीसेट हो जाते हैं. उदाहरण के लिए, अगर कोई डेवलपर महीने की 19 तारीख को किराया कार्ड का इस्तेमाल शुरू करता है और एग्रीगेशन का आधार हर महीने है, तो बंडल के इस्तेमाल की जानकारी 19 तारीख के एक महीने बाद रीसेट हो जाती है.

एग्रीगेशन बेसिस की सुविधा अब काम नहीं करती. इसे आने वाले समय में, कमाई करने की सुविधा से हटा दिया जाएगा. ज़्यादा जानकारी के लिए, किराया तय करने के प्लान की जानकारी दें लेख पढ़ें.

आय की खास जानकारी वाली रिपोर्ट में कस्टम एट्रिब्यूट

लेन-देन रिकॉर्ड करने की नीतियों की मदद से, लेन-देन से जुड़े कस्टम एट्रिब्यूट का डेटा कैप्चर किया जा सकता है. साथ ही, अब उन कस्टम लेन-देन एट्रिब्यूट को आय की खास जानकारी वाली रिपोर्ट में शामिल किया जा सकता है. अपने संगठन में MINT.SUMMARY_CUSTOM_ATTRIBUTES प्रॉपर्टी जोड़कर, यह बताया जा सकता है कि रिपोर्ट में इस्तेमाल करने के लिए, डेटाबेस टेबल में कौनसे कस्टम एट्रिब्यूट जोड़े गए हैं.

Private Cloud के लिए Apigee Edge के ग्राहक, नीचे दिए गए एपीआई कॉल और सिस्टम एडमिन के क्रेडेंशियल की मदद से फ़्लैग सेट कर सकते हैं.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

ध्यान दें कि एपीआई कॉल में कस्टम एट्रिब्यूट का कलेक्शन, यूआरएल-कोड में बदला गया है.

SmartDocs को अपग्रेड करने की प्रोसेस

अगर बीटा वर्शन के दौरान, SmartDocs का इस्तेमाल पहले से किया जा रहा है, तो सामान्य तौर पर उपलब्ध वर्शन में नई सुविधाओं और क्षमताओं का इस्तेमाल करने के लिए, आपको अपने डेवलपर पोर्टल में SmartDocs को अपग्रेड करना होगा.

आपके डेवलपर पोर्टल में पहले से पब्लिश किए गए SmartDocs पेज काम करते रहेंगे. हालांकि, मौजूदा या नए पेजों में बदलाव करने या उन्हें पब्लिश करने से पहले, आपको अपडेट करने की प्रोसेस को पूरा करना होगा.

ध्यान रखें कि अपने डेवलपर पोर्टल में स्मार्ट दस्तावेज़ों को रेंडर और पब्लिश किया जा सकता है. हालांकि, स्मार्ट दस्तावेज़, Apigee की Edge API मैनेजमेंट सेवाओं में मौजूद एपीआई मॉडल से जनरेट होते हैं. Edge में एपीआई मॉडल में किया गया कोई भी बदलाव, आपके सभी Pantheon एनवायरमेंट में एक जैसा ही होगा. ठीक उसी तरह जैसे डेवलपर, Pantheon के सभी एनवायरमेंट में मौजूद होते हैं.

SmartDocs के बीटा वर्शन से, सामान्य वर्शन पर अपग्रेड करने के लिए

1. Pantheon पर, अपने dev या test एनवायरमेंट में 15.05.27 रिलीज़ को अपडेट करें और उसकी जांच करें.
2. इस्तेमाल किए जा रहे किसी भी मौजूदा एपीआई मॉडल को बदलने के लिए, नया मॉडल बनाएं.
   • अगर Swagger या WADL दस्तावेज़ इंपोर्ट किए जा रहे हैं, तो उन्हें फिर से नए रिविज़न में इंपोर्ट करें.
   • अगर आपने SmartDocs मॉड्यूल की मदद से अपना एपीआई मॉडल मैनेज किया है, तो उसे SmartDocs JSON के तौर पर एक्सपोर्ट करें. इसके बाद, फ़ाइल अटैचमेंट का इस्तेमाल करके, उसे अपने नए मॉडल में इंपोर्ट करें.
3. अपने मॉडल के रिविज़न की सुरक्षा प्रॉपर्टी सेट करें. कॉन्टेंट > SmartDocs > मॉडल पेज पर, सुरक्षा सेटिंग चुनें.
   
4. मॉडल की सेटिंग वाले पेज (कॉन्टेंट > SmartDocs) में, पहले से कॉन्फ़िगर की गई पुष्टि की सुविधा देखें. इसके लिए, ऑपरेशंस कॉलम में सेटिंग पर क्लिक करें.
   
5. सीएसएस और JS एसेट के v6 वर्शन का इस्तेमाल करने के लिए, सभी कस्टम टेंप्लेट अपडेट करें. साथ ही, ऑब्जेक्ट के नए नामों को दिखाने के लिए बदलाव करें. जैसे, authSchemes और apiSchema. SmartDocs टेंप्लेट अपडेट करने के बारे में जानकारी पाने के लिए, एपीआई का दस्तावेज़ बनाने के लिए, SmartDocs का इस्तेमाल करना लेख पढ़ें.
6. मॉडल में किए गए बदलावों को फिर से रेंडर करके पब्लिश करें.
7. नए दस्तावेज़ की पुष्टि करने के बाद, अपने प्रोडक्शन पोर्टल को 15.05.27 रिलीज़ पर अपडेट करें.

अगर आप Edge के एंटरप्राइज़ ग्राहक हैं और आपको अपग्रेड की प्रोसेस के बारे में कोई सवाल पूछना है या कोई समस्या है, तो कृपया marsh@apigee.com और cnovak@apigee.com पर ईमेल करें. इसके अलावा, बेहतर जवाब पाने के लिए, कृपया Apigee कम्यूनिटी का इस्तेमाल करें.

आने वाले समय में सुविधाओं में होने वाले बदलाव और उन्हें बेहतर बनाना

इस सेक्शन में, आने वाले समय में सुविधा में होने वाले बदलावों और सुधारों की झलक दी गई है:

रिस्पॉन्स कैश मेमोरी से जुड़ी नीति के काम करने के तरीके में बदलाव

आने वाले समय में रिलीज़ होने वाले वर्शन में, रिस्पॉन्स कैश मेमोरी से जुड़ी नीति के <ExcludeErrorResponse> एलिमेंट का डिफ़ॉल्ट व्यवहार बदल जाएगा. हालांकि, यह तय नहीं किया गया है कि यह रिलीज़ कब होगी.

मौजूदा तरीका: रिस्पॉन्स कैश मेमोरी से जुड़ी नीति में, <ExcludeErrorResponse> एलिमेंट डिफ़ॉल्ट रूप से 'गलत है' पर सेट होता है. इसका मतलब है कि डिफ़ॉल्ट रूप से, रिस्पॉन्स कैश मेमोरी में सेव करने की नीति के तहत, किसी भी एचटीटीपी स्टेटस कोड (3xx कोड के साथ) वाले रिस्पॉन्स को कैश मेमोरी में सेव किया जाता है.

आने वाले समय में कैश मेमोरी का इस्तेमाल करने का तरीका: रिस्पॉन्स कैश मेमोरी की नीति में, <ExcludeErrorResponse> एलिमेंट डिफ़ॉल्ट रूप से 'सही' पर सेट रहेगा. इसका मतलब है कि डिफ़ॉल्ट रूप से, सिर्फ़ एचटीटीपी स्टेटस कोड 200 से 205 वाले रिस्पॉन्स को कैश मेमोरी में सेव किया जाएगा. इस व्यवहार को बदलने और सभी स्टेटस कोड के रिस्पॉन्स को कैश मेमोरी में सेव करने के लिए, आपको <ExcludeErrorResponse> एलिमेंट को साफ़ तौर पर 'सही' पर सेट करना होगा.

मौजूदा समस्या हल करने का तरीका: अगर आपको Private Cloud 4.15.07.00 और उससे पहले के रिलीज़ के लिए, सिर्फ़ स्टेटस कोड 200 से 205 वाले रिस्पॉन्स को कैश मेमोरी में सेव करना है, तो आपको एलिमेंट <ExcludeErrorResponse> को साफ़ तौर पर 'सही' पर सेट करना होगा.

बग ठीक किए गए

इस रिलीज़ में ये गड़बड़ियां ठीक की गई हैं.

पहले से मालूम समस्याएं

इस रिलीज़ में ये समस्याएं मौजूद हैं.

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart