Pythonで作るAPIサーバー

Slide 1

Slide 1 text

Pythonで作るAPIサーバー Oracle Cloud Hangout Cafe – Season 6 #4 Kyotaro Nonaka Solutions Architect Oracle Corporation Japan

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Copyright © 2022, Oracle and/or its affiliates 8 Python? Anaconda? • Python: GeneralなPython → 今回はこっち！ • Anaconda: 機械学習などに利用するディストリビューション Python2? Python3? • 2系と3系で互換性なし！ • venvやpyenvなどで開発環境を分けて使い分け • 対応ライブラリ数に違いあり？とはいえ2系はサポートが2020年1月に終了 • ※この資料は全てpython3前提で記載しています Pythonのインストール • CentOS 8系であればPython3.6がプリインストール Python超基礎 Pythonの環境構築について

Slide 9

Slide 9 text

Copyright © 2022, Oracle and/or its affiliates 9 PyPI(pip) • Pythonパッケージのインストールなどを行うユーティリティ • Python 3.4以降には標準で付属 venv(virtualenv) • 公式が提供するPythonのパッケージ管理ツール • Pythonプロジェクト毎に管理が可能 • バージョンを管理するPyenvとは使い分け(もしくは併せて利用) IDE(VS Code Jupyter) • VS Codeなどの多機能エディタにはPythonでの開発を支援する拡張機能が存在 • インタラクティブコンピューティング用としてのJupyter NotebookはPythonでの利用が一般的 Python超基礎 Pythonの環境構築について

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Copyright © 2022, Oracle and/or its affiliates 12 Django • 2005年リリース • MTVアーキテクチャ(後述) • 大規模アプリケーション • 主な事例 • Instagram • Mozilla • Bitbucket Flask • 2010年リリース • マイクロフレームワーク • 小規模アプリケーション/サービス • 主な事例 • Netflix • reddit • trivago FastAPI • 2019年リリース • マイクロフレームワーク • 小規模アプリケーション/サービス • 主な事例 • Uber(一部) • Netflix(一部) PythonのWebフレームワーク

Slide 13

Slide 13 text

Copyright © 2022, Oracle and/or its affiliates 13 アメリカのカンザス州 Lawrence の新聞社のウェブ部門である World Online で開発 • 現在はボランティアチームによって運営 • https://www.djangoproject.com/foundation/teams • オープンソースライセンス(BSDライセンス) MTVアーキテクチャ • Model: データを取得 • Template: どのようにデータを表示するかを規定 • View: どのデータを表示するかを規定 • いわゆるControllerの機能はフレームワークに内包 • urls.pyによってルーティングを記述 Django ブラウザ urls.py View Model Template DB

Slide 14

Slide 14 text

Copyright © 2022, Oracle and/or its affiliates 14 Django – Getting Started 簡単に動かす $ sudo python -m pip install Django $ python -m django --version import django print(django.get_version()) ■hello.py $ python hello.py

Slide 15

Slide 15 text

Copyright © 2022, Oracle and/or its affiliates 15 プロジェクトを作成生成されたプロジェクトの構造 Django – Getting Started Djangoプロジェクトを作成 $ django-admin startproject mysite mysite/ manage.py mysite/ __init__.py settings.py urls.py asgi.py wsgi.py • 外側のmysite/: プロジェクトのルートディレクトリ • manage.py: Djangoプロジェクトを操作するためのコマンドラインユーティリティ • 内側のmysite/: このプロジェクトの実際のPythonパッケージ • __init__.py: このディレクトリがPythonパッケージであることをPythonに知らせるための空のファイル • settings.py: Djangoプロジェクトの設定ファイル • urls.py: DjangoプロジェクトのURL宣言 • asgi.py: プロジェクトを提供する ASGI 互換 Web サーバーのエントリポイント • wsgi.py: プロジェクトをサーブするためのWSGI互換Webサーバーとのエントリーポイント

Slide 16

Slide 16 text

Copyright © 2022, Oracle and/or its affiliates 16 サーバーの起動開発用サーバー Django – Getting Started Djangoプロジェクトの起動 $ django-admin startproject mysite #IP:portはオプション Watching for file changes with StatReloader Performing system checks... System check identified no issues (0 silenced). You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions. Run 'python manage.py migrate' to apply them. November 28, 2022 - 06:45:21 Django version 3.2.16, using settings 'mysite.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Copyright © 2022, Oracle and/or its affiliates 18 Djangoでは、1つのProjectに複数のアプリケーションを持つので、 • どのアプリケーションにルーティングするか • どの関数にルーティングするかを分けて管理する Django – Getting Started Djangoアプリケーションのルーティング URLs (Project) View Model Template DB ブラウザ URLs (App1) URLs (App2)

Slide 19

Slide 19 text

Copyright © 2022, Oracle and/or its affiliates 19 Django REST frameworkを利用 API認証のためのユーザー作成 • シリアライザー Demo: Djangoで簡単なAPIを作成 $ sudo python -m pip install djangorestframework $ python manage.py createsuperuser --email admin@example.com --username admin

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

Copyright © 2022, Oracle and/or its affiliates 22 Armin Ronacherによって開発 • オープンソースライセンス(BSDライセンス) テンプレートエンジンとしてJinja2、WSGIツールキットとして Werkzeug(ヴェルクツォイク)を利用 • Jinja2: pythonで利用できるHTMLテンプレートエンジン • Werkzeug: WSGIアプリケーションのためのユーティリティを集めたライブラリ • WSGI(Web Server Gateway Interface): Pythonにおける、 WebアプリケーションとWebサーバを接続する標準仕様 • ASGI(Asynchronous Server Gateway Interface)WSGIの後継仕様で、WebSocketと非同期通信をサポートデータベースの抽象化など、必要に応じて拡張(Extension)を行うのでいわゆるマイクロ・フレームワークとなる Flask ブラウザ Werkzeug Webサーバー

Slide 23

Slide 23 text

Copyright © 2022, Oracle and/or its affiliates 23 環境構築とFlaskのインストール Flask – Getting Started 簡単に動かす $ mkdir myproject $ cd myproject $ python -m venv venv $ . venv/bin/activate $ pip install Flask ■hello.py 何も指定しなければ text/html形式で返却 • dict型などのJSONオブジェクトをそのまま返却すれば application/jsonになる Responseを利用することで Content-typeを指定可能

Slide 24

Slide 24 text

Copyright © 2022, Oracle and/or its affiliates 24 • http://127.0.0.1:5000/にアクセス Flask – Getting Started 簡単に動かす $ export FLASK_APP=hello #起動するアプリをFlaskに伝える $ export FLASK_ENV=development #サーバーを開発モードに設定 $ flask run * Serving Flask app 'hello' (lazy loading) * Environment: production WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead. * Debug mode: off * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Slide 25

Slide 25 text

Slide 26

Slide 26 text

Slide 27

Slide 27 text

Slide 28

Slide 28 text

Copyright © 2022, Oracle and/or its affiliates 28 Flaskではディレクトリ構造などが特に定められているわけではないプラクティスとしては以下 • flaskr/: アプリケーションのコードとファイルを含んだPythonパッケージ • tests/: テストモジュールを含んだディレクトリ • venv/: Flaskとその他の依存対象がインストールされたPythonの仮想環境 • その他のファイル: インストールなどに利用 Flask – Getting Started プロジェクトのレイアウト

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Copyright © 2022, Oracle and/or its affiliates 30 @tiangolo (Sebastián Ramírez)によって開発 • Python 3.6 以降でAPI を構築するためのWeb フレームワーク • オープンソース(MIT) REST APIの実装に特化 • OpenAPI準拠 • 自動ドキュメント生成 • プラグインによる拡張 Starlette/Pydanticベース • Starlette/Uvicorn: Web部分(ASGI Server) • Pydantic: データ部分(Validation/Serialization) FastAPI FastAPI Starlette Pydantic Uvicorn

Slide 31

Slide 31 text

Copyright © 2022, Oracle and/or its affiliates 31 環境構築アプリケーションの作成 FastAPI – Getting Started 簡単なアプリの作成 $ mkdir fastapi $ cd fastapi $ python -m venv venv $ . venv/bin/activate $ pip install fastapi $ touch main.py ■ main.py

Slide 32

Slide 32 text

Copyright © 2022, Oracle and/or its affiliates 32 ASGIサーバーのインストールサーバーの起動実行 FastAPI – Getting Started アプリを実行 $ pip install "uvicorn[standard]" $ uvicorn main:app --reload INFO: Will watch for changes in these directories: ['/home/opc/python/fastapi'] INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) INFO: Started reloader process [3157492] using watchgod INFO: Started server process [3157494] INFO: Waiting for application startup. INFO: Application startup complete. $ curl -X GET http://127.0.0.1:8000 {"Hello":"World"}

Slide 33

Slide 33 text

Slide 34

Slide 34 text

Slide 35

Slide 35 text

Slide 36

Slide 36 text

Slide 37

Slide 37 text

Slide 38

Slide 38 text

Copyright © 2022, Oracle and/or its affiliates 38 • cx_Oracleの名前が変わり、今後はpython-oracledbの利用が推奨 • 現在Djangoはpython-oracledbをネイティブ・サポートしていない • ThinモードとThickモードがあり、ThinモードではOracle Clientライブラリを必要としない • SODAなどの一部機能を利用する場合はThickモードを利用 • Thickモードでは引き続きOracle Clientライブラリが必要 python-oracledb Driver | cx_Oracle Driver PythonでOracle Databaseを使用するためのドライバ #インストール $ pip install oracledb –-upgrade

Slide 39

Slide 39 text

Slide 40

Slide 40 text

Slide 41

Slide 41 text

Copyright © 2022, Oracle and/or its affiliates 41 DjangoでAutonomous Databaseと接続するために必要な作業 • Oracle Client のダウンロード&インストール • cx_Oracleのインストール • Walletをダウンロード/展開して中身のcwallet.sso, sqlnet.ora, tnsnames.ora を配置(下記どちらか) • /usr/lib/oracle//client64/lib/network/adminに配置 • 任意の場所 • 任意の場所に配置した場合、sqlnet.oraの中身を修正(青枠の部分をWalletのディレクトリに変更)する必要がある • 環境変数としてTNS_ADMINにWalletの配置先を設定 • 環境変数としてLD_LIBRARY_PATH=Oracle Clientのインストール先を指定各フレームワークでデータベースと接続 Djangoで実装 WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="$HOME/Cloud/DB_WALLETDIR"))) SSL_SERVER_DN_MATCH=yes $ pip install cx_oracle

Slide 42

Slide 42 text

Copyright © 2022, Oracle and/or its affiliates 42 • settings.pyの変更 • Djangoの実行(Djangoのデフォルト画面が出れば接続成功) • 上手くいかない場合はpython manage.py migrate すれば上手くいく場合が多い各フレームワークでデータベースと接続 Djangoで実装 (続き) $ python manage.py runserver

Slide 43

Slide 43 text

Copyright © 2022, Oracle and/or its affiliates 43 FlaskはDBとの接続部分をフレームワークとしては持たない • 単純にpython-oracledbをインストールすれば良い • ADBとの接続はWalletを利用した接続が可能とは言えORMがないとデータが扱いづらいので SQL Alchemyを利用(後述) 各フレームワークでデータベースと接続 Flaskで実装

Slide 44

Slide 44 text

Copyright © 2022, Oracle and/or its affiliates 44 FastAPIもDBとの接続部分をフレームワークとしては持たない • 単純にpython-oracledbをインストールすれば良い • ADBとの接続はWalletを利用した接続が可能とは言えORMがないとデータが扱いづらいのでこちらもSQL Alchemyを利用(後述) 各フレームワークでデータベースと接続 FastAPIで実装

Slide 45

Slide 45 text

Copyright © 2022, Oracle and/or its affiliates 45 ファイルを2つ準備 • Dockerfile • Requirements.txt • pip install していることからわかように、Djangoプロジェクト実装時にインストールが必要なパッケージをここにリストする • 例えば今回は django REST Frameworkも追加するこれだけ準備すれば、あとはdocker build –t ~~ . だけでよい各フレームワークでコンテナ化 Djangoで実装 ■Dockerfile ■requirements.txt

Slide 46

Slide 46 text

Slide 47

Slide 47 text

Slide 48

Slide 48 text

Copyright © 2022, Oracle and/or its affiliates 48 Django REST FrameworkはORM含めてフレームワーク化されている • 以下コマンドを実行 • 実行結果より、テーブルからmodel.pyの中身を取得できる(自動で生成される！) Demo: Djangoで簡単なCRUDアプリケーションを実装 $ python manage.py inspectdb

Slide 49

Slide 49 text

Slide 50

Slide 50 text

Copyright © 2022, Oracle and/or its affiliates 50 ORMとしてFlask-SQLAlchemy(Extension)を利用 Flask-SQLAlchemyはcx_Oracleが必要なのでインストール djangoでATPと接続(p41)と同様の手順を実施 Demo: FlaskでORM(Object Relational Mapper)を利用準備 $ pip install flask-sqlalchemy $ pip install cx_Oracle • PythonのORM • オープンソース(MIT) • 様々なデータベースをサポート Model Notes(テーブル名) ID: Number(PK) Text: VARCHAR2 class Notes id = … text= … ※ORMとは: オブジェクトとRDBの間でデータ形式の相互変換を行うもの

Slide 51

Slide 51 text

Slide 52

Slide 52 text

Slide 53

Slide 53 text

Slide 54

Slide 54 text

Slide 55

Slide 55 text

Copyright © 2022, Oracle and/or its affiliates 55 gRPCにはコンポーネントとして、 ServerとClientがある Server • リクエストを受け、レスポンスを返却するサービス層 Client • リクエストを送信し、レスポンスを受け取る • 内部的にServerのStubを保持しており、リクエスト送信の実装は、このStubのメソッドを実行する形となる gRPCのおさらい – gRPCのコンポーネント

Slide 56

Slide 56 text

Protocol Buffersによる実装 • Googleが開発(2008年にオープンソース化)したシリアライズフォーマット • IDL(インターフェース記述言語)を用いて、任意の言語のボイラープレートコードを生成 • 結果的に、リクエスト/レスポンスのスキーマを最初に定義する開発スタイルとなる • 多言語に対応しており、異言語間のやり取りが発生しうる Microservicesアプリとの相性が良い • 型安全なスキーマ • デフォルトはこのProtocol Buffersであるものの、gRPCそのものはJSONなどの形式にも対応 gRPCの特徴 – Protocol Buffers Copyright © 2022, Oracle and/or its affiliates 56 ■ .protoファイル(IDL)

Slide 57

Slide 57 text

Copyright © 2022, Oracle and/or its affiliates 57 gRPCのインストール gRPC toolsのインストール gRPC公式のサンプルを使用 https://grpc.io/docs/languages/python/quickstart/ gRPC with Python Quick start $ pip install grpcio $ pip install grpcio-tools # Clone the repository to get the example code: $ git clone -b v1.50.0 --depth 1 --shallow-submodules https://github.com/grpc/grpc # Navigate to the "hello, world" Python example: $ cd grpc/examples/python/helloworld

Slide 58

Slide 58 text

Copyright © 2022, Oracle and/or its affiliates 58 examples/python/helloworldディレクトリでgRPCサーバーを実行 ※環境によってはbuilder.pyが存在しないといったエラーが出るので、その場合はprotobufをアップデート別ターミナルを開き、gRPCクライアントを実行(※venvのactivateを忘れないように！！！) gRPC with Python Quick start 続き $ python greeter_server.py $ pip install protobuf==4.21.0 $ python greeter_client.py Will try to greet world ... Greeter client received: Hello, you!

Slide 59

Slide 59 text