Yandex ფუნქციები ფოსტის გაგზავნას

დღეს ჩვენ შევქმნით ე.წ. Yandex ფუნქცია (ოფიციალური სახელი Yandex Cloud ფუნქციები), რომელიც შეთანხმებული იყო საფოსტო სერვისთან SendGrid გაუგზავნის "საპონს" მშვიდად მძინარე მომხმარებლებს (უბრალოდ ვხუმრობ - ვიცი, რომ ჩვენ ყველანი წინააღმდეგი ვართ სპამის წინააღმდეგ).

მეც ტრადიციული სერვერების მოწინააღმდეგე (ოღონდ ფანატიზმის გარეშე) და ე.წ. სერვერზე (სერვერის გარეშე) გადაწყვეტილებები, რადგან არ მომწონს (და ნამდვილად არ ვიცი როგორ) სერვერების ადმინისტრირება, და მით უმეტეს, გადავიხადო დრო, როდესაც ისინი არ არის დატვირთული. სხვა რამ არის ფუნქციები. ვიღაც ემსახურება მათ უჩემოდ და მე ვიხდი მხოლოდ ზარებს. 2019 წლის ოქტომბრის დასაწყისში Yandex-მა წარმოადგინა თავისი Yandex Cloud ფუნქციები - როგორც ჩანს, პირველია რუსეთის ფედერაციაში სერვერზე. და რაც განსაკუთრებით სასიამოვნოა, ის არის, რომ ალისის უნარებისთვის ისინი ზოგადად თავისუფალია, ამიტომ ისინი მას შემდეგ ჩემს პერიფერიულ ხედვაში არიან. მაგრამ მოდი დავიწყოთ უკვე.

წარმოვიდგინოთ ეს სცენარი. თქვენი განაცხადი (მაგალითად, ალისის უნარი დაიმახსოვრე და დაივიწყე რომელიც, სხვათა შორის, ასევე მუშაობს Yandex ფუნქციები) იწვევს მომხმარებელს შეიძინოს ციფრული პროდუქტი, მაგალითად, დამატებითი ოფციები და მომხმარებელი იხდის გადახდას. რაიმე სახის გადახდის სისტემა (დაბნეულად მსგავსი Yandex.Money) ამუშავებს გადახდას და აგზავნის თქვენს მიერ მოწოდებულ მისამართზე (და ჩვენ გვექნება ბმული დასარეკად Yandex ფუნქციები) HTTP- მოთხოვნა, რომელიც შეიცავს გადახდის დეტალებს, როგორიცაა თანხა, სრული სახელი, ტელეფონის ნომერი და გადამხდელის ელ.ფოსტა. ჩვენ გვინდა ეს მონაცემები რაიმე გზით დავამუშავოთ, მაგალითად: შევამოწმოთ თანხა, გავაკეთოთ შესაბამისი ჩანაწერები მონაცემთა ბაზაში, გავუგზავნოთ მომხმარებლებს SMS и Email გადახდის მიღების დადასტურებით და შემდგომი ინსტრუქციებით. ასე რომ საკუთარ თავს მიკროსერვისი.

იმის შესახებ, თუ როგორ Yandex ფუნქციები ჩანაწერების გაკეთება მონაცემთა ბაზაში Cloud Firestore ჩვენ უკვე ვუყურეთ მას სახელმძღვანელოში ალისას ყველაფერი ახსოვს (და მომავალში, ვფიქრობ, განვიხილავთ მაგალითს სხვა მონაცემთა ბაზისთვის - Yandex მონაცემთა ბაზა). მომხმარებლისთვის გაგზავნის შესახებ SMS და გავაერთიანოთ ჩვენი აპლიკაცია Yandex.Money - ამას უახლოეს მომავალში მოვაგვარებთ. ახლა მოდით მხოლოდ წერილების გაგზავნით ვიმუშაოთ.

1. შექმენით ანგარიში SendGrid-ში

შენიშვნაSendGrid მხოლოდ ჩემი არჩევანია, რომელიც მე გავაკეთე რამდენიმე მიზეზის გამო, მთავარი ის არის, რომ მათ აქვთ მზა SDK Node.js-ისთვის. თქვენ შეგიძლიათ აირჩიოთ ნებისმიერი სხვა საფოსტო სერვისი.

მოდით გადავიდეთ ანგარიშის რეგისტრაციის გვერდზე და შეავსეთ სარეგისტრაციო ფორმა იქ. შემდეგ მივდივართ ჩემი გვერდი, ნავიგაციის პანელში აირჩიეთ ელფოსტის API -> ინტეგრაციის სახელმძღვანელოდა მთავარ პანელზე - ვებ API და нажимаем кнопку არჩევა. ყველაფერი ისეა როგორც სურათზე:

შემდეგ ეტაპზე ჩვენ ვირჩევთ Node.js:

შემდეგი ჩვენ ამუშავება ჩვენი API-გასაღების სახელი (გასაღებების ჩამონათვალში გამოჩნდება მხოლოდ კონსოლში და არაფერი აქვს საერთო ჩვენს მომავალ კოდთან; მე უბრალოდ გამოვიტანე უხრწნელი დემო-აპი-გასაღები) და დააჭირეთ ღილაკს გასაღების შექმნა:

გასაღების გენერირება მოხდება, ჩვენ დავაკოპირებთ მას და შევინახავთ ყველაზე ღრმად. და გვექნება ეკრანი ღილაკით შეამოწმეთ ინტეგრაცია, როგორც ქვემოთ მოცემულ სურათზე, მაგრამ ჯერ არ დავაწკაპუნებთ, მაგრამ გადავიდეთ კოდის დაწერაზე:

2. კოდის დაწერა

მაგრამ თავად კოდი, როგორც ხედავთ, სასაცილოდ მცირეა - 22 სტრიქონი!

Ხაზში #8 ჩემი ელფოსტა არის მყარი კოდირებული (და, შესაბამისად, მორცხვად დამალული) - გთხოვთ, მიუთითოთ თქვენი. რეალურ ცხოვრებაში ჩვენ მივიღებთ ყველა მონაცემს (მათ შორის ელფოსტაზე) ობიექტიდან ღონისძიება. მაგალითად, თუ მეთოდი POST ობიექტი ეგზავნება ჩვენს ფუნქციას მომხმარებელი ველით (საკუთრებით) ელფოსტაზე, ამ ველის მნიშვნელობა შეიძლება მივიღოთ შემდეგნაირად:

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

და თუ ელ.ფოსტის მისამართი გადაეცემა ფუნქციას მეთოდის გამოყენებით მთავარი, მაგალითად: https://functions.yandexcloud.net/123abc?[email protected]
პარამეტრის მნიშვნელობა ელფოსტაზე შეგიძლიათ მიიღოთ ეს ასე:

const email = event.queryStringParameters.email;

შევხედოთ კონკრეტულად რას შეიცავს საგანი ღონისძიება, შეგიძლიათ შექმნათ უმარტივესი Yandex ფუნქცია და გადაატრიალეთ იგი მოთხოვნებით:

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/mail. პლასტიკური ჩანთა ელ.ფოსტის დამადასტურებელი ამოწმებს ელ.ფოსტის მისამართს ვალიდობაზე (როგორ ვერ მივხვდი მაშინვე?), მაგრამ თუ დარწმუნებული ვართ (ის უკვე დიდი ხანია შემოწმდა ჩვენს გარეშე), არ გვჭირდება მისი ინსტალაცია (და, რა თქმა უნდა, ჩვენ არ უნდა შევამოწმოთ იგი კოდში). პლასტიკური ჩანთა დოტენვი შექმნილია ფაილიდან ჩანაწერების წასაკითხად .ენვ როგორც გაშვების ცვლადები. მაგრამ შიგნით Yandex ფუნქციები შესაძლებელია ამ ცვლადების განთავსება პირდაპირ გაშვების გარემოში. Როგორ? - ქვემოთ გაჩვენებ. ამიტომ პაკეტი დოტენვი თქვენ ასევე არ შეგიძლიათ დააინსტალიროთ იგი და ფაილი .ენვ - არ შექმნათ და ამავდროულად კოდი არის ფაილში index.js არ შეცვალო. მაგრამ აქ ჩვენ დავაინსტალირეთ ეს პაკეტი, ამიტომ ვქმნით ფაილებს index.js и .ენვ:

touch index.js
touch .env

ფაილში index.js დაწერეთ კოდის 22 ხაზი, რომელიც ნაჩვენებია ზემოთ მოცემულ ეკრანის სურათზე (მხოლოდ ხაზში #8 შეცვალეთ თქვენი ელფოსტა) და ფაილში .ენვ - (ყოველგვარი ბრჭყალებისა და პუნქტუაციის გარეშე) მიუთითეთ წყვილი - გასაღების სახელი/მნიშვნელობა APIრომელიც ახლახან მივიღეთ კონსოლში 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 ელ.ფოსტის შეცვლა; შექმენით ფაილი root დირექტორიაში .ენვ, და მასში მიუთითეთ გასაღების სახელი/მნიშვნელობა API, როგორც ზემოთ არის ნაჩვენები.

3. განლაგება

მეტ-ნაკლებად მკაფიოდ და დეტალურად შესახებ Yandex.Cloud და როგორ განვათავსოთ იგი იქ Yandex ფუნქციები აღწერილია ჩემს სტატიაში ალისა ბიტრიქსის ქვეყანაში - უმეცარებს ვაგზავნი ამ ქვეყანაში და ყველასთვის (და ვინც დაბრუნდა) - შემდეგ პატარა კომიქსს (ე.ი. სურათების და ტექსტის სერიას).

Შექმნა zip-არქივი (დავარქვათ, მაგალითად, mailer.zip), რომელშიც ჩვენ შევიტანთ დირექტორიას კვანძის_მოდულები და ფაილები .env, index.js - ყველაფერი ჩვენი პროექტის კატალოგიდან:

ჩვენ ვქმნით ფუნქციას სახელით... სწორად - ფოსტალიონი, მარცხენა ნავიგაციის მენიუში შევდივართ რედაქტორი, შეავსეთ საჭირო ველები და გადადით ჩანართზე ZIP არქივი ჩამოტვირთეთ ჩვენი არქივი mailer.zip:

და აქ არის ჩამოტვირთვის ადრე ნახსენები ვარიანტი API გასაღები პირდაპირ აქ, ვიდრე პროექტში ფაილის შექმნა .ენვდა არ დააინსტალიროთ პაკეტი დოტენვი. მაგრამ ჩვენ უკვე გავაკეთეთ ეს ყველაფერი, ამიტომ მე ვაჩვენებ მხოლოდ ინფორმაციისთვის. ანუ დუბლირება არ არის საჭირო!

ახლა ზედა მარჯვენა კუთხეში დააჭირეთ ღილაკს ვერსიის შექმნადა დაელოდეთ რამდენიმე წამს. როდესაც ყველაფერი მზად იქნება, ჩვენ ავტომატურად გადავალთ განყოფილებაში განიხილოს. იქ ჩვენ გავააქტიურებთ ვარიანტს საზოგადოებრივი ფუნქციარათა თქვენ შეძლოთ მასთან ურთიერთობა გარე სამყაროდან.

თქვენ ხედავთ ლურჯ ბმულს წარწერის საპირისპიროდ დარეკვის ლინკი? დააწკაპუნეთ. ბრაუზერის ცარიელი ფანჯარა გაიხსნება... მაგრამ დაელოდეთ - მე მივიღე ელ.წერილი:

ახლა შეგიძლიათ დაბრუნდეთ კონსოლში SendGridდა დააჭირეთ ღილაკს შეამოწმეთ ინტეგრაცია. სისტემა ყველაფერს შეამოწმებს თავისი არხებით და შედეგად უნდა დააბრუნოს ასეთი ეკრანი:

ესე იგი, ბიჭებო (და გოგოებო, რა თქმა უნდა) - ყველაფერი მართლაც ძალიან მარტივი და ელეგანტურია! კიდევ იქნება სტატიები. თუ ვინმეს აინტერესებს მსგავსი რამის წაკითხვა, გამოიწერეთ, რომ არ გამოტოვოთ.

4. შემოწირულობები

წყარო: www.habr.com