ইয়ানডেক্স ফাংশন মেল পাঠায়

আজ আমরা তথাকথিত তৈরি করব। ইয়ানডেক্স ফাংশন (দাপ্তরিক নাম ইয়ানডেক্স ক্লাউড ফাংশন), যা মেইলিং পরিষেবার সাথে জড়িত SendGrid শান্তিপূর্ণভাবে ঘুমন্ত ব্যবহারকারীদের কাছে "সাবান" পাঠাবে (শুধু মজা করছি - আমি জানি যে আমরা সবাই স্প্যামের বিরুদ্ধে)।

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

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

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

1. সেন্ডগ্রিডে একটি অ্যাকাউন্ট তৈরি করুন

মন্তব্যSendGrid শুধুমাত্র আমার পছন্দ, যা আমি বিভিন্ন কারণে তৈরি করেছি, প্রধানটি হল তাদের Node.js-এর জন্য একটি রেডিমেড SDK আছে। আপনি অন্য কোনো মেইলিং পরিষেবা বেছে নিতে পারেন।

চল এগোই অ্যাকাউন্ট নিবন্ধন পৃষ্ঠায় এবং সেখানে নিবন্ধন ফর্ম পূরণ করুন. তারপর আমরা যেতে ড্যাশবোর্ড, নেভিগেশন প্যানেলে নির্বাচন করুন ইমেল API -> ইন্টিগ্রেশন গাইড, এবং প্রধান প্যানেলে - ওয়েব এপিআই нажимаем বেছে নিন. সবকিছু ছবির মত:

পরবর্তী ধাপে আমরা নির্বাচন করি node.js:

পরবর্তী আমরা আমাদের জন্য সঙ্গে আসা এপিআই-কী নাম (কীগুলির তালিকায় শুধুমাত্র কনসোলে প্রদর্শিত হবে, এবং আমাদের ভবিষ্যতের কোডের সাথে কোন সম্পর্ক নেই; আমি কেবল একটি অবিনশ্বর নিয়ে এসেছি ডেমো-এপিআই-কী) এবং বোতাম টিপুন কী তৈরি করুন:

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

2. কোড লেখা

কিন্তু কোড নিজেই, আপনি দেখতে পারেন, হাস্যকরভাবে ছোট - 22 লাইন!

সঙ্গতিপূর্ণভাবে #8 আমার ইমেল হার্ডকোড করা হয়েছে (এবং তাই লাজুকভাবে লুকানো) - অনুগ্রহ করে আপনার ইঙ্গিত করুন। বাস্তব জীবনে, আমরা সমস্ত ডেটা (সহ ইমেইল) বস্তু থেকে ঘটনা. উদাহরণস্বরূপ, যদি পদ্ধতি পোস্ট একটি বস্তু আমাদের ফাংশন পাঠানো হয় ব্যবহারকারী ক্ষেত্র সহ (সম্পত্তি) ইমেইল, এই ক্ষেত্রের মান এই মত প্রাপ্ত করা যেতে পারে:

const { user } = event;
const email = user.email;

এবং যদি ইমেল ঠিকানাটি পদ্ধতি ব্যবহার করে ফাংশনে পাস করা হয় পাওয়াউদাহরণস্বরূপ, https://functions.yandexcloud.net/123abc?[email protected]
পরামিতি মান ইমেইল আপনি এটি এই মত পেতে পারেন:

const email = event.queryStringParameters.email;

একটি বস্তুর মধ্যে ঠিক কি আছে তা একবার দেখতে ঘটনা, আপনি সহজ তৈরি করতে পারেন ইয়ানডেক্স ফাংশন এবং প্রশ্ন সহ এটি মোচড়:

module.exports.handler = async function (event) {
  return {
   'statusCode': 200, 
   'body': JSON.stringify(event)
  };
};

অফিসিয়াল ডকুমেন্টেশনে এটি আরও বিশদে (কিন্তু কম স্পষ্টভাবে) আলোচনা করা হয়েছে এখানে.

সুতরাং, একটি প্রকল্প ডিরেক্টরি তৈরি করুন (উদাহরণস্বরূপ, মেইলার), এটিতে যান, প্রকল্পটি শুরু করুন, নির্ভরতা ইনস্টল করুন:

mkdir mailer
cd mailer
npm init -y
npm i @sendgrid/mail email-validator dotenv

এখানে শুধুমাত্র প্যাকেজ প্রয়োজন @sendgrid/মেইল. প্লাস্টিক ব্যাগ ইমেল যাচাইকারী বৈধতার জন্য ইমেল ঠিকানাটি পরীক্ষা করে (এখনই আমি কীভাবে অনুমান করিনি?), তবে আমরা যদি এটি সম্পর্কে নিশ্চিত হই (এটি ইতিমধ্যে আমাদের ছাড়াই দীর্ঘদিন ধরে পরীক্ষা করা হয়েছে), আমাদের এটি ইনস্টল করতে হবে না (এবং, এর অবশ্যই, আমাদের কোডে এটি পরীক্ষা করতে হবে না)। প্লাস্টিক ব্যাগ dotenv একটি ফাইল থেকে রেকর্ড পড়ার জন্য ডিজাইন করা হয়েছে .env রানটাইম ভেরিয়েবল হিসাবে। কিন্তু ইয়ানডেক্স ফাংশন এই ভেরিয়েবলগুলি সরাসরি রানটাইম পরিবেশে স্থাপন করা সম্ভব। কিভাবে? - আমি নীচে দেখাব. তাই প্যাকেজ dotenv আপনি এটি এবং ফাইলটি ইনস্টল করতে পারবেন না .env - তৈরি করবেন না, এবং একই সময়ে কোডটি ফাইলটিতে রয়েছে index.js পরিবর্তন করবেন না. কিন্তু এখানে আমরা এই প্যাকেজটি ইনস্টল করেছি, তাই আমরা ফাইল তৈরি করি index.js и .env:

touch index.js
touch .env

ফাইলে index.js উপরের স্ক্রিনশটে দেখানো কোডের 22 লাইন লিখুন (শুধুমাত্র লাইনে #8 আপনার ইমেল পরিবর্তন করুন), এবং ফাইলে .env - (কোনও উদ্ধৃতি বা বিরাম চিহ্ন ছাড়া) জোড়া নির্দিষ্ট করুন - কী নাম/মান এপিআইযা আমরা সম্প্রতি কনসোলে পেয়েছি SendGrid:
SENDGRID_API_KEY=আপনার-খুব-গোপন-sendgrid-api-কী

এবং আপনি যদি কম কাজ করতে চান তবে সংগ্রহস্থলটি ক্লোন করুন এবং প্যাকেজগুলি ইনস্টল করুন:

git clone https://github.com/stmike/ycf-sendgrid-mailer-tutorial.git
cd ycf-sendgrid-mailer-tutorial
npm i

ফাইলে index.js, সঙ্গতিপূর্ণভাবে #8 ইমেইল পরিবর্তন; রুট ডিরেক্টরিতে একটি ফাইল তৈরি করুন .env, এবং এতে কীটির নাম/মান নির্দেশ করে এপিআই, ঠিক উপরে দেখানো হয়েছে।

3. স্থাপন

কমবেশি স্পষ্টভাবে এবং সম্পর্কে বিস্তারিত Yandex.Cloud এবং সেখানে কিভাবে স্থাপন করা যায় ইয়ানডেক্স ফাংশন আমার নিবন্ধে বর্ণিত বিট্রিক্সের দেশে এলিস - আমি এই দেশে অজ্ঞদের পাঠাই, এবং অন্য সবার জন্য (এবং যারা ফিরে এসেছিল) - তারপর একটি ছোট কমিক বই (অর্থাৎ ছবি এবং পাঠ্যের একটি সিরিজ)।

আমরা বানাই ফ্যাস্ শব্দআর্কাইভ (আসুন এটিকে কল করি, উদাহরণস্বরূপ, mailer.zip), যার মধ্যে আমরা ডিরেক্টরি অন্তর্ভুক্ত করি নোড_মডিউলস এবং ফাইল .env, index.js - আমাদের প্রকল্প ক্যাটালগ থেকে সবকিছু:

আমরা নাম দিয়ে একটি ফাংশন তৈরি করি... সঠিকভাবে - মেইলার, বাম নেভিগেশন মেনুতে আমরা প্রবেশ করি সম্পাদক, প্রয়োজনীয় ক্ষেত্রগুলি পূরণ করুন এবং ট্যাবে স্যুইচ করুন৷ জিপ সংরক্ষণাগার আমাদের আর্কাইভ ডাউনলোড করুন mailer.zip:

এবং এখানে ডাউনলোড করার জন্য পূর্বে উল্লেখ করা বিকল্প আছে API কী প্রজেক্টে একটি ফাইল তৈরি করার পরিবর্তে সরাসরি এখানে .env, এবং প্যাকেজ ইনস্টল করবেন না dotenv. কিন্তু আমরা ইতিমধ্যেই এই সব করে ফেলেছি, তাই আমি শুধু তথ্যের জন্যই দেখাচ্ছি। অর্থাৎ ডুপ্লিকেট করার দরকার নেই!

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

আপনি শিলালিপি বিপরীত নীল লিঙ্ক দেখতে কল করার লিঙ্ক? এটি ক্লিক করুন. একটি খালি ব্রাউজার উইন্ডো খুলবে... কিন্তু অপেক্ষা করুন - আমি একটি ইমেল পেয়েছি:

এখন আপনি কনসোলে ফিরে যেতে পারেন SendGrid, এবং বোতাম টিপুন ইন্টিগ্রেশন যাচাই করুন. সিস্টেমটি তার চ্যানেলগুলির মাধ্যমে সবকিছু পরীক্ষা করবে এবং ফলস্বরূপ এটির মতো একটি স্ক্রিন ফেরত দেওয়া উচিত:

এটা, ছেলেরা (এবং মেয়েরা, অবশ্যই) - সবকিছু সত্যিই খুব সহজ এবং মার্জিত! আরো নিবন্ধ থাকবে. কেউ যদি এইরকম কিছু পড়তে আগ্রহী হন, সাবস্ক্রাইব করুন যাতে আপনি মিস করবেন না।

4. অনুদান

উত্স: www.habr.com