ホーム ブログ API の構築、ドキュメント化、および...

Swagger、Amazon API Gateway、Lambda を使用して API を構築、ドキュメント化、デプロイ [動画]

ライアン・ピンカム
  2016年12月28日

過去数か月間、SwaggerHubチームはロードショーを開催し、Amazon の API Gateway および Lambda との新しい統合を紹介しました。 この統合により、組織は Amazon API Gateway で API を公開し、消費とセキュリティを迅速かつ自動的に向上させることができます。また、SwaggerHub の Swagger 定義から Amazon Lambda で API コードのビルディングブロックを自動生成することで、サーバーレスデプロイメントも処理されます。 今月初めには、ラスベガスの AWS re:Invent Conference でこの統合を紹介する機会がありました。そして12月には、APIDays Paris でワークショップを開催しました。 — Swagger ツールを使用した Amazon Lambda での API の作成 — SwaggerHub チームのエキスパートが、Swagger と Amazon Lambda を使用して API を構築、ドキュメント化、デプロイするシームレスなワークフローをデモンストレーションしました。 最近、無料のオンラインウェビナーを開催し、サーバーレス化のメリットを説明するとともに、SwaggerHub で提供される API Gateway 統合のハンズオンデモンストレーションを行いました。  ウェビナーは以下でご覧いただけます。また、この1時間のセッションから重要なポイントをいくつかまとめ、最も価値のある情報を見つけるのに役立てています。

Swagger と RESTful 契約の重要性 [1:50]

「Swagger は、ユーザーが API を設計、構築、ドキュメント化することを可能にします。Swagger を使用すると、API の契約を定義し、API の最終消費者だけでなく、バックエンドから API を開発する人々に、API が何をすべきかを伝えることができます。Swagger は、これらの様々なステークホルダー、テクノロジースタック、およびエンドユーザーを同期させ、1つの言語に統一します。」

サーバーレスアーキテクチャの紹介 [9:35]

「サーバーレスアーキテクチャとは、サードパーティサービス、または一時的なコンテナで実行されるカスタムコード (Function as a Service または「FaaS」) に大きく依存するアプリケーションを指し、現在最もよく知られているベンダーホストは AWS Lambda です。」

サーバーレスが API にできること [12:00]

「サーバーレス以前は、開発者はビジネスロジックだけでなく、必要なサーバーフレームワークについても考慮し、それを自分で構築するために時間、費用、労力を費やす必要がありました。サーバーレスの実装では、ビジネスロジックはベンダーにプッシュされ、ビジネスロジックをサポートするための追加開発は必要ありません。」

Amazon API Gateway の紹介 [16:00]

「AWS API Gateway は、すべての API の玄関口として機能します。API リクエストの受け入れ、処理、オーケストレーションを処理し、リクエストを適切なバックエンド（リモートサーバー (プロキシ) または特定の Lambda 関数）にマッピングします。」

Swagger と API Gateway [20:25]

「API Gateway に API をデプロイするには、ローカルマシンから Swagger ファイルをインポートするか、AWS コンソール自体で API を構築するという2つのアプローチがあります。どちらのアプローチにも長所と短所があります。」

SwaggerHub が Swagger、API Gateway、Lambda の間のギャップを埋める方法 [26:30]

「Swagger チームは、Swagger API のための完全な API 開発プラットフォームである SwaggerHub から AWS API Gateway に API ファイルをマニュアル操作なしでプッシュし、API Gateway で API をデプロイする際に関わるすべての操作を1つの信頼できる情報源からオーケストレーションする方法を考案しました。」

実際の動作を見る！Amazon API Gateway 統合のデモ [29:00]

その他のリソース

こちらもおすすめ