AWS SAM 템플릿 메타데이터 섹션 속성 - AWS Serverless Application Model
속성사용 사례예제

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS SAM 템플릿 메타데이터 섹션 속성

AWS::ServerlessRepo::Application은 귀하가 AWS Serverless Application Repository에 게시하려는 애플리케이션 정보를 지정하는 데 사용할 수 있는 메타데이터 키입니다.

참고

AWS CloudFormation 내장 함수는 AWS::ServerlessRepo::Application 메타데이터 키에서 지원되지 않습니다.

속성

이 표는 AWS SAM 템플릿 Metadata 섹션의 속성에 대한 정보를 제공합니다. 이 섹션은를 AWS Serverless Application Repository 사용하여에 애플리케이션을 게시하는 데 필요합니다 AWS SAMCLI.

속성 유형 필수 설명
Name String TRUE

애플리케이션의 이름입니다.

최소 길이: 1. 최대 길이: 140.

패턴: "[a-zA-Z0-9\\-]+";
Description String TRUE

애플리케이션에 대한 설명입니다.

최소 길이: 1. 최대 길이: 256.
Author String TRUE

애플리케이션을 게시하는 작성자의 이름입니다.

최소 길이: 1. 최대 길이: 127.

패턴: "^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$";
SpdxLicenseId String FALSE 유효한 라이선스 식별자. 유효한 라이선스 식별자 목록을 보려면 소프트웨어 패키지 데이터 교환(SPDX) 웹사이트의 SPDX 라이선스 목록을 잠조하세요.
LicenseUrl String FALSE

애플리케이션의 SPDXLicenseID 값과 일치하는 로컬 라이선스 파일에 대한 참조 또는 Amazon S3 라이선스 파일에 대한 링크입니다.

sam package 명령을 사용하여 패키징되지 않은 AWS SAM 템플릿 파일에는이 속성의 로컬 파일에 대한 참조가 있을 수 있습니다. 하지만 sam publish 명령을 사용하여 애플리케이션을 게시하려면 이 속성이 Amazon S3 버킷에 대한 참조여야 합니다.

최대 크기 = 5 MB

애플리케이션을 공개로 설정하려면 이 속성의 값을 지정해야 합니다. 단, 애플리케이션이 게시된 후에는 이 속성을 업데이트할 수 없습니다. 따라서 애플리케이션에 라이선스를 추가하려면 먼저 애플리케이션을 삭제하거나 다른 이름으로 새 애플리케이션을 게시해야 합니다.
ReadmeUrl String FALSE

로컬 readme 파일에 대한 참조 또는 Readme 파일에 대한 Amazon S3 링크입니다. 이 링크에는 애플리케이션 및 작동 방식에 대한 자세한 설명이 들어 있습니다.

sam package 명령을 사용하여 패키징되지 않은 AWS SAM 템플릿 파일에는이 속성의 로컬 파일에 대한 참조가 있을 수 있습니다. 하지만 sam publish 명령을 사용하여 게시하려면 이 속성이 Amazon S3 버킷에 대한 참조여야 합니다.

최대 크기 = 5 MB
Labels String FALSE

검색 결과에서 애플리케이션의 검색을 향상시키는 레이블입니다.

최소 길이: 1. 최대 길이: 127. 최대 레이블 수: 10.

패턴: "^[a-zA-Z0-9+\\-_:\\/@]+$";
HomePageUrl String FALSE 애플리케이션에 대한 자세한 정보가 들어 있는 URL(예: 애플리케이션의 GitHub 리포지토리 위치)
SemanticVersion String FALSE

애플리케이션의 의미 체계 버전입니다. 시맨틱 버전 관리 사양은 시맨틱 버전 관리 웹사이트를 잠조하세요.

애플리케이션을 공개로 설정하려면 이 속성의 값을 지정해야 합니다.
SourceCodeUrl String FALSE 애플리케이션의 소스 코드가 있는 퍼블릭 리포지토리의 링크입니다.

사용 사례

이 섹션에는 애플리케이션을 게시하는 사용 사례와 해당 사용 사례에 대해 처리된 Metadata 속성이 나열되어 있습니다. 특정 사용 사례에 대해 나열되지 않은 속성은 무시됩니다.

  • 새 애플리케이션 생성 -에 계정과 일치하는 이름이 AWS Serverless Application Repository 있는 애플리케이션이 없는 경우 새 애플리케이션이 생성됩니다.

    • Name

    • SpdxLicenseId

    • LicenseUrl

    • Description

    • Author

    • ReadmeUrl

    • Labels

    • HomePageUrl

    • SourceCodeUrl

    • SemanticVersion

    • AWS SAM 템플릿의 콘텐츠(예: 이벤트 소스, 리소스 및 Lambda 함수 코드)

     

  • 애플리케이션 버전 생성 - AWS Serverless Application Repository 내에 계정과 일치하는 이름을 가진 애플리케이션 버전이 이미 존재하고 그에 더하여 SemanticVersion이 변경 중인 경우, 애플리케이션 버전이 생성됩니다.

    • Description

    • Author

    • ReadmeUrl

    • Labels

    • HomePageUrl

    • SourceCodeUrl

    • SemanticVersion

    • AWS SAM 템플릿의 콘텐츠(예: 이벤트 소스, 리소스 및 Lambda 함수 코드)

     

  • 애플리케이션 업데이트 -에 계정과 AWS 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