Google Cloud Funcions(以下、GCF)のランタイムが Node.js 6 に加え、Node.js 8 と Python3.7 がベータ版として利用可能になっています。今回は、GCP公式ブログで Laurent Picard 氏の記事「Python サーバレスファンクションを数分でデプロイする」を参考に GCF を解説します。
Laurent Picard 氏の記事 URL:https://medium.com/google-cloud/deploying-a-python-serverless-function-in-minutes-with-gcp-19dd07e19824
本記事を読まれた方は是非とも Laurent Picard 氏の記事を読んでいただければ、喜んでいただけることでしょう。
目次
-
GCF を3分で実行してみる
-
GCF の監視(Stackdriver)
-
まとめ
-
GCF を3分で実行してみる
GCF をシンプルに説明すると「関数を実行させる GCP サービスの1つ」です。AWS であれば Lambda に相当します。文章より画面で見る方がわかりやすいため、以下の手順で GCF の関数を作りましょう。
<手順>
GCP コンソールで Cloud Functions の画面を開く
ボタン「関数の作成」を押す
<各項目の設定>
・名前:get-ebooks
・割り当てるメモリ:256MB
・トリガー:HTTP
・ソースコード:インラインエディタ
・ランタイム:Python3.7(ベータ版)
・main.py:GitHub からコピー&ペースト
このプログラムは、Google Books API を用いて、書籍の著者を検索キーとし、書籍のページ数が多い順にソートします。コードは以下に公開されています。
https://github.com/PicardParis/cloud-snippets/blob/master/python/gcf-get-ebooks/main.py
・requirements.txt:変更なし
・実行する関数:get_ebooks_by_author
・リージョン:asia-northeast1
入力後、以下のようにコードが記述されていることを確認し、保存ボタンを押す。
get-ebooks をクリックし「トリガー」を開くと URL が表示されてます。この URL にアクセスしたときがトリガーとなり、GCF で作成した関数が実行されます。
<関数実行後のブラウザ画面>
上図の URL を開くと、指輪物語(ロード・オブ・ザ・リング)の作者 JRR Tolkien 氏の書籍がページ数の多い順に表示されています。検索元は Python code に書かれているとおり Google Books API を使っています。また、検索する際の言語(lang)は英語(en)となってます。
URL にパラメータ author , lang を追加することで、作者や言語指定ができます。2018年10月よりアニメ「ジョジョの奇妙な冒険 黄金の風」が放送開始されたので、荒木飛呂彦先生&日本語(jp)で検索してみることにしましょう。
URI:https://asia-northeast1-toru-kazama.cloudfunctions.net/get-ebooks?lang=jp&author=荒木飛呂彦
12件ヒットしました。ページ数が表示されないのは Google Books に値が入っていないためです。好きな作者で検索したり、Python code の修正 / 検索すると良いでしょう。
あっという間に、GCF で何ができそうかイメージが浮かんだと思われます。サーバを起動せず、関数実行時に課金されるサーバレスアーキテクチャに必要な GCP サービスの1つが GCF です。
<GCF のダッシュボード>
関数実行後、「呼び出し関数」「実行時間」「メモリ使用量」の3種類が可視化できます。下図はメモリ使用量のグラフです。今回使った簡易な Python code でも約40MBを消費していることがわかります。
関数実行に問題がある場合、メモリ不足が要因の1つと考えられますので、最低でもメモリ使用量は「監視」が必要です。GCF のメモリを128MB~2GBと柔軟に変更することで解決が期待できます。
ほか、実行時間はデフォルトで60秒後にタイムアウトしますので、処理要件に応じて code 修正やタイムアウト値の変更をすることになります。
- GCF の監視(Stackdriver)
Stackdriver で GCF のメモリ使用量の監視設定を行います。まず、GCP コンソールの左ペインから「モニタリング」をクリックします。Stackdriver の初期設定を行ってていない場合は画面に従って設定を完了させましょう。
Alerting から Create a Policy を選択します。
下図のような画面が表示されますが、メモリ監視するには右上の「OPT IN」に変更する必要があります。OPT IN をクリックしましょう。
さっそく「Conditions」の設定を行います。ADD CONDITION をクリックし、下表のとおり入力してください。
・Target
・Configuration
これで Conditions の設定が完了しました。
次は Notifications (optional) で「Email」を選択し、メールアドレスを入力します。Documentation (optional) は、メール本文にマークダウン形式でコメントを追加することができます。障害時の対応方法をこの部分に記載すると良いでしょう。
Name this policy は、ポリシー名を入力する必要があるので「GCF」とします。
すべての設定が完了しましたので SAVE ボタンを押します。これで Stackdriver の監視設定は「1分間隔に GCF のメモリ使用量が 30MB を超過した場合、指定のメールアドレスに内容を送信する」となります。
最後に GCF の関数(URL)を再実行し、着信したメールを開いてみましょう。数分後に以下のようなメールが届いているはずです。メモリ使用量が 30 MB(31,457,280 Byte) を超過したことを示しています。
- まとめ
GCF の設定は非常に簡単です。ただ、運用を考えると GCF のメモリ使用量は監視しておいた方が良いため、Stackdriver の監視設定(一例)を記載しました。つまずくところが「2点」ほどあったと思います。「OPT IN」と「メモリ値の計算方法」ですので Tips として覚えておきましょう。
GCF はサーバレスアーキテクチャを実現させるための重要なサービスの1つです。Pub/Sub や GCS を基点とした cool なサーバレスアーキテクチャを経験すると GCP の活用範囲は広くなります。この記事を機会に是非とも GCF を触ってみましょう。プログラムが書けなくても上述のコードを C&P するだけで体験できます!
GCP全般について、クラウドエースでは豊富な技術者によるサポートで快適なGCP生活のお手伝いをしておりますので、是非ご相談ください。