ক্রমাগত একীকরণের জন্য ডকারে মাইক্রোসার্ভিসের স্বয়ংক্রিয় পরীক্ষা

মাইক্রোসার্ভিস আর্কিটেকচারের উন্নয়ন সম্পর্কিত প্রকল্পগুলিতে, CI/CD একটি আনন্দদায়ক সুযোগের বিভাগ থেকে একটি জরুরি প্রয়োজনের বিভাগে চলে যায়। স্বয়ংক্রিয় পরীক্ষা ক্রমাগত একীকরণের একটি অবিচ্ছেদ্য অংশ, একটি উপযুক্ত পদ্ধতি যা দলকে পরিবার এবং বন্ধুদের সাথে অনেক আনন্দদায়ক সন্ধ্যা দিতে পারে। অন্যথায়, প্রকল্পটি কখনই শেষ না হওয়ার ঝুঁকি রয়েছে।

সম্পূর্ণ মাইক্রোসার্ভিস কোডটি মক অবজেক্টের সাথে ইউনিট টেস্টের মাধ্যমে কভার করা সম্ভব, কিন্তু এটি শুধুমাত্র আংশিকভাবে সমস্যার সমাধান করে এবং অনেক প্রশ্ন এবং অসুবিধা ছেড়ে দেয়, বিশেষ করে যখন ডেটা দিয়ে কাজ পরীক্ষা করা হয়। বরাবরের মতো, সবচেয়ে চাপের বিষয়গুলি হল একটি রিলেশনাল ডাটাবেসে ডেটা সামঞ্জস্য পরীক্ষা করা, ক্লাউড পরিষেবাগুলির সাথে কাজ পরীক্ষা করা এবং উপহাস বস্তুগুলি লেখার সময় ভুল অনুমান করা৷

একটি ডকার পাত্রে সম্পূর্ণ মাইক্রোসার্ভিস পরীক্ষা করে এই সব এবং আরও কিছু সমাধান করা যেতে পারে। পরীক্ষার বৈধতা নিশ্চিত করার জন্য একটি নিঃসন্দেহে সুবিধা হল যে একই ডকার ইমেজগুলি যা উৎপাদনে যায় পরীক্ষা করা হয়।

এই পদ্ধতির অটোমেশন বেশ কয়েকটি সমস্যা উপস্থাপন করে, যার সমাধান নীচে বর্ণনা করা হবে:

• একই ডকার হোস্টে সমান্তরাল কাজের দ্বন্দ্ব;
• পরীক্ষার পুনরাবৃত্তির সময় ডাটাবেসে শনাক্তকারীর দ্বন্দ্ব;
• মাইক্রোসার্ভিস প্রস্তুত হওয়ার জন্য অপেক্ষা করা;
• বহিরাগত সিস্টেমে লগ একত্রিত করা এবং আউটপুট করা;
• বহির্গামী HTTP অনুরোধ পরীক্ষা করা;
• ওয়েব সকেট পরীক্ষা (সিগন্যালআর ব্যবহার করে);
• OAuth প্রমাণীকরণ এবং অনুমোদন পরীক্ষা করা হচ্ছে।

এই নিবন্ধটি উপর ভিত্তি করে আমার বক্তৃতা SECR 2019 এ। তাই যারা পড়তে খুব অলস, তাদের জন্য এখানে বক্তৃতা একটি রেকর্ডিং আছে.

এই প্রবন্ধে আমি আপনাকে বলব যে কীভাবে একটি স্ক্রিপ্ট ব্যবহার করে পরীক্ষার অধীনে পরিষেবা চালানো যায়, একটি ডাটাবেস এবং ডকারে অ্যামাজন AWS পরিষেবাগুলি, তারপরে পোস্টম্যানের উপর পরীক্ষা করা হয় এবং সেগুলি সম্পন্ন হওয়ার পরে, তৈরি কন্টেইনারগুলি বন্ধ করে এবং মুছে ফেলতে হয়। প্রতিবার কোড পরিবর্তিত হলে পরীক্ষা চালানো হয়। এইভাবে, আমরা নিশ্চিত করি যে প্রতিটি সংস্করণ AWS ডাটাবেস এবং পরিষেবাগুলির সাথে সঠিকভাবে কাজ করে।

একই স্ক্রিপ্ট বিকাশকারীরা তাদের উইন্ডোজ ডেস্কটপে এবং লিনাক্সের অধীনে গিটল্যাব সিআই সার্ভার দ্বারা উভয়ই চালায়।

ন্যায়সঙ্গত হওয়ার জন্য, নতুন পরীক্ষা প্রবর্তনের জন্য বিকাশকারীর কম্পিউটারে বা সার্ভারে যেখানে পরীক্ষাগুলি একটি প্রতিশ্রুতিতে চালানো হয় সেখানে অতিরিক্ত সরঞ্জাম ইনস্টল করার প্রয়োজন হবে না৷ ডকার এই সমস্যার সমাধান করে৷

নিম্নলিখিত কারণগুলির জন্য একটি স্থানীয় সার্ভারে পরীক্ষা চালানো আবশ্যক:

• নেটওয়ার্ক কখনই সম্পূর্ণ নির্ভরযোগ্য নয়। এক হাজার অনুরোধের মধ্যে, একটি ব্যর্থ হতে পারে;
  এই ক্ষেত্রে, স্বয়ংক্রিয় পরীক্ষা কাজ করবে না, কাজ বন্ধ হয়ে যাবে, এবং আপনাকে লগগুলিতে কারণটি সন্ধান করতে হবে;
• কিছু তৃতীয় পক্ষের পরিষেবা দ্বারা খুব ঘন ঘন অনুরোধ অনুমোদিত নয়।

উপরন্তু, স্ট্যান্ড ব্যবহার করা অবাঞ্ছিত কারণ:

• একটি স্ট্যান্ড শুধুমাত্র খারাপ কোডের মাধ্যমেই ভাঙা যায় না, কিন্তু সঠিক কোডটি প্রসেস করতে পারে না এমন ডেটা দ্বারাও;
• আমরা পরীক্ষা চলাকালীন পরীক্ষার দ্বারা করা সমস্ত পরিবর্তনগুলিকে ফিরিয়ে আনার যতই চেষ্টা করি না কেন, কিছু ভুল হতে পারে (অন্যথায়, কেন পরীক্ষা?)।

প্রকল্প এবং প্রক্রিয়া সংগঠন সম্পর্কে

আমাদের কোম্পানি Amazon AWS ক্লাউডে ডকারে চলমান একটি মাইক্রোসার্ভিস ওয়েব অ্যাপ্লিকেশন তৈরি করেছে। ইউনিট পরীক্ষাগুলি ইতিমধ্যে প্রকল্পে ব্যবহার করা হয়েছিল, কিন্তু প্রায়শই ত্রুটিগুলি ঘটেছে যা ইউনিট পরীক্ষাগুলি সনাক্ত করতে পারেনি৷ ডাটাবেস এবং অ্যামাজন পরিষেবাগুলির সাথে একটি সম্পূর্ণ মাইক্রোসার্ভিস পরীক্ষা করা প্রয়োজন ছিল।

প্রকল্পটি একটি স্ট্যান্ডার্ড ক্রমাগত ইন্টিগ্রেশন প্রক্রিয়া ব্যবহার করে, যার মধ্যে রয়েছে প্রতিটি কমিটের সাথে মাইক্রোসার্ভিস পরীক্ষা করা। একটি টাস্ক বরাদ্দ করার পরে, বিকাশকারী মাইক্রোসার্ভিসে পরিবর্তন করে, এটি ম্যানুয়ালি পরীক্ষা করে এবং সমস্ত উপলব্ধ স্বয়ংক্রিয় পরীক্ষা চালায়। প্রয়োজনে, বিকাশকারী পরীক্ষাগুলি পরিবর্তন করে। যদি কোন সমস্যা না পাওয়া যায়, তাহলে এই সমস্যার শাখায় একটি প্রতিশ্রুতি দেওয়া হয়। প্রতিটি কমিটের পরে, পরীক্ষাগুলি স্বয়ংক্রিয়ভাবে সার্ভারে চালানো হয়। একটি সাধারণ শাখায় একত্রিত হওয়া এবং এটিতে স্বয়ংক্রিয় পরীক্ষা চালু করা একটি সফল পর্যালোচনার পরে ঘটে। শেয়ার্ড ব্রাঞ্চের পরীক্ষাগুলো পাস করলে, অ্যামাজন ইলাস্টিক কন্টেইনার সার্ভিসে (বেঞ্চ) পরীক্ষার পরিবেশে পরিষেবা স্বয়ংক্রিয়ভাবে আপডেট হয়ে যায়। স্ট্যান্ডটি সমস্ত বিকাশকারী এবং পরীক্ষকদের জন্য প্রয়োজনীয় এবং এটি ভাঙ্গার পরামর্শ দেওয়া হয় না। এই পরিবেশে পরীক্ষকরা ম্যানুয়াল পরীক্ষা করে একটি ফিক্স বা একটি নতুন বৈশিষ্ট্য পরীক্ষা করে।

প্রকল্পের আর্কিটেকচার

অ্যাপ্লিকেশনটি দশটিরও বেশি পরিষেবা নিয়ে গঠিত। এর মধ্যে কিছু .NET কোরে এবং কিছু NodeJ-এ লেখা আছে। প্রতিটি পরিষেবা অ্যামাজন ইলাস্টিক কন্টেইনার পরিষেবাতে একটি ডকার কন্টেইনারে চলে। প্রত্যেকের নিজস্ব Postgres ডাটাবেস আছে, এবং কিছু রেডিস আছে। কোন সাধারণ ডাটাবেস নেই. যদি বেশ কয়েকটি পরিষেবার একই ডেটার প্রয়োজন হয়, তবে এই ডেটা, যখন এটি পরিবর্তিত হয়, এসএনএস (সিম্পল নোটিফিকেশন সার্ভিস) এবং এসকিউএস (অ্যামাজন সিম্পল কিউ সার্ভিস) এর মাধ্যমে এই প্রতিটি পরিষেবাতে প্রেরণ করা হয় এবং পরিষেবাগুলি তাদের নিজস্ব পৃথক ডেটাবেসে সংরক্ষণ করে।

SQS এবং SNS

SQS আপনাকে বার্তাগুলিকে একটি সারিতে রাখতে এবং HTTPS প্রোটোকল ব্যবহার করে সারি থেকে বার্তা পড়তে দেয়৷

যদি বেশ কয়েকটি পরিষেবা একটি সারি পড়ে, তবে প্রতিটি বার্তা কেবল তাদের মধ্যে একজনের কাছে আসে। তাদের মধ্যে লোড বিতরণ করার জন্য একই পরিষেবার বেশ কয়েকটি উদাহরণ চালানোর সময় এটি কার্যকর।

আপনি যদি প্রতিটি বার্তা একাধিক পরিষেবাতে বিতরণ করতে চান তবে প্রতিটি প্রাপকের নিজস্ব সারি থাকতে হবে এবং একাধিক সারিতে বার্তাগুলিকে নকল করতে SNS প্রয়োজন৷

SNS-এ আপনি একটি বিষয় তৈরি করেন এবং এতে সদস্যতা নেন, উদাহরণস্বরূপ, একটি SQS সারি। আপনি বিষয় বার্তা পাঠাতে পারেন. এই ক্ষেত্রে, এই বিষয়ে সাবস্ক্রাইব করা প্রতিটি সারিতে বার্তা পাঠানো হয়। বার্তা পড়ার জন্য SNS এর কোনো পদ্ধতি নেই। যদি ডিবাগিং বা পরীক্ষার সময় আপনাকে SNS-এ কী পাঠানো হয় তা খুঁজে বের করতে হয়, আপনি একটি SQS সারি তৈরি করতে পারেন, এটি পছন্দসই বিষয়ে সদস্যতা নিতে পারেন এবং সারিটি পড়তে পারেন।

API গেটওয়ে

বেশিরভাগ পরিষেবা ইন্টারনেট থেকে সরাসরি অ্যাক্সেসযোগ্য নয়। অ্যাক্সেস API গেটওয়ের মাধ্যমে হয়, যা অ্যাক্সেসের অধিকার পরীক্ষা করে। এটিও আমাদের পরিষেবা, এবং এটির জন্যও পরীক্ষা রয়েছে৷

রিয়েল-টাইম বিজ্ঞপ্তি

অ্যাপ্লিকেশন ব্যবহার করে সংকেত আরব্যবহারকারীকে রিয়েল-টাইম বিজ্ঞপ্তি দেখানোর জন্য। এটি বিজ্ঞপ্তি পরিষেবাতে প্রয়োগ করা হয়। এটি সরাসরি ইন্টারনেট থেকে অ্যাক্সেসযোগ্য এবং নিজেই OAuth-এর সাথে কাজ করে, কারণ এটি OAuth এবং বিজ্ঞপ্তি পরিষেবাকে একীভূত করার তুলনায় গেটওয়েতে ওয়েব সকেটের জন্য সমর্থন তৈরি করা অব্যবহারিক বলে প্রমাণিত হয়েছে।

সুপরিচিত পরীক্ষার পদ্ধতি

ইউনিট পরীক্ষাগুলি ডাটাবেসের মতো জিনিসগুলিকে মক অবজেক্ট দিয়ে প্রতিস্থাপন করে। যদি একটি মাইক্রোসার্ভিস, উদাহরণস্বরূপ, একটি বিদেশী কী সহ একটি টেবিলে একটি রেকর্ড তৈরি করার চেষ্টা করে এবং সেই কী দ্বারা উল্লেখ করা রেকর্ডটি বিদ্যমান না থাকে, তাহলে অনুরোধটি সম্পূর্ণ করা যাবে না। ইউনিট পরীক্ষা এটি সনাক্ত করতে পারে না.

В মাইক্রোসফ্ট থেকে নিবন্ধ এটি একটি ইন-মেমরি ডাটাবেস ব্যবহার করার এবং মক অবজেক্টগুলি বাস্তবায়নের প্রস্তাব করা হয়েছে।

ইন-মেমরি ডাটাবেস হল একটি ডিবিএমএস যা এন্টিটি ফ্রেমওয়ার্ক দ্বারা সমর্থিত। এটি পরীক্ষার জন্য বিশেষভাবে তৈরি করা হয়েছিল। এই ধরনের একটি ডাটাবেসে ডেটা সংরক্ষণ করা হয় যতক্ষণ না এটি ব্যবহার করে প্রক্রিয়াটি শেষ হয়। এটি টেবিল তৈরির প্রয়োজন হয় না এবং ডেটা অখণ্ডতা পরীক্ষা করে না।

মক অবজেক্টগুলি যে ক্লাসটি প্রতিস্থাপন করছে তা কেবলমাত্র পরীক্ষার বিকাশকারী বুঝতে পারে যে এটি কীভাবে কাজ করে তা মডেল করে।

যখন আপনি একটি পরীক্ষা চালান তখন পোস্টগ্রেস স্বয়ংক্রিয়ভাবে শুরু করতে এবং মাইগ্রেশন করার জন্য কীভাবে পাবেন তা Microsoft নিবন্ধে নির্দিষ্ট করা নেই। আমার সমাধান এটি করে এবং উপরন্তু, মাইক্রোসার্ভিসে নিজেই পরীক্ষার জন্য বিশেষভাবে কোনো কোড যোগ করে না।

এর সমাধানের দিকে এগিয়ে যাওয়া যাক

উন্নয়ন প্রক্রিয়া চলাকালীন, এটি স্পষ্ট হয়ে ওঠে যে ইউনিট পরীক্ষাগুলি সময়মত সমস্ত সমস্যাগুলি খুঁজে বের করার জন্য যথেষ্ট নয়, তাই এটি একটি ভিন্ন কোণ থেকে এই সমস্যাটির সাথে যোগাযোগ করার সিদ্ধান্ত নেওয়া হয়েছিল।

একটি পরীক্ষার পরিবেশ স্থাপন করা হচ্ছে

প্রথম কাজ হল একটি পরীক্ষার পরিবেশ স্থাপন করা। একটি মাইক্রোসার্ভিস চালানোর জন্য প্রয়োজনীয় পদক্ষেপগুলি:

• স্থানীয় পরিবেশের জন্য পরীক্ষার অধীনে পরিষেবাটি কনফিগার করুন, পরিবেশের ভেরিয়েবলগুলিতে ডাটাবেস এবং AWS-এর সাথে সংযোগের জন্য বিশদ উল্লেখ করুন;
• Postgres শুরু করুন এবং Liquibase চালানোর মাধ্যমে মাইগ্রেশন সম্পাদন করুন।
  রিলেশনাল ডিবিএমএস-এ, ডাটাবেসে ডেটা লেখার আগে, আপনাকে একটি ডেটা স্কিমা তৈরি করতে হবে, অন্য কথায়, টেবিল। একটি অ্যাপ্লিকেশন আপডেট করার সময়, টেবিলগুলিকে অবশ্যই নতুন সংস্করণ দ্বারা ব্যবহৃত ফর্মে আনতে হবে এবং, বিশেষত, ডেটা হারানো ছাড়াই৷ একে অভিবাসন বলে। প্রাথমিকভাবে খালি ডাটাবেসে টেবিল তৈরি করা মাইগ্রেশনের একটি বিশেষ ক্ষেত্রে। মাইগ্রেশন অ্যাপ্লিকেশন নিজেই তৈরি করা যেতে পারে. .NET এবং NodeJS উভয়েরই মাইগ্রেশন ফ্রেমওয়ার্ক রয়েছে। আমাদের ক্ষেত্রে, নিরাপত্তার কারণে, মাইক্রোসার্ভিসগুলি ডেটা স্কিমা পরিবর্তন করার অধিকার থেকে বঞ্চিত হয় এবং Liquibase ব্যবহার করে মাইগ্রেশন করা হয়।
• অ্যামাজন লোকালস্ট্যাক চালু করুন। এটি বাড়িতে চালানোর জন্য AWS পরিষেবাগুলির একটি বাস্তবায়ন৷ Docker Hub-এ LocalStack-এর জন্য একটি রেডিমেড ইমেজ আছে।
• LocalStack এ প্রয়োজনীয় সত্তা তৈরি করতে স্ক্রিপ্টটি চালান। শেল স্ক্রিপ্ট AWS CLI ব্যবহার করে।

প্রকল্পে পরীক্ষার জন্য ব্যবহৃত পিয়ন. এটি আগে বিদ্যমান ছিল, তবে এটি ম্যানুয়ালি চালু করা হয়েছিল এবং স্ট্যান্ডে ইতিমধ্যেই স্থাপন করা একটি অ্যাপ্লিকেশন পরীক্ষা করা হয়েছিল। এই টুলটি আপনাকে নির্বিচারে HTTP(S) অনুরোধ করতে এবং প্রতিক্রিয়াগুলি প্রত্যাশার সাথে মেলে কিনা তা পরীক্ষা করার অনুমতি দেয়। ক্যোয়ারীগুলিকে একটি সংগ্রহে একত্রিত করা হয় এবং সম্পূর্ণ সংগ্রহ চালানো যেতে পারে।

কিভাবে স্বয়ংক্রিয় পরীক্ষা কাজ করে?

পরীক্ষার সময়, সবকিছু ডকারে কাজ করে: পরীক্ষার অধীনে পরিষেবা, পোস্টগ্রেস, মাইগ্রেশন টুল এবং পোস্টম্যান, বা বরং এর কনসোল সংস্করণ - নিউম্যান।

ডকার বেশ কয়েকটি সমস্যার সমাধান করে:

• হোস্ট কনফিগারেশন থেকে স্বাধীনতা;
• নির্ভরতা ইনস্টল করা: ডকার ডকার হাব থেকে ছবি ডাউনলোড করে;
• সিস্টেমটিকে তার আসল অবস্থায় ফিরিয়ে দেওয়া: কেবল পাত্রগুলি সরানো হচ্ছে।

ডকার-কম্পোজ কন্টেইনারগুলিকে একটি ভার্চুয়াল নেটওয়ার্কে একত্রিত করে, ইন্টারনেট থেকে বিচ্ছিন্ন, যেখানে কন্টেইনারগুলি ডোমেন নাম দ্বারা একে অপরকে খুঁজে পায়।

পরীক্ষাটি একটি শেল স্ক্রিপ্ট দ্বারা নিয়ন্ত্রিত হয়। উইন্ডোজে পরীক্ষা চালানোর জন্য আমরা গিট-ব্যাশ ব্যবহার করি। সুতরাং, উইন্ডোজ এবং লিনাক্স উভয়ের জন্য একটি স্ক্রিপ্টই যথেষ্ট। গিট এবং ডকার প্রকল্পের সমস্ত বিকাশকারী দ্বারা ইনস্টল করা হয়। উইন্ডোজে গিট ইনস্টল করার সময়, গিট-ব্যাশ ইনস্টল করা হয়, তাই প্রত্যেকের কাছে এটিও রয়েছে।

স্ক্রিপ্ট নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করে:

• বিল্ডিং ডকার ইমেজ

  docker-compose build

• ডাটাবেস এবং লোকালস্ট্যাক চালু করা হচ্ছে

  docker-compose up -d <контейнер>

• ডাটাবেস স্থানান্তর এবং লোকালস্ট্যাকের প্রস্তুতি

  docker-compose run <контейнер>

• পরীক্ষার অধীনে পরিষেবা চালু করা হচ্ছে

  docker-compose up -d <сервис>

• পরীক্ষা চলছে (নিউম্যান)
• সব কন্টেইনার বন্ধ করা হচ্ছে

  docker-compose down

• Slack ফলাফল পোস্ট করা
  আমাদের একটি চ্যাট আছে যেখানে একটি সবুজ চেকমার্ক বা একটি লাল ক্রস এবং লগের একটি লিঙ্ক সহ বার্তাগুলি যায়৷

নিম্নলিখিত ডকার চিত্রগুলি এই পদক্ষেপগুলির সাথে জড়িত:

• পরিষেবাটি পরীক্ষা করা হচ্ছে উত্পাদনের জন্য একই চিত্র। পরীক্ষার জন্য কনফিগারেশন পরিবেশের ভেরিয়েবলের মাধ্যমে হয়।
• পোস্টগ্রেস, রেডিস এবং লোকালস্ট্যাকের জন্য, ডকার হাব থেকে তৈরি করা ছবিগুলি ব্যবহার করা হয়। লিকুইবেস এবং নিউম্যানের জন্য প্রস্তুত-তৈরি ছবিও রয়েছে। আমরা তাদের কঙ্কালের উপর আমাদের তৈরি করি, সেখানে আমাদের ফাইল যোগ করি।
• LocalStack প্রস্তুত করতে, আপনি একটি রেডিমেড AWS CLI ইমেজ ব্যবহার করুন এবং এর উপর ভিত্তি করে একটি স্ক্রিপ্ট সহ একটি ইমেজ তৈরি করুন।

ব্যবহার ভলিউম, শুধুমাত্র ধারকটিতে ফাইল যোগ করার জন্য আপনাকে একটি ডকার ইমেজ তৈরি করতে হবে না। যাইহোক, ভলিউমগুলি আমাদের পরিবেশের জন্য উপযুক্ত নয় কারণ গিটল্যাব সিআই কাজগুলি নিজেই পাত্রে চলে। আপনি এই ধরনের একটি ধারক থেকে Docker নিয়ন্ত্রণ করতে পারেন, কিন্তু ভলিউম শুধুমাত্র হোস্ট সিস্টেম থেকে ফোল্ডার মাউন্ট, এবং অন্য ধারক থেকে নয়।

আপনি সম্মুখীন হতে পারে সমস্যা

প্রস্তুতির অপেক্ষায়

যখন একটি পরিষেবা সহ একটি ধারক চলছে, এর অর্থ এই নয় যে এটি সংযোগগুলি গ্রহণ করতে প্রস্তুত৷ সংযোগটি চালিয়ে যাওয়ার জন্য আপনাকে অবশ্যই অপেক্ষা করতে হবে।

এই সমস্যাটি কখনও কখনও একটি স্ক্রিপ্ট ব্যবহার করে সমাধান করা হয় অপেক্ষা করুন, যা একটি TCP সংযোগ স্থাপনের সুযোগের জন্য অপেক্ষা করে। যাইহোক, LocalStack একটি 502 খারাপ গেটওয়ে ত্রুটি নিক্ষেপ করতে পারে। এছাড়াও, এটিতে অনেকগুলি পরিষেবা রয়েছে এবং যদি তাদের মধ্যে একটি প্রস্তুত থাকে তবে এটি অন্যদের সম্পর্কে কিছু বলে না।

রায়: LocalStack প্রভিশনিং স্ক্রিপ্ট যা SQS এবং SNS উভয়ের কাছ থেকে 200 প্রতিক্রিয়ার জন্য অপেক্ষা করে।

সমান্তরাল টাস্ক দ্বন্দ্ব

একাধিক পরীক্ষা একই ডকার হোস্টে একসাথে চলতে পারে, তাই ধারক এবং নেটওয়ার্কের নাম অবশ্যই অনন্য হতে হবে। তদুপরি, একই পরিষেবার বিভিন্ন শাখা থেকে পরীক্ষাগুলি একই সাথে চলতে পারে, তাই প্রতিটি রচনা ফাইলে তাদের নাম লেখা যথেষ্ট নয়।

রায়: স্ক্রিপ্টটি COMPOSE_PROJECT_NAME ভেরিয়েবলটিকে একটি অনন্য মান সেট করে।

উইন্ডোজ বৈশিষ্ট্য

উইন্ডোজে ডকার ব্যবহার করার সময় আমি অনেকগুলি জিনিস নির্দেশ করতে চাই, কারণ এই অভিজ্ঞতাগুলি কেন ত্রুটি ঘটে তা বোঝার জন্য গুরুত্বপূর্ণ।

1. একটি পাত্রে শেল স্ক্রিপ্টের লিনাক্স লাইনের শেষ থাকা আবশ্যক।
   শেল CR প্রতীক একটি সিনট্যাক্স ত্রুটি। ত্রুটি বার্তা থেকে বলা কঠিন যে এটি এমন। উইন্ডোজে এই ধরনের স্ক্রিপ্ট সম্পাদনা করার সময়, আপনার একটি সঠিক পাঠ্য সম্পাদক প্রয়োজন। উপরন্তু, সংস্করণ নিয়ন্ত্রণ সিস্টেম সঠিকভাবে কনফিগার করা আবশ্যক.

এইভাবে গিট কনফিগার করা হয়:

git config core.autocrlf input

1. গিট-ব্যাশ স্ট্যান্ডার্ড লিনাক্স ফোল্ডারগুলিকে অনুকরণ করে এবং যখন একটি exe ফাইলে কল করা হয় (docker.exe সহ), তখন সম্পূর্ণ Linux পাথগুলিকে Windows পাথগুলির সাথে প্রতিস্থাপন করে৷ যাইহোক, স্থানীয় মেশিনে (অথবা একটি পাত্রে পাথ) নয় এমন পাথগুলির জন্য এটি অর্থপূর্ণ নয়। এই আচরণ অক্ষম করা যাবে না.

রায়: পাথের শুরুতে একটি অতিরিক্ত স্ল্যাশ যোগ করুন: /bin এর পরিবর্তে //bin। লিনাক্স এই ধরনের পথ বোঝে; এর জন্য, বেশ কয়েকটি স্ল্যাশ একের মতো। কিন্তু git-bash এই ধরনের পথ চিনতে পারে না এবং তাদের রূপান্তর করার চেষ্টা করে না।

লগ আউটপুট

পরীক্ষা চালানোর সময়, আমি নিউম্যান এবং পরিষেবা পরীক্ষা করা উভয়ের লগ দেখতে চাই। যেহেতু এই লগগুলির ঘটনাগুলি আন্তঃসংযুক্ত, সেগুলিকে একটি কনসোলে একত্রিত করা দুটি পৃথক ফাইলের চেয়ে অনেক বেশি সুবিধাজনক। নিউম্যান এর মাধ্যমে লঞ্চ করে ডকার-কম্পোজ রান, এবং তাই এর আউটপুট কনসোলে শেষ হয়। যা অবশিষ্ট থাকে তা নিশ্চিত করা যে পরিষেবাটির আউটপুটও সেখানে যায়।

মূল সমাধান করতে হবে ডকার-আপ রচনা পতাকা নেই -d, কিন্তু শেল ক্ষমতা ব্যবহার করে, এই প্রক্রিয়াটিকে পটভূমিতে পাঠান:

docker-compose up <service> &

ডকার থেকে তৃতীয় পক্ষের পরিষেবাতে লগ পাঠানোর প্রয়োজন না হওয়া পর্যন্ত এটি কাজ করে। ডকার-আপ রচনা কনসোলে লগ আউটপুট করা বন্ধ করে দিয়েছে। তবে দল কাজ করেছে ডকার সংযুক্ত.

রায়:

docker attach --no-stdin ${COMPOSE_PROJECT_NAME}_<сервис>_1 &

পরীক্ষার পুনরাবৃত্তির সময় শনাক্তকারীর দ্বন্দ্ব

পরীক্ষাগুলি বিভিন্ন পুনরাবৃত্তিতে চালানো হয়। ডাটাবেস সাফ করা হয় না. ডাটাবেসের রেকর্ডে অনন্য আইডি থাকে। যদি আমরা অনুরোধে নির্দিষ্ট আইডি লিখে রাখি, আমরা দ্বিতীয় পুনরাবৃত্তিতে একটি দ্বন্দ্ব পাব।

এটি এড়াতে, হয় আইডিগুলি অনন্য হতে হবে, অথবা পরীক্ষার দ্বারা তৈরি সমস্ত বস্তু মুছে ফেলতে হবে। প্রয়োজনীয়তার কারণে কিছু বস্তু মুছে ফেলা যাবে না।

রায়: পোস্টম্যান স্ক্রিপ্ট ব্যবহার করে GUID তৈরি করুন।

var uuid = require('uuid');
var myid = uuid.v4();
pm.environment.set('myUUID', myid);

তারপর ক্যোয়ারীতে প্রতীকটি ব্যবহার করুন {{myUUID}}, যা ভেরিয়েবলের মান দিয়ে প্রতিস্থাপিত হবে।

LocalStack এর মাধ্যমে সহযোগিতা

যদি পরীক্ষা করা পরিষেবাটি একটি SQS সারিতে পড়ে বা লেখা হয়, তাহলে এটি যাচাই করার জন্য, পরীক্ষাটি নিজেই এই সারির সাথে কাজ করবে।

রায়: পোস্টম্যান থেকে লোকালস্ট্যাকে অনুরোধ।

AWS পরিষেবা API নথিভুক্ত করা হয়েছে, যাতে কোনো SDK ছাড়াই প্রশ্ন করা যায়।

যদি একটি পরিষেবা একটি সারিতে লেখে, তাহলে আমরা এটি পড়ি এবং বার্তাটির বিষয়বস্তু পরীক্ষা করি।

যদি পরিষেবাটি SNS-এ বার্তা পাঠায়, প্রস্তুতির পর্যায়ে LocalStack একটি সারি তৈরি করে এবং এই SNS বিষয়ে সদস্যতা নেয়। তারপরে এটি উপরে যা বর্ণিত হয়েছে তাতে নেমে আসে।

যদি পরিষেবাটিকে সারি থেকে একটি বার্তা পড়তে হয়, তবে পূর্ববর্তী পরীক্ষার ধাপে আমরা এই বার্তাটি সারিতে লিখি।

পরীক্ষার অধীনে মাইক্রোসার্ভিস থেকে উৎপন্ন HTTP অনুরোধগুলি পরীক্ষা করা হচ্ছে

কিছু পরিষেবা HTTP-তে AWS ছাড়া অন্য কিছু দিয়ে কাজ করে এবং কিছু AWS বৈশিষ্ট্য লোকালস্ট্যাকে প্রয়োগ করা হয় না।

রায়: এই ক্ষেত্রে এটি সাহায্য করতে পারে মক সার্ভার, যার মধ্যে একটি রেডিমেড ইমেজ আছে ডকার হাব. প্রত্যাশিত অনুরোধ এবং তাদের প্রতিক্রিয়া একটি HTTP অনুরোধ দ্বারা কনফিগার করা হয়. এপিআই নথিভুক্ত, তাই আমরা পোস্টম্যান থেকে অনুরোধ করি।

OAuth প্রমাণীকরণ এবং অনুমোদন পরীক্ষা করা হচ্ছে

আমরা OAuth ব্যবহার করি এবং JSON ওয়েব টোকেন (JWT). পরীক্ষার জন্য একটি OAuth প্রদানকারীর প্রয়োজন যা আমরা স্থানীয়ভাবে চালাতে পারি।

পরিষেবা এবং OAuth প্রদানকারীর মধ্যে সমস্ত মিথস্ক্রিয়া দুটি অনুরোধে নেমে আসে: প্রথমত, কনফিগারেশন অনুরোধ করা হয় /.well-known/openid-configuration, এবং তারপর কনফিগারেশন থেকে ঠিকানায় সর্বজনীন কী (JWKS) অনুরোধ করা হয়। এই সব স্ট্যাটিক কন্টেন্ট.

রায়: আমাদের পরীক্ষা OAuth প্রদানকারী একটি স্ট্যাটিক কন্টেন্ট সার্ভার এবং এটিতে দুটি ফাইল রয়েছে৷ টোকেনটি একবার তৈরি হয় এবং গিট-এ প্রতিশ্রুতিবদ্ধ হয়।

সিগন্যালআর পরীক্ষার বৈশিষ্ট্য

পোস্টম্যান ওয়েবসকেটের সাথে কাজ করে না। সিগন্যালআর পরীক্ষা করার জন্য একটি বিশেষ সরঞ্জাম তৈরি করা হয়েছিল।

একটি সিগন্যালআর ক্লায়েন্ট কেবল একটি ব্রাউজারের চেয়ে বেশি হতে পারে। .NET কোরের অধীনে এটির জন্য একটি ক্লায়েন্ট লাইব্রেরি রয়েছে। .NET কোরে লেখা ক্লায়েন্ট একটি সংযোগ স্থাপন করে, প্রমাণীকৃত হয় এবং বার্তার একটি নির্দিষ্ট ক্রম অপেক্ষা করে। যদি একটি অপ্রত্যাশিত বার্তা প্রাপ্ত হয় বা সংযোগ হারিয়ে যায়, ক্লায়েন্ট 1 এর কোড দিয়ে প্রস্থান করে। শেষ প্রত্যাশিত বার্তাটি প্রাপ্ত হলে, ক্লায়েন্ট 0-এর কোড দিয়ে প্রস্থান করে।

নিউম্যান ক্লায়েন্টের সাথে একযোগে কাজ করে। বার্তাগুলি যাদের প্রয়োজন তাদের প্রত্যেকের কাছে বিতরণ করা হয়েছে তা পরীক্ষা করার জন্য বেশ কয়েকটি ক্লায়েন্ট চালু করা হয়েছে।

একাধিক ক্লায়েন্ট চালানোর জন্য বিকল্পটি ব্যবহার করুন --স্কেল ডকার-কম্পোজ কমান্ড লাইনে।

চালানোর আগে, পোস্টম্যান স্ক্রিপ্ট সমস্ত ক্লায়েন্ট সংযোগ স্থাপনের জন্য অপেক্ষা করে।
আমরা ইতিমধ্যেই একটি সংযোগের জন্য অপেক্ষা করার সমস্যার সম্মুখীন হয়েছি৷ কিন্তু সার্ভার ছিল, এবং এখানে ক্লায়েন্ট. একটি ভিন্ন পদ্ধতির প্রয়োজন।

রায়: কন্টেইনারে থাকা ক্লায়েন্ট মেকানিজম ব্যবহার করে স্বাস্থ্য পরীক্ষাহোস্টে স্ক্রিপ্টকে তার অবস্থা সম্পর্কে অবহিত করতে। সংযোগ স্থাপনের সাথে সাথে ক্লায়েন্ট একটি নির্দিষ্ট পথে একটি ফাইল তৈরি করে, বলুন /স্বাস্থ্য পরীক্ষা করুন। ডকার ফাইলে হেলথচেক স্ক্রিপ্টটি এইরকম দেখাচ্ছে:

HEALTHCHECK --interval=3s CMD if [ ! -e /healthcheck ]; then false; fi

টীম ডকার পরিদর্শন ধারকটির স্বাভাবিক অবস্থা, স্বাস্থ্যের অবস্থা এবং প্রস্থান কোড দেখায়।

নিউম্যান সম্পূর্ণ হওয়ার পরে, স্ক্রিপ্ট চেক করে যে ক্লায়েন্টের সাথে সমস্ত কন্টেইনার বন্ধ হয়ে গেছে, কোড 0 সহ।

হ্যাপিনেস বিদ্যমান

আমরা উপরে বর্ণিত অসুবিধাগুলি কাটিয়ে উঠার পরে, আমাদের কাছে স্থিতিশীল চলমান পরীক্ষার একটি সেট ছিল। পরীক্ষায়, প্রতিটি পরিষেবা একটি একক হিসাবে কাজ করে, ডাটাবেস এবং অ্যামাজন লোকালস্ট্যাকের সাথে ইন্টারঅ্যাক্ট করে।

এই পরীক্ষাগুলি প্রায় 30+ মাইক্রোসার্ভিসের জটিল মিথস্ক্রিয়া সহ একটি অ্যাপ্লিকেশনে ত্রুটি থেকে 10+ ডেভেলপারদের একটি দলকে রক্ষা করে।

উত্স: www.habr.com