Amazon SAM 模板元数据部分属性 - Amazon Serverless Application Model
属性用例示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon SAM 模板元数据部分属性

AWS::ServerlessRepo::Application 是元数据键，可用于指定要发布到 Amazon Serverless Application Repository 的应用程序信息。

注意

AWS::ServerlessRepo::Application 元数据键不支持 Amazon CloudFormation 内置函数。

属性

此表提供有关 Amazon SAM 模板 Metadata 部分属性的信息。该部分是使用 Amazon SAM CLI 向 Amazon Serverless Application Repository 发布应用程序所必需的。

属性 Type 必需 描述
Name 字符串 TRUE

应用程序的名称。

最小长度 = 1。最大长度 = 140。

模式："[a-zA-Z0-9\\-]+";
Description 字符串 TRUE

关于应用程序的描述。

最小长度 = 1。最大长度 = 256。
Author 字符串 TRUE

发布应用程序的作者的姓名。

最小长度 = 1。最大长度 = 127。

模式："^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$";
SpdxLicenseId 字符串 FALSE 有效的许可证标识符。要查看有效的许可证标识符列表，请参阅 Software Package Data Exchange (SPDX) 网站上的 SPDX 许可证列表。
LicenseUrl 字符串 FALSE

对本地许可文件的引用，或指向许可证文件的 Amazon S3 链接，其中该文件与您的应用程序的 spdxLicenseId 值相匹配。

未使用 sam package 命令打包的 Amazon SAM 模板文件可以引用此属性的本地文件。但是，要使用 sam publish 命令发布应用程序，此属性必须是对 Amazon S3 存储桶的引用。

最大大小：5 MB。

您必须为此属性提供一个值，才能使您的应用程序变为公有的。请注意，在应用程序发布后，您无法更新此属性。因此，要向应用程序添加许可证，必须先将其删除，或者发布具有不同名称的新应用程序。
ReadmeUrl 字符串 FALSE

对本地自述文件的引用或指向自述文件的 Amazon S3 链接，其中该文件包含对应用程序及其工作原理的更详细描述。

未使用 sam package 命令打包的 Amazon SAM 模板文件可以引用此属性的本地文件。但是，要使用 sam publish 命令发布，此属性必须是对 Amazon S3 存储桶的引用。

最大大小：5 MB。
Labels 字符串 FALSE

改善在搜索中发现应用程序的结果的标签。

最小长度 = 1。最大长度 = 127。最大标签数量：10。

模式："^[a-zA-Z0-9+\\-_:\\/@]+$";
HomePageUrl 字符串 FALSE 包含有关应用程序的更多信息的 URL，例如应用程序 GitHub 存储库的位置。
SemanticVersion 字符串 FALSE

应用程序的语义版本。有关语义版本控制规范，请访问语义版本控制网站。

您必须为此属性提供一个值，才能使您的应用程序变为公有的。
SourceCodeUrl 字符串 FALSE 指向应用程序源代码的公共存储库的链接。

用例

本节列出了发布应用程序的用例，以及为该用例处理的 Metadata 属性。未针对给定用例列出的属性将被忽略。

  • 创建新应用程序 – 如果 Amazon Serverless Application Repository 中没有与账户名称相匹配的应用程序，则会创建新的应用程序。

    • Name

    • SpdxLicenseId

    • LicenseUrl

    • Description

    • Author

    • ReadmeUrl

    • Labels

    • HomePageUrl

    • SourceCodeUrl

    • SemanticVersion

    • Amazon SAM 模板的内容（例如，任何事件源、资源和 Lambda 函数代码）

     

  • 创建应用程序版本-如果中已经存在Amazon Serverless Application Repository与账户名称相匹配的应用程序，并且 SemanticVersion正在更改，则会创建应用程序版本。

    • Description

    • Author

    • ReadmeUrl

    • Labels

    • HomePageUrl

    • SourceCodeUrl

    • SemanticVersion

    • Amazon SAM 模板的内容（例如，任何事件源、资源和 Lambda 函数代码）

     

  • 更新应用程序-如果中已经存在Amazon Serverless Application Repository与账户名称相匹配的应用程序，并且该 SemanticVersion应用程序没有更改，则会更新应用程序。

    • Description

    • Author

    • ReadmeUrl

    • Labels

    • HomePageUrl

示例

下面是 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