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

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

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

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

참고

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

속성

이 표는 템플릿 Metadata 섹션의 속성에 대한 정보를 제공합니다. AWS SAM 이 섹션은 사용자에게 응용 프로그램을 게시하는 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 응용 프로그램에 대한 자세한 정보 (예: 응용 프로그램 GitHub 저장소 위치) 가 포함된 URL.
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