Yandex 기능은 메일을 보냅니다

오늘 우리는 소위를 만들 것입니다. 얀덱스 기능 (공식 명칭 Yandex 클라우드 기능), 메일링 서비스와 공모 SendGrid 평화롭게 자고 있는 사용자에게 "비누"를 보낼 것입니다(농담입니다. 우리 모두 스팸에 반대한다는 것을 알고 있습니다).

나는 또한 전통적인 서버의 반대자(광신주의는 아님)이자 소위 말하는 지지자입니다. 서버리스 (서버리스) 솔루션은 서버를 관리하는 것을 좋아하지 않으며(어떻게 하는지도 모르기 때문에) 로드되지 않은 시간에 대한 비용을 지불해야 하기 때문입니다. 또 다른 것은 기능입니다. 나 없이 누군가 서비스를 제공하고, 나는 통화 요금만 지불한다. 2019년 XNUMX월 초 Yandex는 Yandex 클라우드 기능 - 러시아 연방 최초인 것 같습니다. 서버리스. 그리고 특히 좋은 점은 앨리스의 스킬은 일반적으로 무료이기 때문에 그 이후로 내 주변 시야에 있다는 것입니다. 하지만 이미 시작해보자.

이 시나리오를 상상해 봅시다. 귀하의 애플리케이션(예: Alice의 스킬 기억하고 잊어버리세요 그건 그렇고, 또한 작동합니다 Yandex 기능)는 사용자에게 추가 옵션과 같은 디지털 제품을 구매하도록 초대하고 사용자는 결제를 수행합니다. 일종의 결제 시스템(혼란스러울 정도로 유사함) Yandex 주차) 결제를 처리한 후 귀하가 제공한 주소로 보냅니다. 그러면 전화할 수 있는 링크가 제공됩니다. 얀덱스 기능) HTTP-결제 금액, 이름, 전화번호, 이메일 등 결제 세부정보가 포함된 요청입니다. 우리는 이 데이터를 다음과 같은 방식으로 처리하려고 합니다. 예를 들어 금액 확인, 데이터베이스에 적절한 항목 작성, 사용자에게 보내기 SMS и 이메일 지불 수령 확인 및 추가 지침과 함께. 그래서 당신 자신 마이크로서비스.

방법에 대해 Yandex 기능 데이터베이스에 항목을 만듭니다 클라우드 소방서 우리는 이미 튜토리얼에서 살펴봤죠 앨리스는 모든 것을 기억한다 (그리고 앞으로는 다른 데이터베이스에 대한 예를 고려해 볼 것입니다. Yandex 데이터베이스). 사용자에게 보내는 방법에 대해 SMS 우리의 애플리케이션을 다음과 통합합니다. Yandex.Money — 가까운 시일 내에 정리하겠습니다. 이제 편지 보내기를 처리해 보겠습니다.

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 protected]
매개변수 값 이메일 다음과 같이 얻을 수 있습니다:

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-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. 배포

에 대해 다소 명확하고 자세하게 얀덱스.클라우드 그리고 거기에 어떻게 놓는지 얀덱스 기능 내 기사에 설명된 Bitrix 땅의 앨리스 - 나는 무지한 사람들을 이 나라로 보내고 다른 모든 사람들(및 돌아온 사람들)을 위해 작은 만화책(예: 일련의 그림과 텍스트)을 보냅니다.

만들다 지퍼-archive(예를 들어, 메일러.zip), 여기에는 디렉토리가 포함됩니다. node_modules 및 파일 .env, index.js - 프로젝트 카탈로그의 모든 것:

우리는 이름이... 올바르게 -인 함수를 만듭니다. 우편 발신인, 왼쪽 탐색 메뉴에 입력합니다. 편집기, 필수 항목을 입력하고 탭으로 전환하세요. ZIP 아카이브 우리 아카이브를 다운로드하세요 메일러.zip:

이전에 언급한 다운로드 옵션은 다음과 같습니다. API 키 프로젝트에서 파일을 생성하는 대신 여기에서 직접 .env, 패키지를 설치하지 마십시오 도 텐프. 하지만 우리는 이미 이 모든 작업을 수행했으므로 참고용으로만 보여 드리겠습니다. 즉, 복제할 필요가 없습니다!

이제 오른쪽 상단에 있는 버튼을 클릭하세요. 버전 만들기, 그리고 몇 초 정도 기다립니다. 모든 것이 준비되면 자동으로 해당 섹션으로 이동합니다. 검토. 거기에서 옵션을 활성화하겠습니다 공공 기능외부 세계와 상호작용할 수 있도록 말이죠.

비문 반대편에 파란색 링크가 표시됩니다. 통화 링크? 클릭하세요. 빈 브라우저 창이 열립니다... 그런데 잠깐만요. 이메일을 받았습니다:

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

그게 다입니다, 남자들 (그리고 여자들도 물론) - 모든 것이 정말 매우 간단하고 우아합니다! 더 많은 기사가 있을 예정입니다. 이런 내용을 읽고 싶은 사람이 있다면 놓치지 않도록 구독하세요.

4. 기부

출처 : habr.com