快速入门：发布应用程序

初始化应用程序

1. 在 Amazon SAM CLI 命令提示符处运行以下命令。

   sam init --runtime python3.6 

2. 查看命令创建的目录的内容 (sam-app/)：

   • template.yaml— 定义 Hello World 应用程序需要的两个Amazon资源：一个 Lambda 函数和一个支持 GET 操作的 API Gateway 终端节点。模板还定义了两个资源之间的映射。

   • 与 Hello World 应用程序代码相关的内容：

     • hello_world/目录-包含应用程序代码，该代码hello world在您运行时返回。

   注意

   对于本练习，应用程序代码是用 Python 编写的，并且您可以在 init 命令中指定运行时。 Amazon 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. 在 Amazon SAM 模板文件中添加 Metadata 部分，提供所需的应用程序信息。有关Amazon SAM模板Metadata部分的更多信息，请参阅Amazon Serverless Application Model开发者指南中的Amazon 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. 通过运行以下 CLpackageAmazon SAM I 命令创建 Lambda 函数部署包。

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

   此命令执行以下操作：

   • 压缩aws-sam/hello_world/目录的内容并将其上传到 Amazon S3。

   • 将部署包、自述文件和许可证文件上传到--s3-bucket选项指定的 Amazon S3 存储桶。

   • 输出一个名为 packaged.yaml 的新模板文件，您在下一步使用该文件将应用程序发布到 Amazon Serverless Application Repository。packaged.yaml模板文件与原始模板文件 (template.yaml) 类似，但有一个关键区别，CodeUriLicenseUrl、和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
     
     ...

将无服务器应用程序发布到 Amazon Serverless Application Repository

• 执行以下命令以在 Amazon Serverless Application Repository 中发布新应用程序，并将第一个版本创建为 0.0.1。

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