Yandex 기능은 메일을 보냅니다

오늘 우리는 소위 말하는 것을 만들 것입니다 얀덱스 기능 (공식명칭 Yandex 클라우드 기능), 우편 서비스와 공모 SendGrid 평화롭게 잠들어 있는 사용자에게 "비누"를 보냅니다(농담입니다. 우리 모두 스팸에 반대한다는 건 알지만요).

나는 또한 전통적인 서버의 반대자(그러나 광신주의는 아님)이며 소위 말하는 것을 지지합니다. 서버리스 (서버리스) 솔루션을 사용하는 이유는 서버를 관리하는 것을 좋아하지 않고(실제로 관리하는 방법도 모르고) 더군다나 서버가 로드되지 않는 시간에 비용을 지불하기 때문입니다. 또 다른 문제는 기능입니다. 나 없이 다른 사람이 전화를 받고, 나는 통화 요금만 지불합니다. 2019년 XNUMX월 초 Yandex는 Yandex 클라우드 기능 — 러시아에서는 처음인 것 같아요 서버리스. 그리고 특히 좋은 점은 앨리스의 기술이 완전히 무료라는 점인데, 그래서 그 이후로 계속 제가 늘 주시하고 있었어요. 하지만 이미 시작해보죠.

이런 시나리오를 상상해 보자. 귀하의 신청서(예: Alice의 기술) 기억하고 잊어라 그건 그렇고, 이것도 작동합니다 Yandex 기능)는 사용자에게 추가 옵션 등의 디지털 상품을 구매하도록 제안하고, 사용자가 결제를 진행합니다. 일부 지불 시스템(혼동스럽게도 유사함) Yandex 주차) 결제를 처리하여 귀하가 제공한 주소로 보냅니다(당사의 경우 이는 전화할 수 있는 링크가 됩니다) 얀덱스 기능) HTTP- 지불 금액, 지불자의 성명, 전화번호, 이메일 주소 등 지불 세부 정보가 포함된 요청입니다. 예를 들어, 우리는 이 데이터를 다음과 같은 방법으로 처리하고 싶습니다. 금액 확인, 데이터베이스에 적절한 항목 입력, 사용자에게 전송 SMS и 이메일 지불 수령 확인 및 추가 지시사항이 포함되어 있습니다. 그저 그렇다 마이크로서비스.

어떻게에 관하여 Yandex 기능 DB에 항목을 입력하다 클라우드 소방서 우리는 이미 튜토리얼에서 그것을 살펴보았습니다. 앨리스는 모든 것을 기억한다 (나중에 다른 DB에 대한 예를 고려해 볼 것이라고 생각합니다. Yandex 데이터베이스). 사용자에게 보내는 방법에 대하여 SMS 그리고 우리의 애플리케이션을 통합합니다 얀덱스.머니 —가까운 미래에 알아낼 거예요. 이제 편지를 보내는 데만 집중하겠습니다.

1. SendGrid에 계정 생성

주의SendGrid는 제가 여러 가지 이유로 선택한 서비스입니다. 가장 큰 이유는 Node.js용 기성 SDK가 있다는 것입니다. 다른 우편 서비스를 선택하셔도 됩니다.

계속하다 계정 등록 페이지로 그리고 거기에서 등록양식을 작성하세요. 그 다음에는 다음으로 넘어갑니다. 대시보드, 탐색 패널에서 다음을 선택합니다. 이메일 API -> 통합 가이드, 그리고 메인 패널에서 - 웹 API 그리고 버튼을 눌러 왼쪽 메뉴에서. 모든 것이 그림과 같습니다:

다음 단계에서는 다음을 선택합니다. Node.js를:

그 다음에는 우리 스스로의 것을 생각해 보자 API-키 이름(콘솔의 키 목록에서만 표시되며 향후 코드와는 아무 관련이 없습니다. 저는 영구적인 이름을 생각해냈습니다. 데모 API 키) 버튼을 누릅니다. 키 생성:

열쇠는 생성될 것이고, 우리는 그것을 복사해서 가장 깊은 비밀로 보관할 것입니다. 그리고 버튼이 있는 화면이 있을 겁니다. 통합 확인아래 그림과 같이 하지만 아직 클릭하지 않고 코드 작성으로 넘어가겠습니다.

2. 코드 작성

그리고 코드 자체는 보시다시피 22줄로, 믿을 수 없을 정도로 작습니다!

인라인 #8 제 이메일은 하드코딩되어 있어서 부끄럽게도 가려져 있습니다. 본인의 이메일 주소를 알려주세요. 실제로 우리는 모든 데이터를 수신할 것입니다(다음을 포함함) 이메일) 객체로부터 event. 예를 들어, 이 방법의 경우 POST 객체가 우리 함수로 전송됩니다 사용자 필드(속성)가 있는 이메일, 이 필드의 값은 다음과 같이 얻을 수 있습니다.

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

그리고 이메일 주소가 메서드에 의해 함수에 전달되는 경우 바로예 : https://functions.yandexcloud.net/123abc?email=user@example.com
매개변수 값 이메일 다음과 같이 얻을 수 있습니다:

const email = event.queryStringParameters.email;

객체에 정확히 무엇이 포함되어 있는지 살펴보려면 event, 가장 간단한 것을 만들 수 있습니다 얀덱스 기능 그리고 이를 쿼리로 돌려보세요:

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/메일. 비닐 봉투 이메일 검증기 이메일 주소의 유효성을 검사합니다(어떻게 바로 추측하지 못했을까요?). 하지만 확신한다면(우리가 모르게 오래전에 이미 검사가 끝났습니다) 설치할 필요가 없습니다(물론 코드에서 검사할 필요도 없습니다). 비닐봉지 도 텐프 파일에서 레코드를 읽도록 설계되었습니다. .env 런타임 변수로. 그러나 Yandex 기능 이러한 변수를 실행 환경에 직접 배치하는 것이 가능합니다. 어떻게? - 아래에 보여드리겠습니다. 따라서 패키지 도 텐프 또한 설정할 수 없으며 파일 .env - 생성하지 않고 동시에 코드가 파일에 있습니다. index.js 변경하지 마세요. 하지만 여기서 우리는 이 패키지를 설치했으므로 파일을 생성합니다. index.js и .env:

touch index.js
touch .env

파일에서 index.js 위의 스크린샷에 표시된 22줄의 코드를 작성합니다(줄에만 있음) #8 이메일을 변경하세요) 및 파일에서 .env — (따옴표나 구두점 없이) 키 이름/값 쌍을 지정합니다. 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 이메일을 변경하세요 루트 디렉토리에 파일을 생성하세요 .env, 키의 이름/값을 지정합니다. API, 바로 위에 표시된 것과 같습니다.

3. 배포

대략적으로 명확하고 자세하게 얀덱스.클라우드 그리고 그것을 거기에 어떻게 두는가 얀덱스 기능 내 기사에서 말했듯이 Bitrix 땅의 앨리스 — 이 나라를 모르는 분들과 그 외 모든 분들(그리고 귀국하신 분들)께는 짧은 만화(즉, 일련의 그림과 글)를 소개합니다.

만들다 지퍼- 보관소(예를 들어 이렇게 부르자) 메일러.zip), 여기에는 카탈로그가 포함됩니다. node_modules 및 파일 .env, 인덱스.js — 프로젝트 카탈로그의 모든 내용:

우리는 ...라는 이름으로 함수를 올바르게 생성합니다. 우편 발신인, 왼쪽 탐색 메뉴에서 선택하세요 편집기, 필수 필드를 입력하고 탭으로 전환합니다. ZIP 아카이브 우리는 아카이브를 로딩하고 있습니다 메일러.zip:

그리고 여기에 이전에 언급된 다운로드 옵션이 있습니다 API 키 프로젝트에 파일을 생성하는 대신 바로 여기에서 .env, 패키지를 설치하지 마세요 도 텐프. 하지만 우리는 이미 이 모든 것을 끝냈기 때문에 정보 제공 차원에서 보여드리겠습니다. 즉, 복제할 필요가 없습니다!

이제 오른쪽 상단 모서리에서 버튼을 누릅니다. 버전 만들기, 몇 초간 기다리세요. 모든 것이 준비되면 자동으로 섹션으로 이동합니다. 검토. 거기서 해당 옵션을 활성화하겠습니다. 공공 기능이를 통해 외부 세계와 상호 작용할 수 있습니다.

비문 반대편의 파란색 링크를 참조하세요. 통화 링크? 클릭해 보세요. 빈 브라우저 창이 열립니다... 하지만 기다리세요. 편지를 받았습니다.

이제 콘솔로 돌아갈 수 있습니다. SendGrid, 버튼을 누르세요 통합 확인. 시스템은 채널을 통해 모든 것을 검사하고 그 결과 다음과 같은 화면을 반환해야 합니다.

이제 다 아셨죠, 여러분(물론 소녀들도요) – 정말 간단하고 우아하죠! 더 많은 기사가 나올 겁니다. 이런 내용을 읽는 데 관심이 있다면 구독하여 아무것도 놓치지 마세요.

4. 도넛

출처 : habr.com