👫 🤶🏻 ⚽️ पुलुमी के साथ कोड के रूप में अपने बुनियादी ढांचे का परीक्षण। भाग २ 👩🏻‍🏫 🐱 🛐

सभी को नमस्कार। आज हम आपके साथ "पुलुमी का उपयोग कर एक कोड के रूप में परीक्षण के बुनियादी ढांचे" लेख के अंतिम भाग को साझा कर रहे हैं, जिसका एक अनुवाद विशेष रूप से पाठ्यक्रम के छात्रों के लिए तैयार किया गया था "DevOps प्रथाओं और उपकरण" ।

परिनियोजन परीक्षण

परीक्षण की गई परीक्षण शैली एक शक्तिशाली दृष्टिकोण है, यह हमें अपने बुनियादी ढांचे के कोड के अंदरूनी हिस्सों की जांच करने के लिए एक सफेद बॉक्स का परीक्षण करने की अनुमति देता है। हालाँकि, यह कुछ हद तक सीमित करता है जिसे हम सत्यापित कर सकते हैं। प्रत्यक्ष तैनाती से पहले पुलुमी द्वारा बनाई गई इन-मेमोरी तैनाती योजना के आधार पर परीक्षण किए जाते हैं और इसलिए तैनाती का परीक्षण नहीं किया जा सकता है। ऐसे मामलों के लिए, पुलुमी का एकीकरण परीक्षण ढांचा है। और ये दो दृष्टिकोण एक साथ महान काम करते हैं!

पुलुमी एकीकरण परीक्षण ढांचे को गो में लिखा गया है, और यह इसकी मदद से है कि हम अपने अधिकांश आंतरिक कोड का परीक्षण करते हैं। यदि पहले चर्चा की गई इकाई परीक्षण दृष्टिकोण सफेद बॉक्स परीक्षण की तरह अधिक था, तो एकीकरण परीक्षण एक ब्लैक बॉक्स है। (पूरी तरह से आंतरिक परीक्षण के लिए भी विकल्प हैं।) इस ढांचे को पूर्ण पुल्मी कार्यक्रम लेने और इसके लिए विभिन्न जीवन चक्र संचालन करने के लिए बनाया गया था, जैसे कि खरोंच से एक नया ढेर तैनात करना, इसे विविधताओं के साथ अद्यतन करना और इसे हटाना, संभवतः कई बार। हम उन्हें नियमित रूप से चलाते हैं (उदाहरण के लिए, रात में) और तनाव परीक्षणों के रूप में।

(हम यह सुनिश्चित करने के लिए काम कर रहे हैं कि समान एकीकरण परीक्षण क्षमताएं मूल भाषा एसडीके में हैं। आप उस एकीकरण की रूपरेखा का उपयोग कर सकते हैं, जिस भाषा में आपका पुलुमी कार्यक्रम लिखा है।

इस ढांचे का उपयोग करके कार्यक्रम चलाकर, आप निम्नलिखित की जांच कर सकते हैं:

आपका प्रोजेक्ट कोड वाक्यात्मक रूप से सही है और त्रुटियों के बिना काम करता है।
ढेर और रहस्य कॉन्फ़िगरेशन सेटिंग्स काम करती हैं और सही ढंग से व्याख्या की जाती हैं।
आपकी परियोजना को आपके चुने हुए क्लाउड प्रदाता में सफलतापूर्वक तैनात किया जा सकता है।
आपकी परियोजना को प्रारंभिक अवस्था से एन अन्य राज्यों में सफलतापूर्वक अपग्रेड किया जा सकता है।
आपकी परियोजना सफलतापूर्वक नष्ट हो सकती है और आपके क्लाउड प्रदाता से हटा दी जा सकती है।

जैसा कि हम जल्द ही देखेंगे, इस ढांचे का उपयोग रनटाइम सत्यापन करने के लिए भी किया जा सकता है।

सरल एकीकरण परीक्षण

इसे कार्रवाई में देखने के लिए, हम pulumi/examples भंडार को देखेंगे, क्योंकि हमारी टीम और पुलुमी समुदाय अपने स्वयं के अनुरोधों, कमानों और रात के निर्माण के पूल का परीक्षण करने के लिए इसका उपयोग करते हैं।

नीचे हमारे उदाहरण का एक सरलीकृत परीक्षण है , जो S3 बाल्टी और कुछ अन्य वस्तुओं का प्रावधान करता है :

example_test.go:

 package test import ( "os" "path" "testing" "github.com/pulumi/pulumi/pkg/testing/integration" ) func TestExamples(t *testing.T) { awsRegion := os.Getenv("AWS_REGION") if awsRegion == "" { awsRegion = "us-west-1" } cwd, _ := os.Getwd() integration.ProgramTest(t, &integration.ProgramTestOptions{ Quick: true, SkipRefresh: true, Dir: path.Join(cwd, "..", "..", "aws-js-s3-folder"), Config: map[string]string{ "aws:region": awsRegion, }, }) }

यह परीक्षण aws-js-s3-folder लिए स्टैक को बनाने, संशोधित करने और नष्ट करने के मूल जीवन चक्र से गुजरता है। पारित परीक्षण की रिपोर्ट करने में लगभग एक मिनट लगेगा:

 $ go test . PASS ok ... 43.993s

इन परीक्षणों के व्यवहार को अनुकूलित करने के लिए कई विकल्प हैं। विकल्पों की पूरी सूची के लिए ProgramTestOptions संरचना देखें। उदाहरण के लिए, आप Jaeger समापन बिंदु को ट्रेस ( Tracing ) में कॉन्फ़िगर कर सकते हैं, यह इंगित कर सकते हैं कि आप परीक्षण को नकारात्मक परीक्षण ( ExpectFailure ) के दौरान ExpectFailure होने की उम्मीद करते हैं, क्रमिक राज्य संक्रमण ( EditDirs ) के लिए कार्यक्रम में "संपादन" की एक श्रृंखला लागू करें, और बहुत कुछ। आइए देखें कि आवेदन की तैनाती को सत्यापित करने के लिए उनका उपयोग कैसे करें।

संसाधन गुणों की जाँच करना

ऊपर उल्लिखित एकीकरण यह सुनिश्चित करता है कि हमारा कार्यक्रम "काम करता है" - यह दुर्घटना नहीं करता है। लेकिन क्या होगा अगर हम परिणामी स्टैक के गुणों की जांच करना चाहते हैं? उदाहरण के लिए, कुछ विशेष प्रकार के संसाधन तैयार किए गए (या नहीं थे) और उनकी कुछ विशेषताएं हैं।

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

इसका एक मूल उदाहरण देखने के लिए, आइए सत्यापित करें कि हमारा कार्यक्रम एक S3 बाल्टी बनाता है:

  integration.ProgramTest(t, &integration.ProgramTestOptions{ // as before... ExtraRuntimeValidation: func(t *testing.T, stack integration.RuntimeValidationStackInfo) { var foundBuckets int for _, res := range stack.Deployment.Resources { if res.Type == "aws:s3/bucket:Bucket" { foundBuckets++ } } assert.Equal(t, 1, foundBuckets, "Expected to find a single AWS S3 Bucket") }, })

अब, जब हम गो टेस्ट चलाते हैं, तो यह न केवल जीवन चक्र परीक्षणों की बैटरी से गुजरेगा, बल्कि स्टैक को सफलतापूर्वक तैनात करने के बाद, यह परिणामी स्थिति की एक अतिरिक्त जांच करेगा।

रनटाइम परीक्षण

अब तक, सभी परीक्षण विशेष रूप से तैनाती व्यवहार के बारे में और पुलुमी संसाधन मॉडल के बारे में हैं। क्या होगा यदि आप यह सत्यापित करना चाहते हैं कि आपका तैयार बुनियादी ढांचा वास्तव में काम करता है? उदाहरण के लिए, कि वर्चुअल मशीन चल रही है, S3 बाल्टी में वह है जो हम उम्मीद करते हैं, और इसी तरह।

आप पहले से ही यह पता लगा सकते हैं कि यह कैसे करना है: ProgramTestOptions लिए ExtraRuntimeValidation विकल्प इसके लिए एक शानदार अवसर है। इस बिंदु पर, आप अपने कार्यक्रम के संसाधनों की पूर्ण स्थिति तक पहुंच के साथ एक मनमाना गो परीक्षण चलाते हैं। इस राज्य में वर्चुअल मशीन, यूआरएल और सब कुछ है जो प्राप्त क्लाउड एप्लिकेशन और बुनियादी ढांचे के साथ वास्तविक बातचीत के लिए आवश्यक है, जैसे कि आईपी पते की जानकारी शामिल है।

उदाहरण के लिए, हमारा परीक्षण कार्यक्रम webEndpoint नामक एक webEndpoint बकेट प्रॉपर्टी का निर्यात करता है, जो कि पूर्ण URL है जिस पर हम अनुकूलित index document प्राप्त कर सकते हैं। यद्यपि हम bucket खोजने के लिए स्टेटस फाइल में तल्लीन हो सकते हैं और इस संपत्ति को सीधे पढ़ सकते हैं, कई मामलों में, हमारे स्टैक उपयोगी गुण निर्यात करते हैं, जैसे कि यह हमारे लिए सुविधाजनक है:

 integration.ProgramTest(t, &integration.ProgramTestOptions{ // as before ... ExtraRuntimeValidation: func(t *testing.T, stack integration.RuntimeValidationStackInfo) { url := "http://" + stack.Outputs["websiteUrl"].(string) resp, err := http.Get(url) if !assert.NoError(t, err) { return } if !assert.Equal(t, 200, resp.StatusCode) { return } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if !assert.NoError(t, err) { return } assert.Contains(t, string(body), "Hello, Pulumi!") }, })

हमारे पिछले रनटाइम चेक की तरह, इस चेक को स्टैक को उठाने के तुरंत बाद किया जाएगा, और यह सब go test लिए एक साधारण कॉल के जवाब में किया जाएगा। और यह सिर्फ हिमशैल के टिप है - सभी गो परीक्षण विशेषताएं जो आप कोड में लिख सकते हैं वे उपलब्ध हैं।

सतत अवसंरचना एकीकरण

लैपटॉप पर परीक्षण चलाने में सक्षम होने के लिए अच्छा है जब कोड समीक्षा करने से पहले उन्हें परीक्षण करने के लिए बुनियादी ढांचे में बहुत सारे बदलाव किए जाते हैं। लेकिन हम और हमारे कई ग्राहक विकास जीवन चक्र के विभिन्न चरणों में बुनियादी ढांचे का परीक्षण कर रहे हैं:

प्रत्येक खुले पूल में विलय से पहले परीक्षण के लिए अनुरोध।
प्रत्येक कमिट के जवाब में, यह जांचने के लिए कि मर्ज सही तरीके से किया गया था।
समय-समय पर, उदाहरण के लिए, रात में या अतिरिक्त परीक्षण के लिए साप्ताहिक।
प्रदर्शन परीक्षण या तनाव परीक्षण के भाग के रूप में, जो आमतौर पर समय की एक लंबी अवधि में किए जाते हैं और समानांतर और / या एक ही कार्यक्रम को कई बार तैनात करते हैं।

उनमें से प्रत्येक के लिए, पुलुमी आपके पसंदीदा निरंतर एकीकरण प्रणाली के साथ एकीकरण का समर्थन करता है। निरंतर एकीकरण के साथ, यह आपको अपने बुनियादी ढांचे के लिए उसी तरह की कवरेज देता है जैसा कि एप्लिकेशन सॉफ़्टवेयर के लिए होता है।

पुलुमी के पास सामान्य सीआई सिस्टम के लिए समर्थन है। यहाँ उनमें से कुछ हैं:

अधिक जानकारी के लिए, कंटीन्यूअस डिलीवरी डॉक्यूमेंटेशन देखें।

पंचांग वातावरण

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

यदि आप GitHub का उपयोग कर रहे हैं, तो Pulumi GitHub ऐप प्रदान करता है , जो आपके CI पाइपलाइन के भीतर स्वीकृति परीक्षण को अनुरोधों के पूल से जोड़ने में मदद करेगा। बस GitHub रिपॉजिटरी में एप्लिकेशन इंस्टॉल करें, और पुलुमी आपके CI और अनुरोधों के पूल के बुनियादी ढांचे के पूर्वावलोकन, अपडेट और परीक्षण परिणामों के बारे में जानकारी जोड़ देगा:

अपने बुनियादी स्वीकृति परीक्षणों के लिए पुलुमी का उपयोग करते समय, आपके पास नई स्वचालन क्षमताएं होंगी जो टीम के प्रदर्शन में सुधार करेंगी और परिवर्तनों की गुणवत्ता में विश्वास दिलाएंगी।

परिणाम

इस लेख में, हमने देखा कि सामान्य प्रयोजन की प्रोग्रामिंग भाषाओं का उपयोग करते समय, कई सॉफ्टवेयर विकास विधियां जो हमारे अनुप्रयोगों को विकसित करने में उपयोगी थीं, वे हमारे लिए उपलब्ध हो जाती हैं। वे इकाई परीक्षण, एकीकरण परीक्षण, और व्यापक रनटाइम परीक्षण आयोजित करने के लिए उनकी बातचीत शामिल हैं। टेस्ट मांग पर या आपके CI सिस्टम में चलाना आसान है।

पुलुमी ओपन सोर्स सॉफ्टवेयर है, यह आपकी पसंदीदा प्रोग्रामिंग भाषाओं और बादलों के साथ उपयोग करने और काम करने के लिए स्वतंत्र है - इसे आज ही आजमाएँ !

→ पहला भाग

पुलुमी के साथ कोड के रूप में अपने बुनियादी ढांचे का परीक्षण। भाग २