2018.05.02 GCPPythonTech Blog　

GAEでサクッとAPIサーバ構築

はじめに

Google App Engine(GAE)とは

GAEはGoogle Cloud Platform(GCP)で利用できるアプリケーション/サービスの一つです。

サービス分類はPaaSとなり、インフラの管理をプラットフォーム側が担ってくれますのでアプリケーション開発に集中することができます。本稿では、GAE上にPythonを利用して簡単なAPIサーバーを構築していきます。

補足情報

GAEにはスタンダード版とフレキシブル版が存在しますが、今回は「スタンダード版」を利用していきます。

無料枠で利用できる範囲での実装を想定しておりますが、何らかの事情により課金がされる場合があります。

必要な知識、準備

GCPのアカウント
Cloud SDKのインストールと準備
Python2.7
Flask
virtualenv(必要に応じて)

作業の流れ

CloudSDKの設定確認
権限の確認
GAEの立ち上げ
ディレクトリ構造
hello, world
ローカル環境でのテスト
デプロイ
アプリの拡張
関連サービス

CloudSDKの設定確認

GCPへのアクセス権限を確認します。下記コマンドを実行し権限が正しいか確認します。

ご自身のアカウントが表示されればOKです。

gcloud auth list

このステップが済んでいない場合は下記ドキュメントよりセットアップを行っていただく必要があります。

https://cloud.google.com/sdk/downloads?hl=ja

権限の確認

利用しているアカウントが「オーナー権限」であるかを確認します。左のスライドにある「IAMと管理」をクリックし、自身のアカウントがオーナー権限かを確認してください。（ご自身で作成されたアカウントであればデフォルトでオーナー）

コンソール画面

コンソール画面からIAMを選択

IAMに入りオーナー権限が付与されているか確認

ディレクトリ構造

開発環境の準備ができましたので必要なものを揃えていきます。

まずは下記ディレクトリ構造でファイル、ディレクトリを作成してください。

sample_app/　カレントディレクトリ
　┗　main.py　実行スクリプト
　┗　app.yaml　GAEの挙動が記載されている指示書
　┗　lib/　実行時に呼ばれるライブラリ群（GAEで3rdライブラリを利用したい場合は必要）
　┗　appengine_config.py　libをバインドするスクリプト
　┗　requirements.txt　ライブラリ情報

hello, worldの実装

それでは、GAEの挙動を掴むために「hello, world」アプリの実装を行っていきます。

app.yaml

runtime: python27
api_version: 1
threadsafe: yes

handlers:
- url: /.*
  script: main.app

libraries:
- name: flask
  version: 0.12

main.py

from flask import Flask 

app = Flask(__name__)

@app.route('/')
def hello():
    return 'hello, world', 200

appengine_config.pyに下記コードを記述

from google.appengine.ext import vendor
vendor.add('lib')

requirements.txt にライブラリ情報をロード

pip freeze  > requirements.txt

libディレクトリを作成しrequirements.txtに記載されてるライブラリをインポートする

mkdir lib
pip install -r requirements.txt -t lib

デプロイする準備が整いました。

正しくコードの記述がされていれば、デプロイ後に指定のURLにアクセスすると「hello,world」と記載されます。

ローカル環境でのテスト

デプロイする前にローカルテストを行います。テスト環境が用意されているのでそちらを利用していきます。

Cloud SDKをインストールした時点でテストができるスクリプトが用意されており、パスはこちらとなります。

/<your>/<path-to>/google-cloud-sdk/bin/dev_appserver.py

ローカル環境の立ち上げには下記コマンドを実行します。

dev_appserver.py app.yaml

http://localhost:8000/にアクセスし管理画面を確認

http://localhost:8080/に hello, world が表示されることを確認します。

デプロイ

ローカルで正しく動くことが確認できたので、デプロイしていきます。

下記コマンドで簡単にデプロイが可能です。

gcloud app deploy app.yaml

しばらくするとデプロイが完了し、アクセスできる状態になります。（軽いアプリでも1 – 2分程度時間がかかります）

アプリの拡張

GAEの利用方法自体はこれまでのステップ通りですが、hello,worldを拡張し実践に即したアプリに拡張していきます。

まずは、apps ディレクトリを作成し、処理周りのこの中にまとめていきます。

sample_app/  カレントディレクトリ
　┗ apps /　
　　┗  model.py　CRUD関連の処理をまとめる
    ┗  view.py  　コントローラ
　┗　main.py　Blueprintを呼びだす
　┗　app.yaml　GAEの挙動が記載されている指示書
　┗　lib/　実行時に呼ばれるライブラリ群（GAEで3rdライブラリを利用したい場合は必要）
　┗　appengine_config.py　libをバインド
　┗　requirements.txt　ライブラリ情報

model.py

# -*- coding: utf-8 -*-
import hashlib

class Hash(object):
    def __init__(self,key):
        self.key = key

    def get_hash(self):
        return hashlib.sha256(self.key).hexdigest()

view.py

# -*- coding: utf-8 -*-

from flask import Blueprint, request, jsonify
from .model import Hash

app = Blueprint('hello', __name__)


@app.route('/', methods=['GET'])
def hello():
    return 'hello, world', 200


@app.route('/arg', methods=['GET'])
def arg():
    key = request.args.get("key", type=str)
    hash_obj = Hash(key)
    val = hash_obj.get_hash()
    return val, 200


@app.route('/form', methods=['POST'])
def form():
    req = request.form
    val = req.get('key')
    return jsonify(data=val), 200

main.py

# -*- coding: utf-8 -*-
from flask import Flask
from apps.view import app as hello_app

app = Flask(__name__)

modules_define = [hello_app]
for _app in modules_define:
    app.register_blueprint(_app)

ローカルテストで問題なく結果が表示されていることを確認し、問題なければ先ほどと同様の手順でデプロイを行います。

関連サービス

これまでのステップでは実装とデプロイのみ行ってきましたが、デプロイした結果やGAEの便利機能を少しだけ紹介していきます。

要件次第ではGAEと関連アプリだけでバックエンド開発が済んでしまうほど多機能となりますので、詳細は個別でお調べいただければと思います。

バージョン管理とトラフィックのマイグレーション

デプロイの状況をコンソールから確認することが可能です。

また、（個人的には）GAEの機能の中でもTOP３に入るおすすめ機能が「トラフィックのマイグレーション」です。

一言で言うと、バージョン管理が「１クリック」で行える機能になります。

バックエンドでバグが見つかった際にはすぐにバージョンを戻せるので障害の影響を限定的にすることが可能です。

フロントエンドにおいては、どんどんリリースしていき、バグ・修正点が見つかり次第ロールバックすると言う手法も取ることも可能です。