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

CloudFormation 언어 확장 지원

는 AWS SAM CLI , Fn::ForEach, Fn::Length및 Fn::ToJsonStringFn::FindInMap를 포함하여 AWS::LanguageExtensions 변환을 사용하는 템플릿을 지원합니다DefaultValue. 이러한 구문에 대한 전체 참조 정보는 AWS CloudFormation 사용 설명서의 AWS::LanguageExtensions 변환을 참조하세요.

AWS SAM 템플릿에서 언어 확장을 사용하려면 앞AWS::LanguageExtensions의 Transform 섹션에를 나열합니다AWS::Serverless-2016-10-31.

Transform:
  - AWS::LanguageExtensions
  - AWS::Serverless-2016-10-31

가 템플릿의 Transform 섹션에서 AWS::LanguageExtensions를 감지하고 로컬 처리에 옵트인한 경우 AWS SAM CLI AWS SAM 변환을 실행하기 전에 언어 확장 구성을 로컬로 확장합니다. 이렇게 하면 sam build, sam package, sam deploy, sam sync, sam validate, sam local start-api, sam local invoke및가 이러한 구문을 사용하는 템플릿으로 작업sam local start-lambda할 수 있습니다.

로컬 처리는 기본적으로 꺼져 있습니다. 끄면는 AWS SAM CLI 템플릿을 변경 없이 전달하고 배포 시 AWS::LanguageExtensions 변환 서버 측을 CloudFormation 처리합니다. 활성화 방법은 섹션을 참조하세요언어 확장 활성화.

확장은 활성화되면 두 단계로 이루어집니다.

는 AWS::LanguageExtensions 변환 서버 측을 CloudFormation 처리하기 때문에 원래 템플릿(Fn::ForEach온전한 템플릿 포함)은 CloudFormation 배포용으로 보존됩니다.

언어 확장 활성화

의 로컬 처리AWS::LanguageExtensions는 명령당 옵트인됩니다. 우선순위에 따라 나열된 세 가지 활성화 방법이 있습니다.

Fn::ForEach

Fn::ForEach는 단일 템플릿 정의에서 여러 리소스, 조건 또는 출력을 생성합니다.

Transform:
  - AWS::LanguageExtensions
  - AWS::Serverless-2016-10-31

Parameters:
  ServiceNames:
    Type: CommaDelimitedList
    Default: "Users,Orders,Products"

Resources:
  Fn::ForEach::Services:
    - Name
    - !Ref ServiceNames
    - ${Name}Function:
        Type: AWS::Serverless::Function
        Properties:
          Handler: index.handler
          Runtime: python3.12
          CodeUri: ./services/${Name}

를 실행하면 UsersFunction, OrdersFunction및 로 sam build 확장되며ProductsFunction, 각 소스 디렉터리에서 빌드됩니다.

동적 아티팩트 속성

패키지 가능한 속성이 루프 변수(예: ./services/${Name})를 사용하는 경우는 CloudFormation Mappings 각 컬렉션 값을 Amazon S3에 매핑하는 섹션을 AWS SAM CLI 생성합니다URI. Fn::ForEach 본문은 사용하도록 다시 작성Fn::FindInMap되므로는 배포 시 올바른 아티팩트를 확인할 CloudFormation 수 있습니다.

인식된 아티팩트 속성은 현재 sam package 다시 쓰는 속성과 동일합니다. 여기에는 다음이 포함됩니다.

점 속성(예: Command.ScriptLocation AWS::Glue::Job 또는 Code.ImageUri AWS::Lambda::Function)의 경우 리소스의 중첩된 위치에서 값을 읽고 씁니다. 생성된 매핑 이름은 속성 경로의 리프 세그먼트만 사용합니다.

속성이 루프 템플릿화되면 매핑 이름은 입니다SAM<LeafProperty><LoopName>(예: SAMCodeUriServices 또는 SAMScriptLocationJobs).

예를 들어, 이후는 sam package다음과 같습니다.

Mappings:
  SAMCodeUriServices:
    Users:
      CodeUri: s3://my-bucket/abc123
    Orders:
      CodeUri: s3://my-bucket/def456
    Products:
      CodeUri: s3://my-bucket/ghi789

Resources:
  Fn::ForEach::Services:
    - Name
    - !Ref ServiceNames
    - ${Name}Function:
        Type: AWS::Serverless::Function
        Properties:
          Handler: index.handler
          Runtime: python3.12
          CodeUri: !FindInMap [SAMCodeUriServices, !Ref Name, CodeUri]

ForEach 본문당 여러 리소스

단일 Fn::ForEach 본문은 반복당 둘 이상의 리소스를 내보낼 수 있습니다. 각 리소스는 모든 컬렉션 값에 대해 생성됩니다.

Resources:
  Fn::ForEach::Tables:
    - TableName
    - [Users, Orders, Products]
    - ${TableName}Table:
        Type: AWS::DynamoDB::Table
        Properties:
          TableName: !Sub "${AWS::StackName}-${TableName}"
          # ...

      ${TableName}StreamProcessor:
        Type: AWS::Serverless::Function
        Properties:
          CodeUri: stream-processors/${TableName}/
          Events:
            DDBStream:
              Type: DynamoDB
              Properties:
                Stream: !GetAtt
                  - !Sub "${TableName}Table"
                  - StreamArn

매핑 이름 충돌 확인

동일한 Fn::ForEach 본문의 두 리소스가 동일한 동적 아티팩트 속성을 선언하면(예: Api 및 StateMachine 모두 사용DefinitionUri) AWS SAM CLI는 리소스 logical-ID 템플릿의 정적 부분에서 가져온 접미사를 추가하여 매핑 이름을 고유하게 유지합니다.

충돌이 없는 경우 기본 이름(예: SAMDefinitionUriServices)이 사용됩니다.

파라미터 기반 컬렉션

Fn::ForEach 컬렉션이 파라미터 참조(예: !Ref ServiceNames)이고 루프 본문이 동적 아티팩트 속성(예: CodeUri: ./services/${Name})을 사용하는 경우는 AWS SAM CLI에 설명된 SAM* 매핑을 생성하기 위해 컬렉션 값이 필요합니다동적 아티팩트 속성. 다음에서 템플릿을 처리할 때 이를 해결합니다.

# Package with the values you intend to deploy with
sam package --language-extensions --parameter-overrides ServiceNames="Users,Orders,Products"

# Deploy with the same values
sam deploy --language-extensions --parameter-overrides ServiceNames="Users,Orders,Products"

중첩 스택

Fn::ForEach 중첩 스택 템플릿(AWS::CloudFormation::Stack)에서가 지원됩니다. 는 AWS SAM CLI 상위 스택의 Parameters 속성을 하위 템플릿 확장에 전달하므로 상위 제공 파라미터를 참조하는 하위 Fn::ForEach 컬렉션은 올바르게 해석됩니다.

# parent.yaml
Resources:
  ChildStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: ./child.yaml
      Parameters:
        ServiceNames: "Users,Orders,Products"

중첩된 Fn::ForEach

CloudFormation 한도와 일치하는 최대 5개의 중첩 수준이 지원됩니다.

Resources:
  Fn::ForEach::Envs:
    - Env
    - [Dev, Staging, Prod]
    - Fn::ForEach::Services:
        - Svc
        - [Users, Orders]
        - ${Env}${Svc}Function:
            Type: AWS::Serverless::Function
            Properties:
              CodeUri: ./services/${Svc}
              Environment:
                Variables:
                  STAGE: ${Env}

ForEach in Outputs

Fn::ForEach 블록도 Outputs 섹션 내에서 확장되므로 컬렉션 값당 하나의 출력을 내보낼 수 있습니다.

Outputs:
  Fn::ForEach::FunctionArns:
    - Name
    - [alpha, beta]
    - ${Name}FunctionArn:
        Value: !GetAtt
          - !Sub "${Name}Function"
          - Arn

조건 및 DependsOn

에서 내보내는 리소스는 다른 리소스와 DependsOn 마찬가지로 Condition 및를 전달할 Fn::ForEach 수 있습니다. 조건 또는 종속성은 생성된 각 리소스에 복제됩니다.

Conditions:
  IsProd: !Equals [!Ref Environment, prod]

Resources:
  SharedTable:
    Type: AWS::DynamoDB::Table
    # ...

  Fn::ForEach::Functions:
    - Name
    - [api, worker]
    - ${Name}Function:
        Type: AWS::Serverless::Function
        Condition: IsProd
        DependsOn: SharedTable
        Properties:
          Handler: main.handler
          CodeUri: functions/${Name}/

&{identifier} 구문

&{identifier} 구문은 대체 값에서 영숫자가 아닌 문자를 제거하므로 IP 주소와 같은 값에서 유효한 논리적 IDs 생성하는 데 유용합니다.

Fn::ForEach::Hosts:
  - IP
  - ["10.0.0.1", "10.0.0.2"]
  - Host&{IP}:
      Type: AWS::EC2::Instance
      # Expands to Host10001, Host10002

지원되는 내장 함수

다음 내장 함수는 확장 중에 로컬에서 확인됩니다.

배포된 리소스(Fn::GetAtt, Fn::ImportValue, Fn::GetAZs)가 필요한 함수는 CloudFormation 에 대해 보존되어 배포 시 해결됩니다.

유효성 검사 오류

AWS SAM 변환이 실행되기 전에 다음 템플릿 문제가 로컬에서 발견됩니다.

제한 사항

원격 측정

이 AWS SAM CLI CFNLanguageExtensions 원격 측정 이벤트는 명령이 --language-extensions (또는 이에 상응하는 환경 변형)으로 호출되고 템플릿이 AWS::LanguageExtensions 변환을 선언할 때 발생합니다. 이벤트는 호출당 한 번 실행되며 템플릿 콘텐츠는 전송되지 않습니다. 로컬 처리가 꺼져 있으면(기본값) 이벤트가 실행되지 않습니다.