अमृत ​​परियोजनाओं के लिए GitHub CI का उपयोग करना

अक्टूबर में, Github ने कार्रवाई शुरू की जो आपको कैश डेस्क को छोड़ने के बिना सीआई को निष्पादित करने की अनुमति देती है जिसमें यह कोड संग्रहीत है। यह वास्तव में बहुत सुविधाजनक है। जैसे ही कोई व्यक्ति पुल अनुरोध भेजता है, या बस सर्वर में नए परिवर्तन अपलोड करता है, या कुछ और विशेष (उन घटनाओं की एक सूची, जिन्हें कार्रवाई को तेज किया जा सकता है, आधिकारिक दस्तावेज में पाया जा सकता है), असेंबली शुरू होती है। अनुसूचित आवर्ती कार्य ( क्रोन-आधारित ) भी समर्थित हैं।

आप वर्कफ्लो नामक एक्शन पाइपलाइन बना सकते हैं। और यह सब सुंदर है, और एक उज्ज्वल भविष्य की तरह दिखता है - प्रलेखन के अपवाद के साथ।

आवेदन का परीक्षण करने के लिए तीसरे पक्ष की सेवाओं के साथ एक कंटेनर बनाने का तरीका जानने के लिए मुझे एक घंटे से अधिक समय लगा। यहाँ मैं क्या पता लगाने में कामयाब रहा। कृपया ध्यान दें कि आधिकारिक दस्तावेज स्पष्ट रूप से अजीब, अधूरा है, और अक्सर बस गलत है।

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

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

यहाँ एक अमृत परियोजना के लिए एक कार्यशील विन्यास उदाहरण है जिसे परीक्षण करने के लिए RabbitMQ और Redis सेवाओं की आवश्यकता है।

 name: Tests for My Project on: [push, pull_request] jobs: build: runs-on: ubuntu-latest container: image: elixir:1.9.1-slim services: rabbitmq: image: rabbitmq ports: - 5672:5672 env: RABBITMQ_USER: guest RABBITMQ_PASSWORD: guest RABBITMQ_VHOST: "/" redis: image: redis ports: - 6379:6379 steps: - uses: actions/checkout@v1 - name: Install Dependencies run: | MIX_ENV=ci mix local.rebar --force MIX_ENV=ci mix local.hex --force MIX_ENV=ci mix deps.get - name: Run All Tests run: | MIX_ENV=ci mix test env: RABBITMQ_HOST: rabbitmq RABBITMQ_PORT: ${{ job.services.rabbitmq.ports[5672] }} REDIS_HOST: redis REDIS_PORT: ${{ job.services.redis.ports[6379] }} 

जैसा कि आप देख सकते हैं, परीक्षण यूनिक्स अमृत v1.9.1 का उपयोग करके उबंटू पर चलेंगे । सेवाओं को मुख्य सेवाओं के तहत वर्णित किया गया है, और यहां एक शुद्ध जासूसी कहानी शुरू होती है। जिस भौतिक पोर्ट पर सर्विस पोर्ट बाउंड किया जाएगा, उसे कंटेनर इंजन द्वारा बेतरतीब ढंग से रन टाइम पर चुना जाता है और job.services.rabbitmq.ports[5672] नामक एक आंतरिक शेल चर में संग्रहीत किया जाता है। rabbitmq सेवा का नाम है, जैसा कि सेवा खंड में इस फ़ाइल में दर्शाया गया है, और 5672 स्रोत पोर्ट है। आंतरिक चर में वाक्य रचना $ {{foo}} है और इसे पर्यावरण चर RABBITMQ_PORT (अंतिम सेटिंग ब्लॉक, कुंजी env तहत) में पारित किया गया है। RABBITMQ_HOST - आपको सेवा का नाम रखना होगा, जैसे सेवाओं की कुंजी के नीचे। अब एप्लिकेशन हमेशा की तरह पर्यावरण चर पढ़ सकता है और बंदरगाहों को सही ढंग से स्क्रॉल किया जाएगा।

यह हम पर्यावरण से इन पर्यावरण चर को पढ़ेंगे (यह अमृत ​​के लिए एक विन्यास है, अन्य भाषाओं के लिए भी कुछ ऐसा ही होगा)।

 import Config config :my_app, rabbitmq: [ host: System.get_env("RABBITMQ_HOST"), password: "guest", port: String.to_integer(System.get_env("RABBITMQ_PORT", "5672")), username: "guest", virtual_host: "/", x_message_ttl: "4000" ] 

प्रोजेक्ट फ़ाइल में, मैं एक विशेष वातावरण बनाता हूं :ci स्थानीय वातावरण में किए गए परीक्षणों के लिए कॉन्फ़िगरेशन के बीच अंतर करने के लिए :ci , और समान परीक्षणों के लिए क्लाउड में कहीं बाहर प्रदर्शन किया।

इसके अलावा, CI पाइपलाइन में, मैं अपने स्रोतों पर dialyzer चलाता हूं। चूंकि यह कंटेनर में चलता है, इसलिए कार्य में कुछ समय लगता है, क्योंकि आपको हर बार खरोंच से plts का पुनर्निर्माण करना plts है। यही कारण है कि मैं schedule कॉन्फ़िगरेशन विकल्प का उपयोग करके दिन में एक बार ऐसा करता हूं।

 name: Dialyzer for My Project on: schedule: - cron: "0 1 * * *" jobs: build: runs-on: ubuntu-latest container: image: elixir:1.9.1-slim steps: - uses: actions/checkout@v1 - name: Install Dependencies run: | MIX_ENV=ci mix local.rebar --force MIX_ENV=ci mix local.hex --force MIX_ENV=ci mix deps.get - name: Run All Tests run: | MIX_ENV=ci mix code_quality 

यहाँ code_quality में घोषित एक कार्य उपनाम है

 defp aliases do [ code_quality: ["format", "credo --strict", "dialyzer"] ] end 

यहाँ, सामान्य तौर पर, हम सभी को नए Github वर्कफ़्लो में बाहरी निर्भरता वाली परियोजना के सुखद परीक्षण के लिए आवश्यक है।

सफल निरंतर एकीकरण!