યાન્ડેક્ષ ફંક્શન મેઇલ મોકલે છે

આજે આપણે કહેવાતા બનાવીશું. યાન્ડેક્સ કાર્ય (સત્તાવાર નામ યાન્ડેક્ષ ક્લાઉડ કાર્યો), જે મેઇલિંગ સેવા સાથે સંકળાયેલી હતી SendGrid શાંતિથી સૂતા વપરાશકર્તાઓને "સાબુ" મોકલશે (માત્ર મજાક કરી રહ્યા છીએ - હું જાણું છું કે આપણે બધા સ્પામ વિરુદ્ધ છીએ).

હું પરંપરાગત સર્વર્સનો વિરોધી (પરંતુ કટ્ટરતા વિના) અને કહેવાતા સમર્થક પણ છું. સર્વર વિના (સર્વરલેસ) સોલ્યુશન્સ, કારણ કે મને સર્વર્સનું સંચાલન કરવું ગમતું નથી (અને ખરેખર કેવી રીતે ખબર નથી) અને તેથી પણ વધુ - જ્યારે તેઓ લોડ ન થાય ત્યારે સમય માટે ચૂકવણી કરવી. બીજી વસ્તુ કાર્યો છે. મારા વિના કોઈ તેમની સેવા કરે છે, અને હું ફક્ત કૉલ્સ માટે ચૂકવણી કરું છું. ઑક્ટોબર 2019 ની શરૂઆતમાં, યાન્ડેક્સે તેની રજૂઆત કરી યાન્ડેક્ષ ક્લાઉડ કાર્યો - રશિયન ફેડરેશનમાં પ્રથમ હોવાનું જણાય છે સર્વર વિના. અને ખાસ કરીને સરસ વાત એ છે કે એલિસની કુશળતા માટે તેઓ સામાન્ય રીતે મફત છે, તેથી તેઓ ત્યારથી મારી પેરિફેરલ વિઝનમાં છે. પરંતુ ચાલો પહેલાથી જ શરૂ કરીએ.

ચાલો આ દૃશ્યની કલ્પના કરીએ. તમારી અરજી (ઉદાહરણ તરીકે, એલિસની કુશળતા યાદ રાખો અને ભૂલી જાઓ જે, માર્ગ દ્વારા, પણ કામ કરે છે યાન્ડેક્સ કાર્યો) વપરાશકર્તાને ડિજિટલ પ્રોડક્ટ ખરીદવા માટે આમંત્રિત કરે છે, ઉદાહરણ તરીકે, વધારાના વિકલ્પો, અને વપરાશકર્તા ચુકવણી કરે છે. અમુક પ્રકારની ચુકવણી સિસ્ટમ (ગૂંચવણભરી રીતે સમાન યાન્ડેક્સ.મિની) ચુકવણીની પ્રક્રિયા કરે છે અને તમે પ્રદાન કરો છો તે સરનામા પર મોકલે છે (અને અમારી પાસે કૉલ કરવા માટે એક લિંક હશે યાન્ડેક્સ કાર્યો) HTTP- ચુકવણીની વિગતો ધરાવતી વિનંતી, જેમ કે રકમ, આખું નામ, ફોન નંબર અને ચુકવણીકારનો ઈમેલ. અમે આ ડેટાને અમુક રીતે પ્રક્રિયા કરવા માંગીએ છીએ, ઉદાહરણ તરીકે: રકમ તપાસો, ડેટાબેઝમાં યોગ્ય એન્ટ્રીઓ કરો, વપરાશકર્તાઓને મોકલો એસએમએસ и ઇમેઇલ ચુકવણીની રસીદ અને વધુ સૂચનાઓની પુષ્ટિ સાથે. તો તમારી જાતને માઇક્રોસર્વિસ.

કેવી રીતે થી યાન્ડેક્સ કાર્યો ડેટાબેઝમાં એન્ટ્રીઓ કરો ક્લાઉડ ફાયરસ્ટોર આપણે તેને ટ્યુટોરીયલમાં જોઈ લીધું છે એલિસને બધું યાદ છે (અને ભવિષ્યમાં, મને લાગે છે કે, અમે બીજા ડેટાબેઝ માટે એક ઉદાહરણ ધ્યાનમાં લઈશું - યાન્ડેક્ષ ડેટાબેઝ). વપરાશકર્તાઓને કેવી રીતે મોકલવું તે વિશે એસએમએસ અને અમારી એપ્લિકેશન સાથે સંકલિત કરો યાન્ડેક્સ.મની - અમે તેને નજીકના ભવિષ્યમાં ઉકેલીશું. હવે ચાલો ફક્ત પત્રો મોકલવા સાથે વ્યવહાર કરીએ.

1. SendGrid માં એકાઉન્ટ બનાવો

નોંધણીSendGrid એ માત્ર મારી પસંદગી છે, જે મેં ઘણા કારણોસર બનાવી છે, મુખ્ય કારણ એ છે કે તેમની પાસે Node.js માટે તૈયાર SDK છે. તમે કોઈપણ અન્ય મેઇલિંગ સેવા પસંદ કરી શકો છો.

ચલો આગળ વધીએ એકાઉન્ટ રજીસ્ટ્રેશન પેજ પર અને ત્યાં રજીસ્ટ્રેશન ફોર્મ ભરો. પછી અમે જઈએ છીએ ડેશબોર્ડ, નેવિગેશન પેનલમાં પસંદ કરો Email API -> એકીકરણ માર્ગદર્શિકા, અને મુખ્ય પેનલ પર - વેબ API нажимаем પસંદ કરો. બધું ચિત્રમાં જેવું છે:

આગલા પગલામાં આપણે પસંદ કરીએ છીએ Node.js:

આગળ અમે અમારા માટે સાથે આવીએ છીએ API-કી નામ (કીઓની સૂચિમાં ફક્ત કન્સોલમાં જ પ્રદર્શિત થશે, અને તેને આપણા ભાવિ કોડ સાથે કોઈ લેવાદેવા નથી; હું એક અવિનાશી સાથે આવ્યો છું ડેમો-એપીઆઈ-કી) અને બટન દબાવો કી બનાવો:

કી જનરેટ થશે, અમે તેને કોપી કરીશું અને તેને સૌથી વધુ વિશ્વાસમાં રાખીશું. અને અમારી પાસે એક બટન સાથે સ્ક્રીન હશે એકીકરણ ચકાસો, નીચેના ચિત્રની જેમ, પરંતુ અમે હજી સુધી તેને ક્લિક કરીશું નહીં, પરંતુ ચાલો કોડ લખવા તરફ આગળ વધીએ:

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/mail. પ્લાસ્ટિકની થેલી ઈમેલ-વેલીડેટર માન્યતા માટે ઇમેઇલ સરનામું તપાસે છે (મેં તરત જ કેવી રીતે અનુમાન કર્યું નથી?), પરંતુ જો અમને તેની ખાતરી હોય (તે અમારા વિના લાંબા સમયથી તપાસવામાં આવી છે), તો અમારે તેને ઇન્સ્ટોલ કરવાની જરૂર નથી (અને, અલબત્ત, આપણે તેને કોડમાં તપાસવાની જરૂર નથી). પ્લાસ્ટિકની થેલી dotenv ફાઇલમાંથી રેકોર્ડ્સ વાંચવા માટે રચાયેલ છે .env રનટાઇમ ચલો તરીકે. પરંતુ માં યાન્ડેક્સ કાર્યો આ ચલો સીધા રનટાઈમ પર્યાવરણમાં મૂકવું શક્ય છે. કેવી રીતે? - હું તેને નીચે બતાવીશ. તેથી પેકેજ dotenv તમે તેને અને ફાઇલ પણ ઇન્સ્ટોલ કરી શકતા નથી .env - બનાવશો નહીં, અને તે જ સમયે કોડ ફાઇલમાં છે index.js બદલો નહીં. પરંતુ અહીં અમે આ પેકેજ ઇન્સ્ટોલ કર્યું છે, તેથી અમે ફાઇલો બનાવીએ છીએ index.js и .env:

touch index.js
touch .env

ફાઈલમાં index.js ઉપરના સ્ક્રીનશોટમાં દર્શાવેલ કોડની 22 લીટીઓ લખો (ફક્ત લીટીમાં #8 તમારું ઇમેઇલ બદલો), અને ફાઇલમાં .env - (કોઈપણ અવતરણ અથવા વિરામચિહ્નો વિના) જોડી સ્પષ્ટ કરો - કી નામ/મૂલ્ય APIજે અમે તાજેતરમાં કન્સોલમાં પ્રાપ્ત કર્યું છે SendGrid:
SENDGRID_API_KEY=your-very-secret-sendgrid-api-key

અને જો તમને ઓછું કામ જોઈતું હોય, તો રિપોઝીટરીને ક્લોન કરો અને પેકેજો ઇન્સ્ટોલ કરો:

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

ફાઈલમાં index.js, લાઇનમાં #8 ઈ - મેઈલ બદલો; રૂટ ડિરેક્ટરીમાં ફાઇલ બનાવો .env, અને તેમાં કીનું નામ/મૂલ્ય દર્શાવે છે API, ઉપર બતાવ્યા પ્રમાણે.

3. જમાવટ કરો

વિશે વધુ કે ઓછા સ્પષ્ટ અને વિગતવાર Yandex.Cloud અને તેને ત્યાં કેવી રીતે મૂકવું યાન્ડેક્સ કાર્યો મારા લેખમાં વર્ણવેલ એલિસ ઇન ધ લેન્ડ ઓફ બિટ્રિક્સ - હું અજ્ઞાનીઓને આ દેશમાં મોકલું છું, અને બીજા બધા માટે (અને જેઓ પાછા ફર્યા છે) - પછી એક નાનકડી કોમિક બુક (એટલે ​​​​કે ચિત્રો અને ટેક્સ્ટની શ્રેણી).

અમે બનાવીએ છીએ ઝિપ-આર્કાઇવ (ચાલો તેને કહીએ, ઉદાહરણ તરીકે, mailer.zip), જેમાં અમે ડિરેક્ટરીનો સમાવેશ કરીએ છીએ નોડ_મોડ્યુલ્સ અને ફાઇલો .env, index.js - અમારા પ્રોજેક્ટ કેટલોગમાંથી બધું:

અમે નામ સાથે ફંક્શન બનાવીએ છીએ... યોગ્ય રીતે - મેઇલર, ડાબી નેવિગેશન મેનુમાં આપણે દાખલ કરીએ છીએ એડિટર, જરૂરી ફીલ્ડ્સ ભરો અને ટેબ પર સ્વિચ કરો ઝીપ આર્કાઇવ અમારા આર્કાઇવને ડાઉનલોડ કરો mailer.zip:

અને અહીં ડાઉનલોડ કરવા માટે અગાઉ ઉલ્લેખિત વિકલ્પ છે API કી પ્રોજેક્ટમાં ફાઇલ બનાવવાને બદલે સીધા અહીં .env, અને પેકેજ ઇન્સ્ટોલ કરશો નહીં dotenv. પરંતુ અમે આ બધું પહેલેથી જ કરી લીધું છે, તેથી હું ફક્ત માહિતી માટે જ બતાવી રહ્યો છું. એટલે કે, ડુપ્લિકેટ કરવાની જરૂર નથી!

હવે ઉપરના જમણા ખૂણે બટન પર ક્લિક કરો સંસ્કરણ બનાવો, અને થોડી સેકંડ રાહ જુઓ. જ્યારે બધું તૈયાર થઈ જાય, ત્યારે અમે આપમેળે વિભાગમાં જઈશું ઝાંખી. ત્યાં આપણે વિકલ્પને સક્ષમ કરીશું જાહેર કાર્યજેથી તમે બહારની દુનિયાથી તેની સાથે સંપર્ક કરી શકો.

તમે શિલાલેખની વિરુદ્ધ વાદળી લિંક જોશો લિંક પર કૉલ કરો? તેને ક્લિક કરો. એક ખાલી બ્રાઉઝર વિન્ડો ખુલશે... પણ રાહ જુઓ - મને એક ઈમેલ મળ્યો:

હવે તમે કન્સોલ પર પાછા આવી શકો છો SendGrid, અને બટન દબાવો એકીકરણ ચકાસો. સિસ્ટમ તેની ચેનલો દ્વારા બધું તપાસશે, અને પરિણામે તેણે આના જેવી સ્ક્રીન પરત કરવી જોઈએ:

બસ, છોકરાઓ (અને છોકરીઓ, અલબત્ત) - બધું ખરેખર ખૂબ જ સરળ અને ભવ્ય છે! વધુ લેખો હશે. જો કોઈને આના જેવું કંઈક વાંચવામાં રસ હોય, તો સબ્સ્ક્રાઇબ કરો જેથી તમે ચૂકી ન જાઓ.

4. દાન

સોર્સ: www.habr.com