📣
TiDB Cloud Essential はパブリックプレビュー中です。このページは自動翻訳されたものです。原文はこちらからご覧ください。
TiDB Cloud
TiDB Self-Managed
Learning Center
お問い合わせ

AWS CloudFormation を使用してTiDB Cloud Starter を Amazon Lambda と統合する

このドキュメントでは、クラウドネイティブの分散SQLデータベースであるTiDB Cloudスターター 、サーバーレスでイベントドリブンなコンピューティングサービスであるAWS ラムダと統合するための手順をAWS クラウドフォーメーションから順に説明します。TiDB TiDB Cloud StarterをAmazon Lambdaと統合することで、 TiDB Cloud StarterとAWS Lambdaを介したマイクロサービスのスケーラビリティとコスト効率を活用できます。AWS CloudFormationは、Lambda関数、API Gateway、Secrets ManagerなどのAWSリソースの作成と管理を自動化します。

注記：

このドキュメントの手順は、 TiDB Cloud Starter クラスターに加えて、 TiDB Cloud Essential クラスターでも機能します。

ソリューションの概要

このガイドでは、次のコンポーネントを使用して、完全に機能するオンライン書店を作成します。

  • AWS Lambda 関数: Sequelize ORM と Fastify API フレームワークを使用して、 TiDB Cloud Starter クラスターからのリクエストを処理し、データをクエリします。
  • AWS Secrets Manager SDK: TiDB Cloud Starter クラスターの接続構成を取得および管理します。
  • AWS API Gateway: HTTP リクエストルートを処理します。
  • TiDB Cloud Starter: クラウドネイティブの分散 SQL データベース。

AWS CloudFormation は、Secrets Manager、API Gateway、Lambda 関数など、プロジェクトに必要なリソースを作成するために使用されます。

書店プロジェクトの構造は次のとおりです。

AWS Lambda structure overview

前提条件

始める前に、次のものを用意してください。

注記：

  • AWSリソースを作成する際は、クラスターのリージョンとしてus-east-1使用することをお勧めします。これは、このデモのLambda関数コードがリージョンをus-east-1にハードコードし、コードバンドルがus-east-1リージョンに保存されるためです。
  • 別のリージョンを使用する場合は、次の手順に従って Lambda 関数コードを変更し、再構築して、コードバンドルを独自の S3 バケットにアップロードする必要があります。
us-east-1以外のリージョンを使用する場合は、Lambda 関数のコードを修正して再構築します。

クラスターリージョンとしてus-east-1使用する場合は、このセクションをスキップしてステップ1: AWS CloudFormationを使用してプロジェクトをセットアップするに進みます。

AWS リソースを作成するためにus-east-1以外の別の AWS リージョンを使用する場合は、Lambda 関数コードを変更して再構築し、コードバンドルを独自の S3 バケットにアップロードする必要があります。

ローカル開発環境の問題を回避するには、 ギットポッドなどのクラウドネイティブ開発環境を使用することをお勧めします。

コードバンドルを再構築して独自の S3 バケットにアップロードするには、次の手順を実行します。

  1. 開発環境を初期化します。

    • ギットポッドワークスペースを開き、GitHub アカウントでログインします。

  2. Lambda 関数のコードを変更します。

    1. 左側のサイドバーでaws-lambda-cloudformation/src/secretManager.tsファイルを開きます。
    2. 22 行目を見つけて、 region変数を自分の地域に合わせて変更します。

  3. コード バンドルを再構築します。

    1. 依存関係をインストールします。

      1. Gitpod でターミナルを開きます。

      2. 作業ディレクトリを入力してください:

        cd aws-lambda-cloudformation

      3. 依存関係をインストールします。

        yarn

    2. コード バンドルを再構築します。

      1. コードバンドルをビルドします。

        yarn build

      2. aws-lambda-cloudformation/dist/index.zipファイルを確認してください。

      3. index.zipファイルを右クリックし、 [ダウンロード]を選択します。

  4. 再構築されたコードバンドルを独自の S3 バケットにアップロードします。

    1. AWS マネジメントコンソールのS3 サービスアクセスします。
    2. 選択したリージョンに新しいバケットを作成します。
    3. index.zipファイルをバケットにアップロードします。
    4. 後で使用するために、S3 バケット名とリージョンを書き留めておきます。

ステップ1. AWS CloudFormationを使用して書店プロジェクトをセットアップする

AWS CloudFormation を使用してブックショッププロジェクトをセットアップするには、次の手順を実行します。

  1. AWS マネジメントコンソールに移動し、 AWS CloudFormation サービスにアクセスします。

  2. [スタックの作成] > [新しいリソースを使用 (標準)]をクリックします。

  3. 「スタックの作成」ページで、スタックの作成プロセスを完了します。

    1. 前提条件領域で、既存のテンプレートを選択を選択します。

    2. [テンプレートの指定]領域で[テンプレート ファイルのアップロード]を選択し、[**ファイルの選択]をクリックしてテンプレート ファイル (YAML または JSON) をアップロードし、 [次へ]**をクリックします。

      ファイルがまだない場合は、 GitHubからダウンロードしてください。ファイルには、プロジェクトに必要なリソースを作成する AWS CloudFormation テンプレートが含まれています。

      Create a stack

    3. スタックの詳細を指定します。

      • クラスターリージョンとしてus-east-1使用する場合は、次のスクリーンショットのようにフィールドに入力します。

        Specify AWS Lambda stack details

        • スタック名: スタック名を入力します。
        • S3Bucket : zip ファイルを保存する S3 バケットを入力します。
        • S3Key : S3 キーを入力します。
        • TiDBDatabase : TiDB Cloudクラスター名を入力します。
        • TiDBHost : TiDB Cloudデータベースアクセス用のホストURLを入力します。2 localhost入力してください。
        • TiDBPassword : TiDB Cloudデータベース アクセス用のパスワードを入力します。
        • TiDBPort : TiDB Cloudデータベース アクセス用のポートを入力します。
        • TiDBUser : TiDB Cloudデータベース アクセス用のユーザー名を入力します。

      • us-east-1以外の AWS リージョンを使用する場合は、次の手順に従ってください。

        1. us-east-1以外のリージョンを使用する場合は、Lambda 関数のコードを修正して再構築します。を参照して Lambda 関数コードを変更し、再構築して、コードバンドルを独自の S3 バケットにアップロードします。
        2. スタックの詳細フィールドで、独自の設定に応じて、パラメータS3BucketとS3Keyに S3 バケット名とリージョンを指定します。
        3. 前のスクリーンショットのように、他のフィールドに入力します。

    4. スタックオプションを設定します。デフォルトの設定を使用できます。

      Configure stack options

    5. スタックを確認して作成します。

      Review and create the stack

ステップ2. 書店プロジェクトを使用する

スタックが作成されたら、次のようにプロジェクトを使用できます。

  1. AWS マネジメントコンソールのAPIゲートウェイサービスアクセスし、 TiDBCloudApiGatewayV2 API をクリックして、左側のペインでAPI: TiDBCloudApiGatewayV2をクリックします。

  2. 概要ページからInvoke URLコピーします。このURLがAPIエンドポイントとして機能します。

    API Gateway Invoke URL

  3. API をテストするには、Postman や cURL などの API テスト ツールを使用してください。

    • 模擬試験本を初期化します:

      curl -X POST -H "Content-Type: application/json" -d '{"count":100}' https://<your-api-endpoint>/book/init

    • すべての書籍を入手:

      curl https://<your-api-endpoint>/book

    • 書籍IDで書籍を取得します:

      curl https://<your-api-endpoint>/book/<book-id>

    • 本を作成する:

      curl -X POST -H "Content-Type: application/json" -d '{ "title": "Book Title", "type": "Test", "publishAt": "2022-12-15T21:01:49.000Z", "stock": 123, "price": 12.34, "authors": "Test Test" }' https://  <your-api-endpoint>/book

    • 本を更新する:

      curl -X PUT -H "Content-Type: application/json" -d '{ "title": "Book Title(updated)" }' https://<your-api-endpoint>/book/<book-id>

    • 本を削除する:

      curl -X DELETE https://<your-api-endpoint>/book/<book-id>

ステップ3. リソースをクリーンアップする

不要な料金を避けるため、作成されたすべてのリソースをクリーンアップしてください。

  1. AWS マネジメントコンソールにアクセスします。
  2. 作成した AWS CloudFormation スタックを削除します。

このページは役に立ちましたか？