🥇पुलुमी वापरून कोड म्हणून पायाभूत सुविधा चाचणी. भाग १

सर्वांना नमस्कार. आज आम्ही तुमच्यासोबत लेखाचा शेवटचा भाग शेअर करत आहोत. "पुलुमीसह कोड म्हणून पायाभूत सुविधांची चाचणी करणे", ज्याचे भाषांतर विशेषतः अभ्यासक्रमाच्या विद्यार्थ्यांसाठी तयार केले होते "DevOps सराव आणि साधने".

उपयोजन चाचणी

चाचणीची ही शैली एक शक्तिशाली दृष्टीकोन आहे आणि आम्हाला आमच्या पायाभूत सुविधा कोडच्या अंतर्गत कामकाजाची चाचणी घेण्यासाठी व्हाईट बॉक्स चाचणी करण्यास अनुमती देते. तथापि, आम्ही काय चाचणी करू शकतो हे काही प्रमाणात मर्यादित करते. वास्तविक तैनातीपूर्वी पुलुमीने तयार केलेल्या इन-मेमरी उपयोजन योजनेवर आधारित चाचण्या केल्या जातात आणि त्यामुळे तैनातीचीच चाचणी केली जाऊ शकत नाही. अशा प्रकरणांसाठी, पुलुमीकडे एकीकरण चाचणी फ्रेमवर्क आहे. आणि हे दोन दृष्टिकोन एकत्र चांगले काम करतात!

Pulumi इंटिग्रेशन चाचणी फ्रेमवर्क Go मध्ये लिहिलेले आहे, ज्याप्रमाणे आम्ही आमच्या अंतर्गत कोडची बहुतेक चाचणी करतो. पूर्वी चर्चा केलेला युनिट चाचणी दृष्टीकोन व्हाईट बॉक्स चाचणीसारखा होता, एकीकरण चाचणी ही ब्लॅक बॉक्स आहे. (कठोर अंतर्गत चाचणीसाठी पर्याय देखील आहेत.) हे फ्रेमवर्क पूर्ण पुलुमी प्रोग्राम घेण्यासाठी आणि त्यावर विविध जीवनचक्र ऑपरेशन्स करण्यासाठी तयार केले गेले होते, जसे की सुरवातीपासून नवीन स्टॅक तैनात करणे, भिन्नतेसह ते अद्यतनित करणे आणि ते हटवणे, शक्यतो अनेक वेळा. . आम्ही त्यांना नियमितपणे चालवतो (उदाहरणार्थ, रात्री) आणि तणाव चाचणी म्हणून.

(आम्ही आम्ही त्यावर काम करत आहोत, जेणेकरून समान एकीकरण चाचणी क्षमता भाषांच्या मूळ SDK मध्ये उपलब्ध आहेत. तुमचा पुलुमी प्रोग्राम कोणत्या भाषेत लिहिला गेला आहे याची पर्वा न करता तुम्ही गो इंटिग्रेशन चाचणी फ्रेमवर्क वापरू शकता).

या फ्रेमवर्कचा वापर करून प्रोग्राम चालवून तुम्ही खालील तपासू शकता:

तुमचा प्रोजेक्ट कोड सिंटॅक्टली बरोबर आहे आणि त्रुटींशिवाय चालतो.
स्टॅक आणि सिक्रेट्स कॉन्फिगरेशन सेटिंग्ज कार्य करतात आणि त्यांचा योग्य अर्थ लावला जातो.
तुमचा प्रकल्प तुमच्या आवडीच्या क्लाउड प्रदात्यामध्ये यशस्वीरित्या तैनात केला जाऊ शकतो.
तुमचा प्रकल्प सुरुवातीच्या स्थितीतून N इतर राज्यांमध्ये यशस्वीरित्या अपग्रेड केला जाऊ शकतो.
तुमचा प्रकल्प यशस्वीरित्या नष्ट केला जाऊ शकतो आणि तुमच्या क्लाउड प्रदात्याकडून काढला जाऊ शकतो.

जसे आपण लवकरच पाहणार आहोत, हे फ्रेमवर्क रनटाइम प्रमाणीकरण करण्यासाठी देखील वापरले जाऊ शकते.

साधी एकत्रीकरण चाचणी

हे कृतीत पाहण्यासाठी, आम्ही रेपॉजिटरी पाहू 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. उदाहरणार्थ, तुम्ही जेगर एंडपॉइंट ट्रेस करण्यासाठी कॉन्फिगर करू शकता (Tracingचाचणी नकारात्मक असल्यास चाचणी अयशस्वी होण्याची तुमची अपेक्षा असल्याचे सूचित करा (ExpectFailure), राज्यांच्या अनुक्रमिक संक्रमणासाठी प्रोग्राममध्ये "संपादने" ची मालिका लागू करा (EditDirs) आणि बरेच काही. तुमच्या ऍप्लिकेशन डिप्लॉयमेंटची चाचणी घेण्यासाठी त्यांचा वापर कसा करायचा ते पाहू.

संसाधन गुणधर्म तपासत आहे

वर चर्चा केलेले एकत्रीकरण हे सुनिश्चित करते की आमचा प्रोग्राम "कार्य करतो" - तो क्रॅश होत नाही. पण परिणामी स्टॅकचे गुणधर्म तपासायचे असतील तर? उदाहरणार्थ, विशिष्ट प्रकारच्या संसाधनांची तरतूद केली गेली आहे (किंवा नाही) आणि त्यांना विशिष्ट गुणधर्म आहेत.

पॅरामीटर ExtraRuntimeValidation ते ProgramTestOptions आम्हाला Pulumi द्वारे नोंदवलेली पोस्ट-डिप्लॉयमेंट स्थिती पाहण्याची अनुमती देते जेणेकरून आम्ही अतिरिक्त तपासणी करू शकतो. यामध्ये कॉन्फिगरेशन, निर्यात केलेली आउटपुट मूल्ये, सर्व संसाधने आणि त्यांची मालमत्ता मूल्ये आणि संसाधनांमधील सर्व अवलंबनांसह परिणामी स्टॅकच्या स्थितीचा संपूर्ण स्नॅपशॉट समाविष्ट आहे.

याचे मूळ उदाहरण पाहण्यासाठी, आपला प्रोग्राम तयार करतो का ते तपासू 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 बकेटमध्ये आपल्याला अपेक्षित असलेल्या गोष्टी आहेत आणि असेच.

हे कसे करायचे याचा अंदाज तुम्ही आधीच लावला असेल: पर्याय ExtraRuntimeValidation ते ProgramTestOptions - यासाठी ही एक उत्तम संधी आहे. या टप्प्यावर, तुम्ही तुमच्या प्रोग्रामच्या संसाधनांच्या संपूर्ण स्थितीत प्रवेशासह सानुकूल गो चाचणी चालवता. या स्थितीमध्ये व्हर्च्युअल मशीन IP पत्ते, URL आणि परिणामी क्लाउड ऍप्लिकेशन्स आणि पायाभूत सुविधांशी प्रत्यक्ष संवाद साधण्यासाठी आवश्यक असलेली प्रत्येक गोष्ट समाविष्ट आहे.

उदाहरणार्थ, आमचा चाचणी कार्यक्रम मालमत्ता निर्यात करतो webEndpoint बादली म्हणतात websiteUrl, जी पूर्ण 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. आणि हे फक्त हिमनगाचे टोक आहे—तुम्ही कोडमध्ये लिहू शकणारे प्रत्येक गो चाचणी वैशिष्ट्य उपलब्ध आहे.

सतत पायाभूत सुविधांचे एकत्रीकरण

लॅपटॉपवर चाचण्या चालवण्यास सक्षम असणे चांगले आहे जेव्हा कोड पुनरावलोकनासाठी सबमिट करण्यापूर्वी त्यांची चाचणी घेण्यासाठी पायाभूत सुविधांमध्ये बरेच बदल केले जातात. परंतु आम्ही आणि आमचे बरेच ग्राहक विकासाच्या जीवन चक्राच्या विविध टप्प्यांवर पायाभूत सुविधांची चाचणी घेतो:

विलीन करण्यापूर्वी चाचणीसाठी प्रत्येक खुल्या पुल विनंतीमध्ये.
प्रत्येक कमिटच्या प्रतिसादात, विलीनीकरण योग्यरित्या केले गेले आहे हे दोनदा तपासण्यासाठी.
कालांतराने, जसे की अतिरिक्त चाचणीसाठी रात्री किंवा साप्ताहिक.
कार्यप्रदर्शन किंवा तणाव चाचणीचा भाग म्हणून, जे सामान्यत: दीर्घ कालावधीसाठी चालते आणि समांतर चाचणी चालवते आणि/किंवा समान प्रोग्राम अनेक वेळा उपयोजित करते.

यापैकी प्रत्येकासाठी, Pulumi तुमच्या आवडत्या सतत एकीकरण प्रणालीसह एकत्रीकरणास समर्थन देते. सतत एकत्रीकरणासह, हे तुम्हाला तुमच्या इन्फ्रास्ट्रक्चरसाठी तुमच्या ऍप्लिकेशन सॉफ्टवेअरप्रमाणेच चाचणी कव्हरेज देते.

पुलुमीला सामान्य CI सिस्टीमसाठी समर्थन आहे. त्यापैकी काही येथे आहेत:

अधिक तपशीलवार माहितीसाठी, कृपया दस्तऐवजीकरण पहा सतत वितरण.

क्षणभंगुर वातावरण

एक अतिशय शक्तिशाली संधी जी उघडते ती म्हणजे केवळ स्वीकृती चाचणीच्या उद्देशांसाठी क्षणिक वातावरण तैनात करण्याची क्षमता. संकल्पना प्रकल्प आणि स्टॅक काही सोप्या CLI कमांडमध्ये किंवा इंटिग्रेशन टेस्टिंग फ्रेमवर्क वापरून, पूर्णपणे वेगळ्या आणि स्वतंत्र वातावरणात सहजपणे उपयोजित आणि नष्ट करण्यासाठी Pulumi डिझाइन केले आहे.

तुम्ही गिटहब वापरत असाल तर पुलुमी ऑफर करते GitHub अॅप, जे तुम्हाला तुमच्या CI पाइपलाइनमध्ये विनंत्या खेचण्यासाठी स्वीकृती चाचणी कनेक्ट करण्यात मदत करेल. GitHub रेपॉजिटरीमध्ये फक्त अॅप्लिकेशन इन्स्टॉल करा, आणि Pulumi तुमच्या CI आणि पूल विनंत्यांना इन्फ्रास्ट्रक्चर पूर्वावलोकन, अपडेट्स आणि चाचणी परिणामांबद्दल माहिती जोडेल:

जेव्हा तुम्ही तुमच्या मुख्य स्वीकृती चाचण्यांसाठी Pulumi वापरता, तेव्हा तुम्हाला नवीन ऑटोमेशन क्षमता प्राप्त होतील ज्यामुळे टीमची उत्पादकता सुधारेल आणि तुमच्या बदलांच्या गुणवत्तेवर तुम्हाला विश्वास मिळेल.

परिणाम

या लेखात, आम्ही पाहिले आहे की सामान्य उद्देश प्रोग्रामिंग भाषा वापरून, अनेक सॉफ्टवेअर डेव्हलपमेंट तंत्रे आमच्यासाठी उपलब्ध झाली आहेत जी आमचे ऍप्लिकेशन विकसित करण्यासाठी उपयुक्त आहेत. त्यामध्ये युनिट चाचणी, एकत्रीकरण चाचणी आणि विस्तृत रनटाइम चाचणी करण्यासाठी ते एकत्र कसे कार्य करतात याचा समावेश आहे. चाचण्या मागणीनुसार किंवा तुमच्या CI सिस्टीममध्ये चालवणे सोपे आहे.

पुलुमी - मुक्त स्रोत सॉफ्टवेअर, वापरण्यास विनामूल्य आणि तुमच्या आवडत्या प्रोग्रामिंग भाषा आणि क्लाउडसह कार्य करते - आज प्रयत्न करा!

→ पहिला भाग

स्त्रोत: www.habr.com

पुलुमीसह कोड म्हणून पायाभूत सुविधांची चाचणी करणे. भाग 2