クイックスタート: アプリケーションの発行

アプリケーションを初期化する

1. AWS SAM CLI コマンドプロンプトで以下のコマンドを実行します。

   sam init --runtime python3.6 

2. コマンドで作成されたディレクトリの内容を確認します (sam-app/)。

   • template.yaml – Hello World アプリケーションが必要とする 2 つの AWS リソース (Lambda 関数、および GET オペレーションをサポートする API Gateway エンドポイント) を定義します。このテンプレートは、2 つのリソース間のマッピングも定義します。

   • Hello World アプリケーションコードに関連するコンテンツ:

     • hello_world/ ディレクトリ - アプリケーションコードが含まれています。このコードを実行すると、hello world が返されます。

   注記

   この演習では、アプリケーションコードを Python で記述し、init コマンドでランタイムを指定します。AWS Lambda は、アプリケーションコードを作成するための追加の言語をサポートしています。別のサポートされているランタイムを指定すると、init コマンドは、指定した言語での Hello World コードと、その言語で参照できる README.md ファイルを提供します。サポートされているランタイムの詳細については、Lambda 実行環境と使用可能なライブラリを参照してください。

アプリケーションをローカルでテストするには

1. API ゲートウェイエンドポイントをローカルで起動します。template.yaml ファイルがあるディレクトリから次のコマンドを実行する必要があります。

   sam-app> sam local start-api --region us-east-1

   このコマンドは API Gateway エンドポイントを返します。このエンドポイントにローカルテストのためのリクエストを送信できます。

2. アプリケーションをテストします。API Gateway エンドポイント URL をコピーしてブラウザに貼り付け、Enter を選択します。API Gateway エンドポイント URL の一例は、http://127.0.0.1:3000/hello です。

   API Gateway は、エンドポイントのマッピング先の Lambda 関数をローカルに呼び出します。Lambda 関数は、ローカルの Docker コンテナで実行され、hello world を返します。API Gateway は、テキストが含まれているブラウザへのレスポンスを返します。

1. /hello_world/app.py ファイルを編集して、メッセージの文字列を 'hello world' から 'Hello World!' に変更します。

2. ブラウザでテスト URL をリロードし、新しい文字列を確認します。

Lambda デプロイパッケージを作成する

1. Metadata セクションを AWS SAM テンプレートファイルに追加し、必要なアプリケーション情報を指定します。AWS SAM テンプレートの Metadata セクションの詳細については、AWS Serverless Application Model デベロッパーガイドの AWS SAM テンプレートのメタデータセクションのプロパティを参照してください。

   次に、Metadata セクションの例を示します。

   Metadata:
     AWS::ServerlessRepo::Application:
       Name: my-app
       Description: hello world
       Author: user1
       SpdxLicenseId: Apache-2.0
       LicenseUrl: LICENSE.txt
       ReadmeUrl: README.md
       Labels: ['tests']
       HomePageUrl: https://github.com/user1/my-app-project
       SemanticVersion: 0.0.1
       SourceCodeUrl: https://github.com/user1/my-app-project

   LicenseUrl プロパティと ReadmeUrl プロパティは、ローカルファイルへの参照 (上の例を参照) であるか、これらのアーティファクトをすでにホストしている Amazon S3 バケットへのリンクとなります。

2. パッケージ化されたコードを保存する場所に S3 バケットを作成します。既存の S3 バケットを使用する場合は、このステップをスキップします。

   sam-app> aws s3 mb s3://bucketname

3. 次の package AWS SAM CLI コマンドを実行して、Lambda 関数のデプロイパッケージを作成します。

   sam-app> sam package \
       --template-file template.yaml \
       --output-template-file packaged.yaml \
       --s3-bucket bucketname

   コマンドが以下の操作を行います。

   • aws-sam/hello_world/ ディレクトリの内容を圧縮して Amazon S3 にアップロードします。

   • デプロイパッケージ、README ファイル、および LICENSE ファイルを --s3-bucket オプションで指定した Amazon S3 バケットにアップロードします。

   • 新しいテンプレートファイル (packaged.yaml) を出力します。このファイルは、次のステップでアプリケーションを AWS Serverless Application Repository に発行するために使用します。packaged.yaml テンプレートファイルは元のテンプレートファイル (template.yaml) と似ていますが、大きな違いがあります。それは、CodeUri、LicenseUrl、および ReadmeUrl プロパティはそれぞれのアーティファクトを含む Amazon S3 バケットとオブジェクトを指すことです。packaged.yaml テンプレートファイルの例から次のスニペットは、CodeUri プロパティを示しています。

     HelloWorldFunction:
         Type: AWS::Serverless::Function # For more information about function resources, see https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
         Properties:
           CodeUri: s3://bucketname/fbd77a3647a4f47a352fcObjectGUID
     
     ...

サーバーレスアプリケーションを AWS Serverless Application Repository に発行するには

• 次のコマンドを実行して、AWS Serverless Application Repository で新しいアプリケーションを発行します。最初に作成するバージョンは 0.0.1 とします。

  sam-app> sam publish \
      --template packaged.yaml \
      --region us-east-1