Cloud Run Functionsにリニューアル
前回Cloud FunctionsがCloud Runに統合されCloud Run functionsになったことを紹介しました。
今回は実際にCloud Run functionsを利用してみたいと思います。
URL叩く→メールを送信
個人で開発したサイトやシステムのエラー時にメールで通知が行くと便利ですが、いちいちメール送信のためのコードを書くのは面倒です。
そんなときにメール通知用のCloud Run functionsを作っておくとURLを叩く(httpでPost)だけで、メールの送信をすることができます。
↓このURLからPostする（件名、内容は送信時に指定できます）
今回はこちらの作成例を紹介します。（Google Cloudのアカウント、アプリパスワードが必要です。）
アプリパスワードはこちらから（セキュリティ設定から2段階認証が必要です）
※こちらを作成したアカウントからメールが送信されます
Cloud Run Functions作成
Cloud Runのページを開きます（前回の通りCloud Functionsのページはなくなりました）。[関数を作成]をクリック。
今回はソースを直接入力するので[インライン エディタで関数を作成する]を選択します。サービス名を適当に付けてリージョンを選んで下さい。あまり変わらないですがとりあえずリージョンは東京にしておきます。
ランタイムは今回はPythonにします。トリガーは今回設定しませんがスケジューラーで利用するときは必要です。どこでも呼べるように未認証の呼び出しを許可しますが、緊急の通達など万が一でも呼び出されたらまずいものであれば認証を設定して下さい。
今回はリクエストベースにします。そうすると呼び出された時に起動するので動作が遅くなりますが費用は安く抑えられます。
次にコンテナの設定から[変数とシークレット]タブに移ります。
ここに環境変数を設定します。今回は送り元のアドレス（上のアプリパスワードを発行したGoogleアカウントのアドレス）、送り先のアドレス（こちらは呼び出し時に指定することもできますが、固定としました）、アプリパスワードを設定しておきます。
[完了]を押して保存し、特に設定することはないので [作成] を押します。
ソースの編集画面になります。今回は次のようにしました。
import functions_framework
import os
from smtplib import SMTP
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
GMAIL_HOST = 'smtp.gmail.com'
GMAIL_PORT = 587
def send_email(account, password, msg):
# Gmailのサーバ接続
server = SMTP(GMAIL_HOST, GMAIL_PORT)
# STARTTLSで暗号化
server.starttls()
# ログイン処理
server.login(account, password)
# メールを送信する
server.send_message(msg)
# 閉じる
server.quit()
def make_msg(from_email, to_email, title, content):
# MIMETextでメールの内容を作成作成
msg = MIMEMultipart()
msg['Subject'] = title
msg['From'] = from_email
msg['To'] = to_email
message = content
msg.attach(MIMEText(message, "plain"))
return msg
@functions_framework.http
def hello_http(request):
request_json = request.get_json(silent=True)
if not request_json:
raise RuntimeError("get json error")
if 'title' not in request_json or 'content' not in request_json:
raise RuntimeError("json key error")
try:
title = request_json['title']
content = request_json['content']
# アカウント設定
account = os.environ['MAIL_FROM']
password = os.environ['PASSWORD']
# メールの送信元・送信先設定
from_email = os.environ['MAIL_FROM']
to_email = os.environ['MAIL_TO']
# メッセージ作成
msg = make_msg(from_email, to_email, title, content)
# # メールの送信
send_email(account, password, msg)
return 'send success'
except Exception as e:
print(e)
raise RuntimeError("mail send error")
Smtplibによるメールの送信です。Smtplibについて詳しくはこちらを参考にして下さい。
デフォルトのエントリーポイントが"hello_http"なのでそのままこちらの名前で関数を作りました。Functionが起動するとこちらの関数が呼び出される形になります。変えても問題ありません。
request.get_jsonでPost時のJSONを受け取れます。今回はタイトルと内容だけを受け取りましたが、送信先アドレスを受け取って使うこともできます。
今回はrequirements.txtを追加しませんでしたが、必要なパッケージがあるなら追記します。また「＋」マークをクリックで別のファイルも追加できます。
では [保存して再デプロイ] でデプロイします。
少し時間がかかります。
エラーにならなければOKです。エラーの場合はログを確認してソースを再度修正して下さい。
[テスト]ボタンからテストしてみます。curlするだけなのでそんなに意味はないですが認証の問題かどうか把握するためにやっておきます。
POST時のテスト用JSONを設定します。今回は"title"と"content"です。
[Cloud Shellでテストする]をクリックします。
テスト用スクリプトが打ち込まれるのでEnterだけ押して下さい。
エラーにならず、メールが送れていたら成功です。（今回はコードで"send success"を返すようにしていますが、何も設定していなければ表示されません。）
後は発行されたURLを使ってどっからでも送信してみて下さい。
WindowsのPowerShellから呼び出す例です。
curl.exe -X POST https://func-send-mail-1043149056745.asia-northeast1.run.app -H "Content-Type: application/json" -d '{ \"title\": \"title_test\" , \"content\": \"content_test\" }'
※ここでエラーとなる場合はこのスクリプトか未認証の呼び出しが許可されていないと思われます
Pythonから呼び出す例です。
import requests
import json
MAILHOOK = "https://func-send-mail-175332392539.asia-northeast1.run.app"
json_data = {
"title": "title_test",
"content": "content_test"
}
response = requests.post(
MAILHOOK,
data=json.dumps(json_data),
headers={"Content-Type": "application/json"}
)
おわりに
何かの役に立てば幸いです！
見る方多ければトリガーを作ってスケジューラーから呼び出す方法を紹介したいと思います！