原文はこちら
マイクロサービスとサーバレスは、これまでにも増して人気を得てきており、世界中のチームがこれらのパターンとアーキテクチャに非常に迅速に適応してきています。しかし、大規模にマイクロサービスとサーバレスを活用しようとする際にこうしたチームがまず直面するのが、フロントエンドとモバイルAPIのとても多くの、そして複雑なエンドポイントを管理しなければならないという課題です。そのため、多くのチームではバックエンドをシンプルにし、すべてのクライアントからの「シングルポイント・オブ・エントリー」にするために、API Gatewayを採用しています。API Gatewayはまた、アーキテクチャの中の個々のファンクションではなくゲートウェイのレベルで、レート制限やCORS、認証を簡単に実装できるようにしてくれます。
このブログポストではOracle Cloudの最新サービスのひとつであるAPI Gatewayを概覧していきます。
以下の順で進めていきます:
- "Hello World"サーバレスファンクションの作成とデプロイ
- API Gatewayに適したサブネットの作成
- ダイナミックグループの作成とAPI Gatewayに必要なポリシーの適用
- Gatewayの作成
- Gatewayへの仕様のデプロイ
- Gatewayのテスト
"Hello World"サーバレスファンクションの作成とデプロイ
以前にもOracle Functionsについてのブログを書いています→Oracle Functions:開発者のためのクイックスタートガイド。ドキュメントはとてもお役立ちですし、他にもOracleのホステッドサーバレスをどのように使うかについてのたくさんの情報がありますので、ここではサーバレスのための環境をどのようにセットアップするかについての詳細には立ち入りません。あなたはOracle Functionsのことを知っているものとして進めていきますので、必要であればこれらのリンクを参照してくださいね。
ではシンプルなサーバレスアプリケーションとファンクションを作成し、そのファンクションをデプロイしてみましょう。このファンクションの内容は今回関係なくて、ただ後にGatewayのテストで使いたいだけです。なので、ファンクションはサンプルの"Hello World"のままにしておきます。ランタイムもここでは関係ないので、Oracle FunctionsとFn Projectでサポートされているものならなんでもよいです。
この時点でファンクションを
fn
CLIで呼び出しできます:
しかし、HTTP(S)経由やOCI SDKを利用してファンクションを直接呼び出しするにはリクエストへの署名が必要です。ファンクションをインスペクトして呼び出しエンドポイントを取得してみましょう:
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/aa5b62666706406504136106baffa8e5/fn_inspect.jpg)
注!
fn inspect
コールから id
をコピーしておきましょう。これが後で必要になるファンクションのOCIDです!
呼び出ししようすると
401 Unauthorized
で失敗します:
But once we put our serverless function behind our gateway we can invoke it via HTTPS. Let's move on!
しかし、Gatewayのうしろにサーバレスファンクションを配置することによって、HTTPS経由で呼び出しができるようになります!やってみましょう!
しかし、Gatewayのうしろにサーバレスファンクションを配置することによって、HTTPS経由で呼び出しができるようになります!やってみましょう!
API Gatewayに適したサブネットの作成
API Gateway用にHTTPSトラフィックのためのイングレスルールを設定したリージョナルサブネットが必要になります。ここでゃ既存のVCNの中にこのサブネットを作成していきましょう。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/fefb5f4cb7cbd2f4ee621005e2d3dd53/gw_create_subnet_1.jpg)
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/d66bed495a419e7b0ee1f798fcc299f1/gw_create_subnet_2.jpg)
選んだセキュリティリストにポート443へのイングレスルールを追加します:
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/16b8338f4282e87022e3e1be0ac1389f/gw_ingress_rule.jpg)
完了です。続いてもセキュリティについて…
ダイナミックグループの作成とAPI Gatewayに必要なポリシーの適用
API Gatewayではテナンシー内でのアクセス制御にダイナミックグループを使用します。なので、新しくダイナミックグループを作成していくつかのポリシーを設定する必要があります。Gatewayを作成するコンパートメントのOCIDが必要になるので、Identity -> Compartmentsから使うコンパートメントのOCIDをコピーしてください。次に、新規ダイナミックグループを以下の定義(コンパートメントOCIDは適切なものに置き換えて)で作成しましょう:
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/56116e7f2bebc40be41af52b2a8576a1/api_gw_dg.jpg)
さて、あなたのテナンシーと新しく作成したダイナミックグループに対応するポリシーを作成します。グループ名とコンパートメント名はご自身のものに置き換えてください:
ご参考まで、わたしのテナンシーでのステートメントは以下のようになりました:
それではGatewayを作成しましょう!
Gatewayの作成
Gatewayを作成するには、まずサイドバーメニューから'Developer Services'の配下の'API Gateway'を選択します。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/7e637619a59a27e1f0cabac626fc8e18/gw_sidebar.jpg)
'Create Gateway'をクリックしてダイアログを埋めていきます。先程作成したリージョナルサブネットを選択することを忘れないでください。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/58b4db82f145a03ceb105d92ff6a8bcf/create_api_gw.jpg)
Gatewayはまず'Creating'のステータスになるでしょう。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/c5006cdf35057f7a1a6e2c4f00e90ddc/gw_creating.jpg)
数分くらいで、Gatewayは'Active'になります。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/5737f0b9e4348cbd5cfba17cdfee1ef7/gw_created_active.jpg)
Gatewayへの仕様のデプロイ
デプロイメントを作成する前に、エンドポイントを定義するためデプロイメント仕様ファイルをJSONフォーマットで記述する必要があります。前述のファンクションOCIDが手元にあることを確認してください。では、
spec.json
というファイルをファンクションのルートに以下の内容で作成しましょう(ファンクションOCIDはご自身のものに置換してください):
このブログポストはLimited Availability期間のやり方で説明しているので手で作成したJSONでエンドポイントを定義する必要がありますが、GA後にはコンソールUIからかんたんに定義することができるようになります。
次に、Gateway詳細ページのサイドバーから'Deployments'をクリック。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/7a10e0e10429a317cd41f3876048aeb4/gw_sidebar_menu.jpg)
そして'Deploy API'をクリック。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/b4b741727ee8ad409e3486e3f06ad552/deploy_api_btn.jpg)
デプロイメントに名前をつけて、作成した
spec.json
を選択してパスのプレフィックスを入力します。![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/0e7b7487d4d4d5836795c712bd9f8d44/gw_deployment_dialog.jpg)
'Deploy'をクリックしてちょっと待てばデプロイメントは完了です。
Gatewayのテスト
Gateway詳細のページで、エンドポイントを見てみましょう。
![](https://cdn.app.compendium.com/uploads/user/e7c690e8-6ff9-102a-ac6d-e4aebca50425/f1047a3a-1d1c-46ba-9cdb-6fd5928d0a1c/Image/dd4bdc8b33baeaf4d4941a072718609a/gw_endpoint.jpg)
ファンクションをテストするため、このエンドポイントをコピーしたものに
spec.json
で定義したパスを追加して、実行してみましょう!
これはAPI Gatewayを使ってできることのほんのさわりです。デプロイメント仕様を拡張して他のファンクションや(Oracle Cloud上や外部の)HTTPエンドポイントをカバーしたり、レート制限や認証などを行うこともできます。
0 件のコメント:
コメントを投稿