एपीआई डेवलपमेंट की लाइफ़साइकल

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

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

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

एपीआई सेवा एपीआई की जानकारी, एपीआई रेफ़रंस में दी गई है. यहां जाएं: API संदर्भ मिल रहा है शुरू हुआ.

एनवायरमेंट

Apigee Edge पर मौजूद हर संगठन के पास कम से कम दो डिप्लॉयमेंट एनवायरमेंट होते हैं एपीआई प्रॉक्सी के लिए: 'test' और 'प्रोडक्शन'. दो एनवायरमेंट के बीच का फ़र्क़ मनचाहे तरीके से तय किया जाता है — हर एनवायरमेंट की पहचान, नेटवर्क पतों (यूआरएल) के अलग सेट से की जाती है. कॉन्टेंट बनाने इसका मकसद आपको ऐसा डोमेन उपलब्ध कराना है जिसमें आप एपीआई से पहले एपीआई प्रॉक्सी बना सकें और उनकी पुष्टि कर सकें बाहरी डेवलपर को दिखाया जा सकता है.

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

इनबाउंड, सर्वर TLS/एसएसएल हर एनवायरमेंट के लिए अपने-आप चालू हो जाता है. दो VirtualHost हर एनवायरमेंट में पहले से तय की गई हैं: default और secure. डिफ़ॉल्ट तय करता है एचटीटीपी पता, जो सुरक्षित तौर पर पहले से कॉन्फ़िगर किए गए सर्वर-साइड TLS/एसएसएल के साथ एचटीटीपी/एस पते को तय करता है. तय सीमा में का इस्तेमाल करते हैं, तो आप बताते हैं कि ProxyEndpoint को किन VirtualHosts को सुनना चाहिए. प्रोडक्शन के लिए प्रमोट करते समय, आम तौर पर default को हटाकर एचटीटीपी को बंद कर दिया जाता है एपीआई प्रॉक्सी कॉन्फ़िगरेशन से VirtualHost.

उदाहरण के लिए, यहां दिया गया ProxyEndpoint, एचटीटीपी और एचटीटीपीएस पर सुनता है.

<HTTPProxyConnection>
  <BasePath>/v0/weather</BasePath>
  <Properties/>
  <VirtualHost>default</VirtualHost>
  <VirtualHost>secure</VirtualHost>
</HTTPProxyConnection>

ProxyEndpoint कॉन्फ़िगरेशन से default VirtualHost को मिटाने का मतलब है कि आप एक ऐसा एपीआई प्रॉक्सी बनाना जो सिर्फ़ एचटीटीपीएस पर सुनता हो, एचटीटीपी पर नहीं.

<HTTPProxyConnection>
  <BasePath>/v0/weather</BasePath>
  <Properties/>
  <VirtualHost>secure</VirtualHost>
</HTTPProxyConnection>

आप मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के मुख्य मेन्यू में एनवायरमेंट.

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

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

एपीआई प्रॉक्सी बनाते समय आपको यह तय करना होगा कि आपको किस एनवायरमेंट में काम करना है. आपने लोगों तक पहुंचाया मुफ़्त में नया एपीआई प्रॉक्सी बनाने का विकल्प चुना जा सकता है. हालांकि, इसका सुझाव नहीं दिया जाता है, क्योंकि एपीआई उपलब्ध कराएं. आम तौर पर, एपीआई प्रॉक्सी बनाकर test. जांच करने के बाद, इसके लिए प्रमोशन किया जाता है prod.

ज़्यादा जानकारी के लिए, यह देखें डिप्लॉयमेंट को समझना.

टेस्ट में बार-बार डेवलपमेंट

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

प्रमोशन के लिए प्रमोशन

जब एपीआई प्रॉक्सी को पूरी तरह से लागू करके टेस्ट कर लिया जाता है, तो उसे 'प्रोडक्शन' में प्रमोट किया जा सकता है. एपीआई प्रॉक्सी में किए गए बदलावों का इस्तेमाल, एपीआई प्रॉक्सी में किए गए बदलावों को ओवरराइट करने के लिए किया जाएगा प्रोडक्शन पर डिप्लॉय किया गया.

एपीआई सेवाएं, एपीआई प्रॉक्सी को इस्तेमाल करने, एपीआई प्रॉक्सी को कम से कम इस्तेमाल करने, के डिप्लॉयमेंट की प्रोसेस के दौरान ऐप्लिकेशन और असली उपयोगकर्ताओं पर पड़ने वाले असर के बारे में बताएं.

स्क्रिप्टिंग डिप्लॉयमेंट

Apigee Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) की मदद से, एपीआई प्रॉक्सी को सीधे तौर पर एपीआई से प्रोडक्शन के लिए डिप्लॉय किया जा सकता है प्रॉक्सी बिल्डर. हालांकि, कई परिस्थितियों में सुरक्षा, विश्वसनीयता, और एक जैसा अनुभव देने पर, डेवलपमेंट टीम की स्क्रिप्ट डिप्लॉयमेंट की प्रोसेस को पूरा किया जाएगा. ऐसा करने के लिए, ऐसे कोड और स्क्रिप्ट लिखें जो एपीआई सेवाओं के ज़रिए दिखाए गए RESTful API को शुरू करती हैं.

पर्यावरण से जुड़े संसाधन

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

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

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

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

ज़्यादा जानकारी के लिए, डिप्लॉयमेंट के बारे में जानकारी लेख पढ़ें.