CloudFormation Provider
cloudformation provider는 Aggrega Recipes를 AWS CloudFormation 스택 템플릿으로 렌더링합니다. 이 provider에서 같은 출력 디렉터리로 렌더링되는 모든 component는 하나의 스택으로 조립되며, 이 스택은 긴 형식의 내장 함수를 사용하는 단일 순수 JSON 템플릿으로 출력됩니다. 따라서 일반적인 경우 하나의 경계는 하나의 스택이 되며, directory:가 같은 경로로 해석되는 두 경계는 함께 하나의 스택으로 조립되어 그 템플릿의 이름을 공유합니다. 다른 모든 Aggrega provider와 마찬가지로 이 provider는 오프라인이며 밀폐되어 있습니다. Aggrega 빌드는 AOT(ahead-of-time) 컴파일이므로 provider는 AWS를 호출하지 않고, 계정에서 생성되는 식별자를 해석하지 않으며, CloudFormation을 실행하지 않습니다. 런타임에만 존재하는 값은 CloudFormation이 배포 시점에 해석하는 CloudFormation 내장 참조(Fn::GetAtt, Fn::ImportValue, Fn::GetStackOutput)로 남습니다.
스택으로 조립되는 프래그먼트 레시피
cloudformation Recipe는 템플릿 전체가 아니라 프래그먼트, 즉 단일 컴포넌트가 기여하는 CloudFormation 리소스를 작성합니다. 바운더리의 컴포넌트가 렌더링될 때 provider는 디스패치 그룹의 모든 프래그먼트를 하나의 스택 템플릿으로 조립합니다. 리소스는 단일 Resources 맵 아래에 병합되고, 각 컴포넌트의 provides 값은 스택 Outputs로 노출되며, 템플릿의 나머지 최상위 섹션은 조립된 스택의 최상위 섹션에서 하나씩 다룹니다. 두 가지 작성 형태가 허용됩니다.
- 프래그먼트(아티팩트) 입력. Recipe가 리소스 프래그먼트를 직접 작성합니다. provider는 이를 순수 JSON 장형식 내장 함수로 정규화하여 조립된 스택에 병합합니다.
- 소스 입력. Recipe가 기존 CloudFormation 템플릿(YAML 또는 JSON)을 참조합니다. provider는 이를 장형식 JSON으로 정규화하고 조립 전에 구조를 검증하며, 템플릿이 선언한 파라미터를 Recipe의
valuesMapping에서 채우고(소스 템플릿 파라미터의 값 참조), Recipe의omits:항목이 지정한 리소스를 제외합니다(소스 템플릿에서 리소스 제외 참조).
조립된 템플릿은 순수 JSON입니다. 내장 함수는 그대로 출력되며 빌드 시점에 평가되지 않습니다. 컴파일러는 스택이 배포된 후에만 존재하는 값을 확인할 수 없으며, 이를 평가하면 사전 컴파일 계약이 깨집니다.
컴포넌트에 연결된 Feature는 같은 스택에 기여합니다
컴포넌트에 연결된 Feature는 호스트 컴포넌트의 자체 Recipe와 동일한 조건으로, 호스트 컴포넌트가 조립되는 스택에 리소스를 기여합니다. 별도의 템플릿은 없습니다. 조립된 스택이 이 provider가 출력 디렉터리에 대해 내보내는 전부이므로, 연결된 Feature의 리소스는 그 스택에 포함되거나 아예 배포되지 않습니다. Feature를 분리하면 정확히 해당 리소스만 제거되고 호스트 컴포넌트 자체의 리소스는 그대로 유지됩니다.
이 리소스는 조립된 스택에 들어가므로 스택의 이름을 공유합니다. 연결된 Feature의 리소스 논리 ID는 호스트 컴포넌트의 논리 ID 및 함께 연결된 다른 모든 Feature의 논리 ID와 같은 공간에 있으므로, 조립된 스택의 이름이 그대로 적용됩니다. 두 기여자가 하나의 이름에서 충돌하면 중단 메시지가 컴포넌트와 Feature가 연결된 키를 지정하므로, 충돌의 양쪽을 직접 작성한 파일에서 검색할 수 있습니다.
연결된 Feature의 출력은 호스트 컴포넌트의 이름으로 게시되지만, 리소스 논리 ID는 그렇지 않습니다. 스택의 두 부분은 서로 다른 규칙으로 이름이 지정되므로 이 점에서 다르게 동작합니다. 리소스 논리 ID는 다른 Recipe와 마찬가지로 FeatureRecipe가 작성한 그대로 출력됩니다. 출력은 게시하는 컴포넌트와 항목을 합쳐 이름이 지정되며, 컴포넌트에 연결된 Feature의 경우 게시하는 컴포넌트는 호스트입니다. payments-db에 연결되어 alarm을 게시하는 Feature는 paymentsXzhdbXXalarm이 되며, 이는 호스트 컴포넌트가 그 항목을 직접 게시했을 때와 같은 이름입니다. 따라서 호스트도 게시하는 항목 이름은 연결된 Feature의 항목과 하나의 출력 이름에서 만나며, 빌드는 컴포넌트 자체와 함께 컴포넌트 및 Feature가 연결된 키를 지정하며 중단됩니다. alarm 대신 backup-alarm처럼 Feature 고유의 것으로 읽히는 항목 이름을 선택하면 호스트의 이름과 겹치지 않습니다.
Feature가 기여하는 각 리소스는 빌드가 기록하는 출처 정보에 호스트 컴포넌트의 ID가 아니라 해당 연결에 대해 구성된 ID를 유지하므로, 둘 다 기여한 스택 안에서도 서로 구별됩니다. 이 ID가 구성되는 방식은 레이블과 어노테이션에서 다룹니다.
조립된 스택의 최상위 섹션
여러 컴포넌트가 하나의 스택으로 조립되므로, CloudFormation 템플릿이 허용하는 모든 최상위 섹션은 조립 과정에서 빠짐없이 처리되어야 합니다. 여기에는 CloudFormation이 호스팅하는 변환이 템플릿 언어에 추가하는 두 섹션인 Globals와 Hooks도 포함됩니다. 각 섹션은 아래 그룹 중 정확히 하나에 속하며, 컴포넌트가 작성한 최상위 키가 어떤 섹션에도 해당하지 않으면 해당 컴포넌트와 키를 명시하는 경고가 발생하므로, 알리지 않고 누락되는 것은 없습니다.
provider가 범위를 지정하는 이름으로 조립되거나, 작성된 그대로 읽히는 섹션. Resources와 Outputs이며, 조립된 스택의 이름에서 자세히 다룹니다. AWSTemplateFormatVersion은 어떤 컴포넌트에서도 읽지 않고 provider가 작성합니다. 템플릿 언어가 이 섹션에 단 하나의 값만 허용하므로 컴포넌트가 결정할 것이 없습니다.
작성한 이름 그대로 전달되는 섹션. Parameters, Mappings, Conditions, Metadata, Rules입니다. 각각은 사용자가 정한 이름을 키로 하는 맵이므로, 각 컴포넌트의 항목은 다시 쓰이지 않고 그 이름 그대로 조립된 스택에 도달합니다. 이 덕분에 리소스의 Condition:, Fn::FindInMap, 또는 파라미터에 대한 Ref가 함께 도착한 선언에 대해 해석될 수 있습니다. 각 섹션은 개별적으로 작성되므로 개별적으로 전달됩니다. 규칙은 같은 문서의 파라미터에 대해 검증하고, 조건은 파라미터를 전혀 참조하지 않을 수도 있으며, CloudFormation은 매핑 안에서 파라미터 참조를 허용하지 않습니다.
여기서는 한 단어가 서로 다른 두 위치를 가리키며, 그중 첫 번째만 사용자의 것입니다. 위 목록의 Metadata는 템플릿 자체의 최상위 섹션으로, 사용자가 정한 이름의 맵입니다. 개별 리소스에도 자체 Metadata 속성이 있으며, 빌드는 바로 이곳에 출처 정보를 기록합니다. 이 정보는 예약된 단일 aggrega.ai/ 키 아래에 기록되며, 사용자가 작성한 내용을 대체하지 않고 그 옆에 추가됩니다. 따라서 리소스 안에 나타나는 출처 항목은 사용자가 작성한 것도, 최상위 섹션이 전달한 것도 아닙니다.
Parameters, Mappings, Conditions, Rules는 항목 이름을 논리적 ID로 지정합니다. provider는 이름을 작성된 그대로 전달하므로, 논리적 ID가 허용하는 문자 집합이 이 섹션들에도 적용됩니다. 이 네 섹션 중 하나에서 문자와 숫자 이외의 것을 포함하는 이름은 빌드를 중단시킵니다. A carried section name outside the alphabet halts (전달된 섹션 이름이 허용 문자 집합을 벗어나면 중단됩니다)를 참조하십시오. provider는 최상위 Metadata 섹션의 이름에는 이 문자 집합을 요구하지 않습니다. 이 이름들은 템플릿이 참조하는 대상이 아니라 사용자가 저장하는 정보를 가리키기 때문입니다.
두 컴포넌트가 이 섹션 중 하나에 서로 다른 이름을 선언하면 둘 다 반영됩니다. 같은 이름을 동일한 내용으로 선언하면 하나의 항목으로 병합되고 빌드가 계속됩니다. 같은 이름을 다른 내용으로 선언하면 섹션, 이름, 두 컴포넌트를 명시하며 빌드가 중단됩니다. 그렇지 않으면 두 본문 중 하나가 버려져, 그것을 작성한 컴포넌트에는 스택이 전달하지 않는 선언이 남게 되기 때문입니다. 이는 리소스 이름과 출력 이름이 따르는 것과 같은 조정 방식이며, 둘 중 하나의 이름을 바꾸면 해결됩니다.
전달되지 않고 경고로 명시됩니다. Description은 선택한 이름들의 맵이 아니라 템플릿 전체에 대한 단일 서술이므로, 여러 component를 바탕으로 하는 조립에서는 이에 대한 답이 없습니다. 두 개의 설명은 하나의 질문에 대한 두 개의 답이며, 어느 쪽도 스택의 것이 아닙니다. Hooks는 AWS::CodeDeployBlueGreen 변환만 읽는데, 조립된 스택은 이 변환을 결코 전달하지 않습니다(아래 참조). 따라서 조립된 스택은 둘 중 어느 것도 전달하지 않으며, 이를 작성한 모든 component에 component와 섹션을 명시하는 경고가 표시됩니다. Globals를 읽는 AWS::Serverless-2016-10-31 변환을 선언하지 않고 이를 작성한 component도 마찬가지입니다. 이 경고는 권고 사항이며 대역 외로 전달됩니다. 출력되는 템플릿은 경고가 없을 때와 바이트 단위로 동일하며, --no-unsupported-field-warnings는 같은 부류의 다른 경고와 함께 이 경고를 표시하지 않게 합니다.
Transform은 모든 컴포넌트의 것으로 구성됩니다. 변환은 CloudFormation이 무엇이든 배포하기 전에 템플릿 전체에 대해 실행하는 매크로이므로, 조립된 스택의 Transform은 컴포넌트들이 선언한 변환(소스 템플릿의 것이든 프래그먼트의 것이든)의 합집합이며, CloudFormation이 문서화한 순서를 따릅니다. 즉 계정에서 정의한 매크로가 CloudFormation이 호스팅하는 변환보다 먼저 오고, AWS::LanguageExtensions가 AWS::Serverless-2016-10-31보다 먼저 옵니다. 각 컴포넌트 자체의 순서는 유지되며, 순서가 정해지지 않은 두 변환은 컴포넌트들이 처음 선언한 순서대로 실행되므로 같은 컴포넌트는 같은 스택을 만듭니다. 변환이 하나이면 문자열로, 여러 개이면 목록으로 작성됩니다. 컴포넌트가 하나뿐이고 그 컴포넌트가 하나의 템플릿이나 프래그먼트에 Transform을 선언한 스택은, 아래 표가 그것을 전달하는 경우 작성된 그대로 유지하며, 컴포넌트가 아무것도 선언하지 않은 스택은 아무것도 전달하지 않습니다. 컴포넌트의 변환은 경고를 발생시키지 않습니다. 전달되거나, 그 변환을 명시하며 빌드가 중단됩니다.
변환은 템플릿 전체를 처리하므로, 변환을 전달하면 그 동작이 해당 변환을 위해 작성된 내용으로 한정되지 않는 한 다른 모든 컴포넌트의 내용이 배포되는 방식이 바뀝니다. 그래서 각 변환은 CloudFormation 자체 문서가 뒷받침하는 처리 방식을 따르며, 스택이 전달할 수 없는 조합은 변환과 스택의 모든 컴포넌트를 명시하며 빌드를 중단시킵니다.
| 변환 | 조립된 스택에서 |
|---|---|
AWS::Serverless-2016-10-31 | 선언한 컴포넌트의 Globals와 함께 전달됩니다. 그 Globals가 다른 컴포넌트의 서버리스 리소스에 영향을 미치는 경우, 그리고 이 변환의 리소스 중 하나의 이벤트 소스가 다른 컴포넌트가 선언한 리소스를 지정하는 경우 중단됩니다. 변환이 이벤트가 지정하는 리소스를 다시 쓰기 때문입니다. |
AWS::LanguageExtensions | 단독으로, 또는 같은 컴포넌트의 AWS::Serverless-2016-10-31과 함께 전달됩니다. 다른 컴포넌트의 서버리스 내용과 함께 있으면 중단됩니다. 언어 확장이 값을 해석한 후에는 서버리스 변환이 생성하는 대상의 이름을 다르게 지정하기 때문입니다. |
AWS::SecretsManager-2020-07-23, AWS::SecretsManager-2024-09-16 | 전달됩니다. 이 변환들은 자신을 요청하는 교체 일정만 처리합니다. |
AWS::ServiceCatalog | 컴포넌트가 하나뿐인 스택에서는 전달됩니다. 다른 컴포넌트와 함께 있으면 중단됩니다. 템플릿의 어디에서든 참조 패턴을 치환하기 때문입니다. |
AWS::CodeDeployBlueGreen | 단독이어도 중단됩니다. CloudFormation은 이 변환을 선언한 템플릿의 어디에서든 Outputs와 Fn::ImportValue를 거부하며, 조립된 스택은 컴포넌트들이 게시하는 출력을 전달합니다. |
AWS::Include | 단독이어도 중단됩니다. 스택이 배포될 때 S3에서 가져온 내용을 삽입하는데, 빌드는 이를 읽을 수 없습니다. |
| 계정에서 정의한 매크로 | 컴포넌트가 하나뿐인 스택에서는 전달됩니다. 다른 컴포넌트와 함께 있으면 중단됩니다. 템플릿의 나머지 부분에 무엇을 하는지 빌드가 알 수 없기 때문입니다. |
두 컴포넌트가 한 쌍의 변환을 서로 반대 순서로 선언해도 두 순서와 두 컴포넌트를 명시하며 빌드가 중단됩니다. 스택은 변환을 하나의 순서로만 실행하기 때문입니다. 스택이 전달할 수 없는 변환이 필요한 컴포넌트는 별도의 경계에 둡니다.
조립된 스택의 이름
CloudFormation 논리적 ID는 하나의 템플릿 안에서 고유하며 문자와 숫자만 허용합니다. 그리고 해당 템플릿으로 조립되는 모든 컴포넌트는 그 이름을 공유합니다. 두 경계가 같은 출력 디렉터리로 해석될 때는 두 번째 경계의 컴포넌트도 포함됩니다. 따라서 스택이 무언가를 가리키는 데 쓰는 각 이름은 그것을 기여한 모든 컴포넌트에 걸쳐 구별되어야 하며, 기여자 집합이 항상 하나의 경계인 것은 아닙니다.
리소스 논리적 ID는 Recipe에서 옵니다. 프로바이더는 작성된 그대로 내보내며 어느 것도 다시 쓰지 않으므로, 조립된 템플릿에서 읽는 이름은 Recipe가 작성한 이름입니다. 표준 라이브러리 CloudFormation Recipes는 이 이름을 컴포넌트 인스턴스 자체의 이름에서 파생하며, 그 이름의 구분자를 단어 경계로 읽습니다. 인스턴스 payments-db는 리소스 이름을 PaymentsDb로 짓습니다. 따라서 같은 타입의 두 인스턴스는 하나를 두고 경쟁하지 않고 두 개의 리소스를 기술합니다.
출력 이름은 그것을 게시한 컴포넌트에 따라 범위가 정해집니다. 각 provides 항목은 게시하는 컴포넌트와 항목을 함께 반영한 이름의 출력으로 나타납니다. host를 게시하는 컴포넌트 payments-db는 paymentsXzhdbXXhost로 나타납니다. 따라서 같은 항목을 게시하는 두 컴포넌트는 서로 다른 두 출력에 도달하며, 다른 컴포넌트가 스택에 합류해도 출력의 의미는 바뀌지 않습니다. 같은 계정과 리전 안의 교차 스택 소비자는 이 이름이 아니라 내보내기 이름으로 가져오므로 내보내기 이름은 영향을 받지 않습니다. 계정 간 또는 리전 간 읽기는 프로바이더가 대신 써 주는 이 출력 이름을 지정합니다(교차 스택 연결 참조).
출력 이름이 만들어지는 방식
논리적 ID는 구분자 문자를 허용하지 않으므로, 작성한 무언가로 만든 이름은 어떻게든 그 구분자를 옮겨 담아야 합니다. 구분자를 버리면 정보가 손실됩니다. payments-db와 payments_db는 서로 다른 두 컴포넌트이며, 구두점을 버린 이름은 어느 쪽도 식별하지 못합니다. 그래서 프로바이더는 대신 알파벳이 거부하는 것을 인코딩하여, 거부된 각 문자를 알파벳이 허용하는 문자로 풀어 씁니다.
이 방식은 이스케이프를 여는 데 한 문자, 즉 대문자 X를 예약하고, 나머지는 대문자를 포함해 입력한 그대로 씁니다. 예약되는 것은 대문자뿐이므로, nginx-proxy 같은 이름의 소문자 x는 작성한 그대로 전달됩니다.
| 작성한 것 | 변환 결과 | 이유 |
|---|---|---|
문자 또는 숫자(X 제외) | 그대로 | 알파벳이 허용함 |
- | Xzh | 알파벳이 하이픈을 거부함 |
_ | Xzu | 알파벳이 밑줄을 거부함 |
. | Xzd | 알파벳이 마침표를 거부함 |
/ | Xzs | 알파벳이 슬래시를 거부하며, 중첩된 컴포넌트 식별자에 슬래시가 포함됨 |
X | Xzx000058 | 이스케이프를 여는 데 예약되어 있으므로 코드 포인트로 풀어 씀 |
| 그 밖의 모든 것 | Xzx와 해당 문자의 코드 포인트 | 하나의 규칙이 나머지 모든 문자를 다룸 |
| 두 절반이 만나는 지점 | XX | 연속된 두 개의 여는 문자로, 어느 절반도 포함할 수 없음 |
다시 읽어 들이는 과정에는 모호함이 없으며, 이는 부가적인 장점이 아니라 이 방식의 핵심입니다. X는 바로 뒤의 문자가 알파벳이 허용하는 문자일 때만 그대로 유지되므로, 인코딩된 절반은 이 문자로 끝나지 않고 이 문자를 두 개 연속으로 담지도 않습니다. 따라서 XX는 결합 지점을, 그리고 오직 결합 지점만을 의미할 수 있습니다.
따라서 구두점의 위치만 다른 세 이름은 서로 구별됩니다.
component payments-db publishing host → paymentsXzhdbXXhostcomponent payments_db publishing host → paymentsXzudbXXhostcomponent payments publishing db-host → paymentsXXdbXzhhost이 이름은 작성한 컴포넌트 이름보다 길고 한눈에 읽기 어려우며, 이것이 그 대가입니다. 정확히 하나의 항목을 식별하는 이름은 두 항목 중 어느 것도 식별하지 못하는 짧은 이름보다 가치가 있습니다. 또한 출력은 이 이름을 입력하는 것이 아니라 내보내기 이름을 통해 가리키므로, 치르는 비용은 내보낸 템플릿을 읽을 때 한 번 더 보는 정도입니다.
리소스 논리적 ID에는 다른 규칙이 적용됩니다. 프로바이더가 만들지 않고 Recipe가 작성한 것을 내보내기 때문입니다. 표준 라이브러리 CloudFormation Recipes는 인스턴스 이름의 구분자를 단어 경계로 읽어 ID를 파생하며(인스턴스 payments-db는 리소스 이름을 PaymentsDb로 지음), 이 파생 과정은 구분자를 버립니다. 따라서 구두점만 다르거나 문자의 대소문자만 다른 두 인스턴스 이름은 여전히 하나의 리소스 이름을 파생합니다. 빌드는 두 컴포넌트가 선언된 곳에 리소스 하나를 내보내는 대신, 그 이름에 도달한 모든 인스턴스와 도달한 이름을 명시하며 중단됩니다. 일부가 아니라 모두를 명시하는 것은, 충돌의 어떤 점도 한 인스턴스의 파생을 의도된 것으로 만들지 않기 때문입니다. 하나를 제외한 모두의 이름을 바꾸면 해결됩니다.
알파벳을 벗어난 리소스 논리적 ID는 중단을 일으킵니다
고유성과 알파벳은 별개의 두 요구 사항이며, 이름 집합이 첫 번째는 충족하고 두 번째는 충족하지 못할 수 있습니다. 프로바이더는 리소스 논리적 ID를 Recipe가 작성한 그대로 내보내므로, Recipe가 작성하는 ID는 CloudFormation 템플릿이 그 자체로 담을 수 있는 것, 즉 문자와 숫자로만 이루어진 것이어야 합니다.
바로 여기서 파생된 이름과 그대로 전달된 이름이 갈라집니다. 출력 이름은 게시하는 컴포넌트와 항목을 인코딩하는 프로바이더가 만들므로, 어느 절반을 어떻게 쓰든 출력 이름은 알파벳 안에 있습니다. 리소스 논리적 ID는 그대로 전달되므로, Recipe가 작성한 것이 곧 템플릿이 받는 것입니다.
따라서 Recipe가 컴포넌트 인스턴스의 이름을 논리적 ID에 그대로 쓸 때마다, 이는 컴포넌트 이름에 대한 제약이기도 합니다. 컴포넌트 이름에는 하이픈이나 밑줄이 들어갈 수 있지만 논리적 ID에는 들어갈 수 없습니다. 그런 Recipe를 통해 이 프로바이더를 대상으로 하는 컴포넌트는 문자와 숫자만으로 이름을 지어야 하며(payments-db가 아니라 paymentsdb), 그 밖의 것은 빌드를 중단시킵니다.
중단 메시지는 해당 ID를 작성한 Recipe의 기여자, ID 자체, 그리고 ID 안에 들어갈 수 없는 각 문자를 명시하고, 대신 무엇을 쓸 수 있는지 알려 줍니다. 해결 방법은 두 가지이며, 첫 번째는 언제든 사용할 수 있습니다.
- 이름을 그대로 전달하는 대신 Recipe가 자체 논리적 ID를 작성하도록 합니다. 표준 라이브러리 CloudFormation Recipes가 이 방식을 따릅니다. 인스턴스 이름의 구분자를 단어 경계로 읽으므로, 인스턴스
payments-db는 리소스 이름을PaymentsDb로 짓고 선택한 컴포넌트 이름은 유지됩니다. 이런 방식으로 ID를 파생하면 이 중단 대신 위의 충돌 규칙이 적용됩니다. 구두점만 다른 두 인스턴스 이름은 하나의 리소스 이름을 파생합니다. - Recipe가 이름을 그대로 전달하는 경우에는, 전달되는 것의 이름을 문자와 숫자만으로 바꿉니다. 컴포넌트 자체의 Recipe라면 그것은 컴포넌트 이름입니다. 컴포넌트에 연결된 Feature는 자체 FeatureRecipe에서 리소스 이름을 지으므로, 호스트 컴포넌트의 이름을 바꿔도 그 리소스에는 미치지 않습니다. 바뀌어야 하는 것은 그 Recipe가 작성하는 ID입니다.
프로바이더는 거부할 뿐, 조용히 고치지 않습니다. 대신 ID를 다시 쓰는 것이 도움이 되는 일처럼 보이겠지만, 그렇지 않습니다. 논리적 ID는 CloudFormation이 업데이트에 걸쳐 리소스를 식별하는 방식이므로, ID를 바꾸는 것은 이름 변경이 아니라 다른 리소스를 가리키는 것입니다. 프로바이더가 대체한 ID는 작성한 ID로 이미 배포된 리소스가 아닌 다른 곳을 가리키게 되며, 그 대체는 요청한 적이 없고 내보낸 템플릿에서 직접 찾아내야 하는 것입니다. 멈추는 빌드는 아직 직접 고칠 수 있을 때 문제를 알려 줍니다.
허용 문자 집합을 벗어난 전달 섹션 이름은 빌드를 중단시킵니다
provider가 작성한 그대로 전달하는 이름은 리소스 논리 ID만이 아닙니다. Parameters, Mappings, Conditions, Rules도 각 항목에 논리 ID로 이름을 붙이며, 네 섹션 모두 작성자가 정한 이름 그대로 조립된 스택에 도달합니다. 따라서 네 개의 표면에 같은 요구 사항이 적용됩니다. 이름은 CloudFormation 템플릿이 그 자체로 담을 수 있는 것, 즉 문자와 숫자로만 이루어져야 하며, 그 밖의 것은 빌드를 중단시킵니다.
이름을 담은 섹션 너머까지 미치는 결과가 하나 있으며, 이것이 경고가 아니라 중단하는 이유입니다. 이 이름들은 리소스의 Condition:, Fn::FindInMap, 또는 파라미터에 대한 Ref가 해석되는 대상입니다. 따라서 허용 문자 집합이 받아들이지 않는 이름은 선언 자체와 함께 그 이름을 가리키는 참조까지 배포 가능한 템플릿에서 빠지게 만들어, 작성된 이름 하나가 둘 다를 한꺼번에 쓸 수 없게 합니다. 중단이 없다면 이 문제는 배포 시점에, 이름을 작성한 사람이 아니라 배포하는 사람에 의해 발견됩니다.
중단 메시지는 이름을 작성한 Recipe의 기여자, 이름이 작성된 섹션, 이름 자체, 그리고 그 안에 있을 수 없는 각 문자를 알려 줍니다. Recipes에서 검색할 용어는 섹션입니다: 이 이름들은 작성된 섹션 그대로 전달되므로, 섹션은 메시지와 자신의 파일 양쪽에 모두 나타나는 유일한 단어입니다. 항목 이름을 문자와 숫자로만 바꾸면 해결되며, 해결책은 그것이 전부입니다. 리소스 논리 ID에는 이름을 그대로 전달하는 대신 Recipe가 ID를 파생하게 하는 대안이 있지만, 여기에는 파생할 것이 없습니다. 섹션 안의 이름이 곧 작성한 것이기 때문입니다.
허용 문자 집합의 제약을 받는 것은 섹션 자체의 이름뿐이며, 항목 내부의 키는 결코 해당하지 않습니다. 매핑의 두 번째 수준 키는 자유롭게 정할 수 있습니다. RegionCidr 맵 아래의 us-east-1은 평범한 경우이며, 그대로 출력된 템플릿에 도달합니다. 파라미터, 조건, 규칙 본문 내부의 키는 스택이 가리키는 무언가가 아니라 속성, 어설션, 내장 함수를 지칭합니다. 규칙의 Assertions와 그 안에 작성된 Fn::Contains가 그런 종류의 키입니다. 이 중 어느 것도 논리 ID가 아니며, 어느 것도 검사되지 않습니다.
구별해 작성한 두 항목 이름은 구별된 채로 유지됩니다
세 종류의 항목 이름은 하나의 출력 이름에서 만날 만큼 가까우며, 어느 것도 특이한 경우가 아닙니다. 두 부분이 합쳐지지 않고 인코딩되며, 어느 부분도 포함할 수 없는 시퀀스에서 만나므로, 세 가지 모두 각자의 이름에 도달합니다:
- 구두점만 다른 항목.
db-host와db_host를 모두 게시하는 component는dbXzhhost와dbXzuhost에 도달합니다. - 문자의 대소문자만 다른 항목. 문자는 작성한 대소문자 그대로 전달되므로
host와Host는host와Host에 도달합니다. - 조인 지점을 사이에 두고 만나는 항목. Component
payments-db가host를 게시하면paymentsXzhdbXXhost가 되고, componentpayments가db-host를 게시하면paymentsXXdbXzhhost가 됩니다.
두 항목이 실제로 하나를 지칭하는 경우에는 여전히 만납니다. 출력 이름은 게시하는 component와 항목으로 만들어지므로, 둘 다를 공유하는 것은 어떻게 인코딩되든 하나의 이름에 도달합니다. 가장 흔히 마주칠 경우는 하나의 Feature가 단일 component에 두 번 부착된 경우입니다. 부착은 호스트 아래에서 게시하므로, 한 component에 부착된 한 Feature의 두 부착은 모두 payments-db에서 alarm-id를 게시하며, 그 쌍에는 구별할 것이 없습니다. 빌드는 두 개가 작성된 곳에 출력 하나를 내보내는 대신 중단되며, component와 각 쪽이 지닌 부착 키를 알려 주므로 양쪽 모두 자신의 파일에서 검색할 수 있습니다. Feature를 한 번만 부착하거나, 게시 항목 이름이 해당 부착 고유의 것으로 읽히는 Feature를 사용하십시오.
이는 두 항목이 같은 값을 지니든 아니든 마찬가지입니다. 같은 값을 지닌 두 항목도 작성자가 요청한 두 출력을 나타내므로, 이를 하나로 병합하면 작성된 두 출력 중 하나가 스택에서 빠지게 됩니다.
Recipe가 템플릿에서 조합하는 이름은 여기에 해당하지 않습니다
위의 인코딩은 provider의 것이며, provider가 만드는 출력 이름에 적용됩니다. Recipe 템플릿 안에서는 이 인코딩을 사용할 수 없으므로, 템플릿이 조합하는 이름은 그 보장을 하나도 갖지 않습니다. 이를 분명히 밝히는 것이 중요한 이유는 템플릿 내부에서는 위험이 보이지 않기 때문입니다. 템플릿에서 사용할 수 있는 변환은 인수를 단어로 읽고 그 사이의 모든 것을 버리므로, 변환 전에 두 값을 결합하면 구두점과 함께 결합 지점도 사라집니다.
인스턴스와 부착 키를 공백으로 결합한 뒤 변환하여 리소스 이름을 붙이는 FeatureRecipe가 주의해야 할 형태입니다. cache가 붙은 app과 아무것도 붙지 않은 app-cache는 모두 AppCache로 변환되며, 변환의 어떤 속성이 적용되기도 전에 둘이 충돌합니다. 그러한 이름을 구별되게 유지하는 방법은 두 가지이며, 둘 다 provider가 아닌 작성자의 몫입니다:
- 조합하는 부분을 문자와 숫자로만 유지하십시오. 그러면 버려지는 것도, 구별해야 할 것도 없습니다.
- 각각 상대의 구분자를 포함할 수 있는 두 값을 결합하지 마십시오. 이름이 두 부분을 지녀야 한다면, 그중 하나를 다른 부분이 포함할 수 없는 고정 리터럴로 만드십시오.
조합된 이름이 충돌하는 경우, 출력 이름이 아니라 리소스 논리 ID로서 충돌하므로, 마주치는 중단은 위의 리소스 이름 중단입니다.
한 매핑에 두 번 작성된 키는 빌드를 중단시킵니다
CloudFormation 프래그먼트는 매핑으로 읽히며, 매핑은 키마다 하나의 값을 가지므로, 두 번 작성된 키는 마지막에 온 본문을 유지하고 다른 하나를 버리게 됩니다. 매핑이 Resources 또는 Outputs 블록이라면, 버려지는 본문은 작성되었지만 스택에 그냥 없게 될 리소스나 출력입니다.
대신 빌드는 중단되며, 반복된 키와 그 키가 작성된 두 줄을 알려 줍니다. 이는 스택의 이름에 관한 규칙이 아니라 프래그먼트 전체에 대한 규칙입니다. 리소스의 Properties를 포함해 프래그먼트 안의 모든 매핑에 적용됩니다. 가장 흔한 경우는 Recipe가 작성된 값에서 논리 ID를 파생하는데 두 작성 값이 구두점만 다른 경우입니다. app-cache와 app_cache는 모두 AppCache를 파생하므로, 프래그먼트는 AppCache를 두 번 작성하게 됩니다.
문서의 서로 다른 위치에 키 이름이 반복되는 것은 평범하며 그대로 둡니다. 프래그먼트에 리소스와 출력이 몇 개 있든 Type은 리소스마다 한 번, Value는 출력마다 한 번 나타납니다. 한 매핑 안에서의 반복만이 본문을 잃게 만듭니다.
단일 component도 한 이름을 두 번 차지할 수 있습니다. Recipe는 여러 프래그먼트, 즉 여러 artifacts: 항목이나 여러 템플릿을 담은 소스 디렉터리를 기여하며, 그 모두가 같은 스택으로 조립되므로, component 자신의 프래그먼트들은 component 간에 이름을 공유하는 것과 똑같이 서로 스택의 이름을 공유합니다. 한 이름에 서로 다른 두 본문을 부여하는 두 프래그먼트는 빌드를 중단시키며, 중단 메시지는 그 이름이 속한 키 공간(리소스 논리 ID 또는 출력 이름)과 함께 component와 이름 자체를 알려 줍니다. 두 공간 모두 이런 방식으로 도달할 수 있습니다. 두 프래그먼트가 서로 다른 리소스에 하나의 리소스 논리 ID를 작성할 수 있고, component는 명시적인 Outputs: 블록과 provides: 항목이라는 두 경로로 출력 이름에 도달하므로, 각 경로에서 같은 이름을 지닌 항목도 거기서 만납니다.
이름을 다시 작성하는 것 자체는 충돌이 아닙니다. 동일한 내용으로 여러 번 작성된 이름은 어느 쪽이든 하나를 가리키므로, 반복된 작성은 단일 항목으로 병합되고 빌드는 진행됩니다. 평범한 반복에는 아무 대가가 없습니다. 중단되는 것은 내용을 잃는 경우입니다. 두 본문 중 하나가 버려져야 하고, 그러면 Recipe가 선언한 리소스나 출력이 스택에서 빠지게 됩니다. 둘 중 하나의 이름을 바꾸면 해결됩니다.
구조적 입력 검증
소싱된 CloudFormation 템플릿은 렌더링되기 전에 구조적으로 검증됩니다. provider는 템플릿을 파싱하고 그 내장 함수를 정규화하며, 템플릿의 형식이 잘못된 경우 문제가 되는 노드를 지목하는 명확한 메시지와 함께 빌드를 중단합니다. 파싱은 의미가 아니라 형태를 검사합니다. AWS에 접속하거나, 참조를 해석하거나, 내장 함수를 평가하지 않습니다.
파싱에 성공한 템플릿이라고 해서 전체가 그대로 전달되는 것은 아닙니다. 파싱은 문서가 올바른 형식임을 알려 줄 뿐이며, 조립된 스택에 무엇이 도달하는지는 조립된 스택의 최상위 섹션에서 설명하는 대로 섹션별로 별도로 결정됩니다. 소싱된 템플릿도 프래그먼트와 동일한 집계 과정을 거칩니다.
파싱은 템플릿의 참조가 해석되는지도 묻지 않습니다. Ref가 파라미터를, Fn::FindInMap이 맵을 가리키는지는 개별 입력 문서가 아니라 조립된 스택에 관한 문제이며, 배포 시점에 CloudFormation이 답할 문제입니다. 빌드는 결과가 무엇을 참조하는지 판단하는 대신 자신이 전달하지 않은 것을 명시합니다. 빌드가 판단하는 참조는 빌드 자체가 끊어지게 만든 참조입니다. 하나는 소싱된 템플릿의 바인딩이 채운 파라미터에 대한 참조로, 다음 섹션에서 다룹니다. 다른 하나는 omits: 항목이 템플릿에서 제외한 리소스에 대한 참조로, 그 다음 섹션에서 다룹니다.
소스 템플릿의 파라미터에 대한 값
소스 템플릿은 CloudFormation 자체가 템플릿에 값을 주는 방식, 즉 템플릿이 선언하는 Parameters를 통해 값을 받습니다. 템플릿을 소스로 지정하는 쪽(컴포넌트의 Recipe 또는 연결된 Feature의 FeatureRecipe)의 valuesMapping은 채우는 파라미터마다 키를 하나씩 작성하며, 프로바이더는 소스의 모든 템플릿에서 각 키를 바인딩합니다. Resources, Outputs, Conditions, Rules 및 SAM의 Globals에 있는 파라미터에 대한 모든 Ref는 그 값이 되고, 파라미터를 변수로 지정하는 모든 Fn::Sub는 변수 맵을 통해 값을 받으며, 파라미터는 이를 선언하는 모든 템플릿의 Parameters에서 제거됩니다. 어떤 키도 지정하지 않은 파라미터는 스택 배포 시 전달되는 값이나 Default를 위해 템플릿에 작성된 그대로 남습니다.
파라미터를 선언하는 단위는 소스입니다. 디렉터리 소스의 템플릿은 하나의 스택으로 조립되므로, 한 템플릿이 같은 소스의 다른 템플릿이 선언한 파라미터를 참조할 수 있습니다. 파라미터를 채우면 그곳에서도 채워집니다. 파라미터를 참조만 하는 템플릿은 그 파라미터를 선언하는 소스의 첫 번째 템플릿이 변환한 대로 값을 받으며, 소스 안에는 바인딩이 선언을 제거한 파라미터를 참조하는 것이 남지 않습니다.
스택의 다른 어떤 것도 채워진 파라미터를 참조할 수 없습니다. 소스 외부의 콘텐츠(같은 스택에 있는 다른 컴포넌트의 프래그먼트나 소스 템플릿)가 Ref, Fn::Sub 변수 또는 규칙의 Fn::ValueOf를 통해 소스의 바인딩이 채운 파라미터를 지정하면, 조립된 스택이 더 이상 선언하지 않는 것을 지정하게 되며 CloudFormation은 스택 배포 시 이를 거부합니다. 따라서 빌드는 각 컴포넌트와 그 템플릿, 파라미터, 그리고 그 파라미터를 채운 valuesMapping의 컴포넌트(Recipe의 것이거나 연결된 Feature의 FeatureRecipe의 것)를 지정하며 중단됩니다. 컴포넌트에 연결된 Feature는 그 컴포넌트로 지정되고, 경계에 연결된 Feature는 그 리소스가 aggrega.ai/component-id로 갖는 식별자로 지정되며, 이 식별자는 경계의 경로와 연결 이름으로 구성됩니다(경계 stack의 연결 aux는 bfr--stack--aux). Feature가 연결된 컴포넌트의 프래그먼트, 또는 Feature가 연결된 경계 안의 컴포넌트의 프래그먼트가 그 연결의 바인딩이 채운 파라미터를 참조하는 경우에도 빌드가 중단됩니다. 스택이 여전히 선언하는 이름은 영향을 받지 않습니다. 다른 컴포넌트가 그 이름의 파라미터를 직접 선언하거나 리소스가 그 이름을 논리적 ID로 갖는 경우, 그 참조는 해당 선언으로 해석되며 작성된 그대로 남습니다. 값을 전달하려면 채우는 컴포넌트가 값을 게시하게 하거나, 참조하는 템플릿에 파라미터를 선언하거나, valuesMapping에서 키를 제거하십시오.
spec: capability: cloudformation implements: core/delivery-stream:1.0.0 source: kind: git-repository url: https://github.com/aws-cloudformation/aws-cloudformation-templates.git ref: a0f43bc6d20813052892546f445037cf84c75b54 module_subdir: DataFirehose valuesMapping: | CloudWatchLogGroupRetention: {{ .values.retention_days }} DestinationBucketName: "{{ .context.inject.env.BUCKET_NAME }}"파라미터를 채우는 것은 valuesMapping뿐입니다. 여기에 작성하는 키는 템플릿을 위해 의도한 파라미터 이름이므로, 각 키는 소스의 어떤 템플릿이 선언하는 파라미터를 지정해야 합니다. 아무 파라미터도 지정하지 않는 키는 빌드를 중단시키며, 그 키와 각 템플릿이 실제로 선언하는 파라미터를 지정합니다. 이는 CloudFormation이 알 수 없는 파라미터에 대해 보고할 실패를, 아직 직접 고칠 수 있는 시점에 보고하는 것입니다. valuesMapping을 선언하지 않는 Recipe 또는 FeatureRecipe는 아무것도 채우지 않습니다. 컴포넌트나 연결 자체의 값은 다른 입력을 위해 작성된 자신의 이름 그대로 프로바이더에 도달하며, 읽히지 않은 채 남습니다.
템플릿에 무엇이 도달하는지는 값의 종류가 결정합니다.
- 리터럴(문자열, 숫자, 불리언 또는 이들의 목록)은 템플릿에 기록되며, 스택 배포 시 파라미터의
Type에 대해 같은 값이 전달될 때 CloudFormation이 변환하는 방식대로 변환됩니다.Number는 이에 대한Ref가 산출하는 문자열이 되므로7은"7"로 도달합니다.CommaDelimitedList또는List<…>타입은 문자열 목록이 되며, 목록이나 멤버가 공백 제거되는 쉼표 구분 문자열을 받습니다. 그 밖의 모든 타입은 문자열 하나를 받습니다. 리터럴은 파라미터 자체의AllowedValues,AllowedPattern,MinLength,MaxLength,MinValue,MaxValue에 대해 검사되며, 이들이 거부하는 리터럴은 파라미터와 제약 조건을 지정하며 빌드를 중단시킵니다. 따라서 파라미터를 채워도 템플릿이 선언한 검사는 하나도 사라지지 않습니다. 빌드가 읽을 수 없는 정규식 구문으로 작성된 패턴은 스택 배포 시 CloudFormation이 검사하도록 남겨 둡니다. - 전체가 하나의 CloudFormation 내장 함수인 값은 그 내장 함수 그대로 참조 위치에 도달하며, 스택 배포 시 CloudFormation이 평가합니다.
{"Fn::GetAtt": [Queue, Arn]}같은 긴 형식 매핑이나, 정확히 하나의 짧은 형식인 문자열(!GetAtt Queue.Arn,!Ref Bucket,!Sub …및 CloudFormation이 정의하는 기타 형식)이 이에 해당합니다. 다른 컴포넌트가 게시한 참조는 이런 방식으로 파라미터에 도달합니다. 카탈로그의 CloudFormation Recipes는 이러한 참조를 짧은 형식 텍스트로 게시하고, 주입 컨텍스트에서 이를 읽는valuesMapping이 그것을 전달합니다. 삽입된 참조는 따옴표로 묶든 묶지 않든 똑같이 읽힙니다. 따옴표로 묶으면("{{ .context.inject.env.BUCKET_NAME }}") 매핑은 문자열!GetAtt Queue.Arn을 전달합니다. 묶지 않으면 매핑 자체의 YAML이!GetAtt Queue.Arn을 태그로 읽지만, 태그는 버려지지 않고 인수와 함께 유지됩니다. 어느 쪽이든 내장 함수로 파라미터에 도달합니다. 느낌표로 시작하기만 하거나 CloudFormation 짧은 형식을 지정하지 않는 값은 텍스트로 남습니다. - 동적 참조(
{{resolve:ssm:…}},{{resolve:ssm-secure:…}}또는{{resolve:secretsmanager:…}})는 작성된 그대로 참조 위치에 도달하며 스택 배포 시 CloudFormation이 해석하므로, 그것이 지정하는 값은 템플릿에 절대 포함되지 않습니다. - 다른 컴포넌트가 다른 스택에서 게시하는 값은 템플릿이 파라미터를 참조한 모든 위치에 교차 스택 참조, 즉 프래그먼트가 받는 것과 같은
Fn::ImportValue또는Fn::GetStackOutput로 도달합니다(교차 스택 연결 참조).
CloudFormation이 Parameter Store에서 읽는 타입(AWS::SSM::Parameter::Value<…>)의 파라미터에는 CloudFormation의 처리를 재현하는 리터럴이 없으므로, 여기에 바인딩된 리터럴은 빌드를 중단시킵니다. {{resolve:ssm:…}} 참조나 내장 함수를 바인딩하거나 바인딩하지 않은 채로 두십시오. 템플릿이 Fn::Sub 변수로 지정하는 파라미터에 바인딩된 목록도 빌드를 중단시킵니다. 변수는 문자열 하나를 치환하기 때문입니다. valuesMapping이 null로 설정한 키도 파라미터를 지정하며 빌드를 중단시킵니다. 파라미터는 값을 받는데 null은 값이 없기 때문입니다. 스택 배포 시 전달되는 값이나 Default를 위해 파라미터를 남겨 두려면 매핑에서 그 키를 빼십시오.
이름으로 파라미터를 읽는 규칙은 그 파라미터를 바인딩되지 않은 상태로 유지합니다. 템플릿 Rules의 Fn::ValueOf는 선언된 파라미터를 Ref가 아닌 논리적 ID로 지정하고, 파라미터를 채우면 그 선언이 제거되므로, 규칙이 그런 방식으로 읽는 파라미터를 바인딩하면 규칙과 파라미터를 지정하며 빌드가 중단됩니다.
비밀을 담을 수 있는 리터럴은 거부되고, 내장 함수는 주어진 그대로 기록됩니다. 템플릿에 기록되는 값은 스택의 템플릿을 읽을 수 있는 누구나 읽을 수 있습니다.
- 템플릿이
NoEcho로 선언한 파라미터는 동적 참조나 내장 함수를 받으며, 여기에 바인딩된 리터럴은 빌드를 중단시킵니다. valuesMapping이 작성자가 민감하다고 선언한 값을 읽는 경우, 그 출력 중 어느 것도 원래 값으로 추적할 수 없으므로 매핑이 바인딩하는 모든 리터럴은 빌드를 중단시킵니다. 매핑이 바인딩하는 동적 참조와 내장 함수는 내장 함수 안의 텍스트를 포함하여 주어진 그대로 기록됩니다. 따라서 예를 들어 매핑이Fn::Sub의 텍스트에 삽입한 비밀은 그 텍스트로 템플릿에 도달합니다. 비밀 자체를 템플릿 밖에 두는 것은 동적 참조뿐입니다. 이러한 빌드가 진행되면, Recipe의 매핑과 컴포넌트에 연결된 Feature의 FeatureRecipe의 매핑 모두에 대해 선언된 리프마다 하나의 권고를 출력하며, 리프와 그 매핑의 엔터티를 지정합니다. A declared-sensitive value reaches the target through a values mapping (민감하다고 선언된 값이 values 매핑을 통해 대상에 도달함)을 참조하십시오.- 동적 참조는 해당 파라미터가 리소스의
UserData속성,AWS::CloudFormation::Init메타데이터 또는Outputs에서 참조되는 경우 빌드를 중단시킵니다. CloudFormation은 EC2 사용자 데이터나 해당 메타데이터에서 동적 참조를 확인하지 않으며,Outputs는 스택을 읽는 누구에게나 표시하기 때문입니다.
이러한 거부는 모두 파라미터 이름을 표시하며, 값은 인용하지 않습니다.
소스 템플릿에서 리소스 제외하기
소스 템플릿의 리소스는 템플릿 자체의 것입니다. 값은 템플릿이 선언한 파라미터를 통해서만 템플릿에 전달되므로, git 저장소에서 가져온 템플릿이 Release가 생성해서는 안 되는 리소스(운영자가 이미 제공하는 버킷, 플랫폼이 다른 곳에서 관리하는 키 등)를 선언하고 있다면 이를 값으로 바꿀 수 없습니다. Recipe나 FeatureRecipe의 omits: 항목은 바로 이런 경우를 위한 것입니다. 이 프로바이더는 소스 템플릿에 대해서만 이 항목을 적용하며 그 외에는 적용하지 않습니다. artifacts: 항목이 작성하는 프래그먼트는 이 항목 없이 렌더링됩니다.
spec: capability: cloudformation implements: core/store:1.0.0 source: kind: git-repository url: https://git.example.com/platform/templates.git ref: v3.2.0 module_subdir: store omits: # The template bundles an access-log bucket; this Release logs elsewhere. - kind: AWS::S3::Bucket name: StoreLogs항목은 하나의 리소스를 Type과 논리적 ID로 지정합니다. 항목의 kind는 AWS::S3::Bucket과 같은 리소스의 Type이고, name은 리소스의 논리적 ID, 즉 Resources 아래의 키입니다. 두 값 모두 작성된 그대로 정확히 비교되며 둘 다 일치해야 하므로, Type은 맞지만 논리적 ID가 맞지 않는 항목은 아무것도 제외하지 않습니다. 템플릿에는 네임스페이스가 없으므로 namespace를 지정한 항목은 컴포넌트가 렌더링될 때 해당 항목을 지목하며 빌드를 중단시킵니다. 모든 항목은 무엇이든 제외되기 전에 검사됩니다.
소스의 모든 템플릿이 대조됩니다. 단일 파일 소스에는 템플릿이 하나 있습니다. 디렉터리 소스(git 저장소에서 가져온 소스는 항상 디렉터리 소스입니다)에는 .yaml, .yml, .json 또는 .template으로 끝나는 모든 파일이 포함되며, 항목은 그중 어느 파일에서든 자신이 지정한 리소스를 모두 제외합니다. 템플릿과 함께 들어 있는 다른 파일은 읽지 않습니다. 프로바이더는 각 항목이 모든 템플릿에 걸쳐 제외한 리소스의 수를 보고하며, 아무것도 제외하지 않은 항목은 빌드를 중단시킵니다. An omits entry left out nothing the source rendered (omits 항목이 소스가 렌더링한 것 중 아무것도 제외하지 않았습니다)를 참조하십시오.
제외된 리소스는 다른 무엇이 템플릿을 읽기 전에 사라집니다. 제외된 리소스에는 출처 정보가 기록되지 않고, 스택이 가진 이름에도 포함되지 않으며(따라서 다른 컴포넌트가 같은 논리적 ID로 리소스를 제공해도 둘이 충돌하지 않습니다), 조립된 스택에 도달하지도 않습니다. 템플릿의 나머지 부분은 해당 리소스 없이 작성되었을 경우와 정확히 같게 기록되며, 모든 리소스가 제외된 템플릿에는 빈 Resources 섹션이 남습니다.
제외된 리소스는 남은 부분에서 계속 지정되어서는 안 됩니다. CloudFormation은 선언하지 않은 리소스를 지정하는 템플릿을 거부하기 때문입니다. 리소스가 제거된 후, 남은 템플릿이 제거된 리소스를 여전히 참조하면 그 참조마다 빌드가 중단되며, 메시지에는 템플릿, 리소스, 참조가 리소스를 지정하는 방식, 그리고 템플릿 루트로부터의 경로로 나타낸 참조 위치(예: /Resources/Store/Properties/LoggingConfiguration/DestinationBucketName)가 표시됩니다. 참조란 CloudFormation의 템플릿 레퍼런스가 논리적 ID로 리소스를 지정하는 것으로 정의하는 것으로, 모든 리소스의 본문(속성, 메타데이터, 정책 포함)과 모든 출력에서 읽습니다.
- 논리적 ID를 인수로 하는
Ref - 첫 번째 항목이 논리적 ID인 목록 형태이거나, 첫 번째 점 앞의 텍스트가 논리적 ID인 하나의 문자열(
!GetAtt StoreLogs.Arn) 형태인Fn::GetAtt - 하나의 논리적 ID 또는 논리적 ID 목록으로 된 리소스의
DependsOn - 문자열 형태와 목록 형태 모두에서
Fn::Sub의 각 변수.${StoreLogs}와${StoreLogs.Arn}은 모두StoreLogs를 지정합니다.
참조처럼 보이기만 하고 참조로 읽히지 않는 값도 있습니다. ${!StoreLogs}는 리터럴 텍스트이며, 목록 형태의 맵이 지정하는 변수는 그 맵의 값입니다. 리소스의 Condition과 Fn::If의 첫 번째 인수는 조건을, Fn::FindInMap은 매핑을, Fn::ImportValue는 다른 스택의 익스포트를, Fn::GetAZs는 리전을 지정합니다. Conditions, Mappings, Parameters, Rules 섹션은 리소스를 지정할 수 없고, 템플릿 자체의 최상위 Metadata 섹션은 CloudFormation이 읽지 않고 저장만 하는 정보이므로, 이들 중 어느 것도 검사하지 않습니다. 논리적 ID 자체가 내장 함수로 작성된 Ref 또는 Fn::GetAtt는 스택 배포 시 이를 해석하는 AWS::LanguageExtensions 변환에서만 유효하므로(조립된 스택의 최상위 섹션 참조), 검사가 읽을 수 있는 리소스를 지정하지 않으며 그대로 남겨집니다. 소스가 선언한 적이 없는 리소스에 대한 참조도 마찬가지입니다.
검사는 항목을 선언한 Recipe 또는 FeatureRecipe 자체의 템플릿들을 함께 읽습니다. 이 템플릿들은 하나의 스택으로 조립되므로, 그중 다른 템플릿이 여전히 선언하는 논리적 ID에 대한 참조는 중단되지 않습니다. 그 외에는 아무것도 읽지 않습니다. 다른 컴포넌트가 같은 논리적 ID의 리소스를 선언하더라도 제외된 리소스에 대한 참조는 빌드를 중단시키며, 스택에 조립되는 다른 것(다른 컴포넌트, 연결된 Feature, 또는 Recipe 자체의 artifacts: 항목)이 만드는 참조는 이 검사가 보지 못하므로 배포 시 CloudFormation이 스택을 거부합니다. 참조를 유지하려면 리소스를 유지하십시오. 파라미터에 바인딩된 값은 해당 파라미터에 대한 참조만 대체하므로, 리소스에 대한 참조는 템플릿 자체의 것이며 값으로 바꿀 수 없습니다. 참조를 만드는 리소스도 함께 제외하거나 항목을 제거하십시오. 출력은 리소스가 아니며 어떤 항목도 출력을 지정하지 않으므로, 템플릿의 Outputs가 지정하는 리소스는 템플릿에서 제외할 수 없습니다. 이를 제외하면 빌드가 중단됩니다.
클라우드 대상 어노테이션
세 가지 경계 어노테이션은 스택이 배포되는 위치를 provider에 알려 주며, 이를 통해 provider는 스택 간 참조를 올바르게 연결할 수 있습니다:
aggrega.ai/aws-account— 스택이 배포되는 AWS 계정입니다.aggrega.ai/aws-region— 스택이 배포되는 AWS 리전입니다.aggrega.ai/aws-assume-role-arn— 계정 간 스택 읽기가 피어 스택의 내보낸 값에 접근하기 위해 수임하는 IAM 역할 ARN입니다.
이 어노테이션은 컴파일러에게 불투명합니다. 컴파일러는 값을 해석하지 않고 provider에 그대로 전달합니다(well-known-annotations.md 참조). 이 어노테이션은 생산자 경계, 즉 내보낸 값을 소유하는 스택에 작성합니다. 계정 간 읽기는 생산자의 계정으로 역할을 수임하므로, 읽기를 설명하는 계정, 리전, 역할은 모두 소비자가 아니라 생산자 경계의 어노테이션에서 가져옵니다.
스택 내부 참조
uses 간선이 동일한 boundary, 즉 같은 스택에 배치되는 두 컴포넌트를 연결하면, 소비되는 값은 하나의 템플릿 안에서 생산자 리소스의 논리적 ID를 대상으로 하는 Fn::GetAtt로 연결됩니다. 생산자의 provides 값은 네이티브 스택 내부 참조로서 소비자의 렌더링된 입력으로 전달되며, export나 import는 필요하지 않습니다. 소비자의 프래그먼트는 이러한 값을 그대로 Value: {{ .context.inject.env.DB_HOST }}로 쓸 수도 있고, 따옴표 안에 Value: "{{ .context.inject.env.DB_HOST }}"로 쓸 수도 있습니다. 어느 쪽이든 템플릿은 !GetAtt Db.Endpoint.Address를 내장 함수로 읽습니다. 정확히 하나의 짧은 형식인 문자열은 valuesMapping에서와 마찬가지로 프래그먼트에서도 그 내장 함수로서 스택에 도달하기 때문입니다. aws-rds-and-ecs-service 예제는 하나의 스택에서 Amazon ECS 작업 정의가 RDS 인스턴스의 주소를 읽는 경우로 이를 보여 줍니다.
스택 간 연결
uses 엣지가 한 경계에서 다른 경계로 넘어갈 때, 즉 두 구성 요소가 서로 다른 스택으로 조립될 때는 참조가 일반 값이 될 수 없습니다. 생성되는 값은 생산자 스택이 배포되기 전까지 존재하지 않기 때문입니다. 프로바이더는 이를 CloudFormation 스택 간 참조로 연결합니다. 생산자 스택은 결정적인 내보내기 이름(릴리스, 경계, 구성 요소, 제공 키에서 파생됨) 아래 Export가 있는 스택 Output으로 값을 게시합니다. 소비자 스택은 두 경계에 선언된 배치를 비교하여 선택한 두 내장 함수 중 하나로 값을 읽습니다.
Fn::ImportValue— 같은 계정, 같은 리전인 경우입니다. CloudFormation은 해당 계정과 리전 내에서 일치하는 내보내기 이름에 대해 가져오기를 해석합니다.Fn::GetStackOutput— 실제 교차 계정 또는 교차 리전 읽기입니다. 소비자는 생산자 경계의aws-assume-role-arn을 생산자의 계정과 리전으로 수임하여 생산자 스택의 출력을 직접 읽습니다.
감지 의미 체계. 프로바이더는 양쪽 엔드포인트가 모두 배치(계정/리전)를 선언하고 그 배치가 다를 때에만 Fn::GetStackOutput으로 연결합니다. 그 밖의 모든 경우, 즉 어느 쪽도 선언하지 않거나, 한쪽만 선언하거나, 양쪽이 같은 배치를 선언한 경우에는 Fn::ImportValue를 사용합니다. 이는 보수적인 규칙입니다. 같은 계정 내의 스택 간 읽기는 일반 가져오기로 유지되며, 직접 읽기 내장 함수는 실제 교차 계정 또는 교차 리전 이동에만 사용됩니다.
생산자 스택은 특정 소비자가 Fn::GetStackOutput을 통해 교차 계정으로 읽는 경우에도 항상 Export를 게시합니다. 사용되지 않는 내보내기는 아무 영향이 없으며, 이를 무조건 게시하면 생산자 템플릿이 각 소비자가 값을 읽는 방식과 무관하게 유지됩니다.
한 값을 여러 소비자가 읽으면 하나의 내보내기를 읽습니다. 둘 이상의 구성 요소가 경계를 넘어 같은 제공 값을 읽을 때, 즉 한 스택에 소비자가 둘 있거나 여러 스택에 소비자가 있을 때, 생산자 스택은 그 값의 Export를 한 번만 게시하고 모든 소비자는 그 하나의 이름을 읽습니다. 각 Fn::ImportValue는 같은 내보내기를 가져오며, 다른 계정이나 리전에 배치된 소비자는 Fn::GetStackOutput을 통해 같은 출력을 읽습니다. 다른 소비자가 읽지 않는 값을 추가로 읽는 소비자는 그 값의 내보내기만 추가합니다.
aws-rds-and-ecs-service 예제는 같은 계정인 경우를 구성합니다. RDS 인스턴스의 스택은 서버의 엣지가 소비하는 각 항목을 내보내고, 서버의 스택은 Fn::ImportValue로 각 항목을 다시 읽습니다.
버전 참고.
Fn::GetStackOutput은 CloudFormation 기본 내장 함수입니다. 이를 사용해 렌더링된 교차 계정 참조에는 이 내장 함수를 인식하는 CloudFormation 도구가 필요합니다. 같은 계정 경로는 어디서나 사용할 수 있는Fn::ImportValue를 사용합니다.
주입되는 대신 연결에서 읽는 값
소비자의 Recipe는 연결의 inject 블록을 통해 받는 대신 .context.uses.<alias>.provides를 통해 생산자의 값을 연결에서 직접 읽을 수 있습니다. 스택 경계를 넘을 때 이러한 읽기는 주입된 값과 같은 방식으로 연결됩니다.
- CloudFormation 내장 함수인 값, 즉
!GetAtt Db.Endpoint.Address같은 짧은 형식의 태그나 긴 형식의Ref또는Fn::매핑은 생산자의 스택만 선언하는 것을 가리키므로, 소비자는 주입된 값과 같은 교차 스택 참조를 받습니다. 생산자 스택은 해당 키에 대한Export를 게시하고, 소비자는 이를Fn::ImportValue로 읽으며, 두 경계가 서로 다른 배치를 선언한 경우에는Fn::GetStackOutput으로 읽습니다. - 일반 텍스트인 값, 즉 포트, 프로토콜, 데이터베이스 이름은 어느 스택에서나 같은 의미이므로, 소비자는 값 자체를 받고 그 값에 대한 export는 게시되지 않습니다. 값은 CloudFormation이 읽는 형태로 놓입니다. 통째로 쓴 값은 경계가 없었을 때와 같이 렌더링되고, 따옴표 안에 쓴 숫자 형태의 값은 숫자로 놓입니다.
값이 내장 함수인지는 이 provider가 생산자 자신의 provides 블록을 읽는 방식대로 값을 읽어 판단합니다. 컴파일러는 생산자의 Recipe가 쓴 그대로 값을 넘기며 이를 해석하지 않습니다.
템플릿은 이러한 값을 복사만 할 수 있습니다. 값을 통째로 쓰거나, 더 긴 문자열 안에 쓰거나, quote처럼 값을 그대로 두는 함수에 전달할 수 있습니다. 비교, 분기, 길이, 또는 값을 바꾸는 함수(eq, if, len, upper)는 값이 아닌 다른 것을 기준으로 결정됩니다. 이러한 연결에서 템플릿에 전달되는 것은 두 스택이 모두 조립된 뒤 provider가 교체하는 대체 값이기 때문입니다. 대신 빌드가 중단되며, 템플릿과 그것이 읽은 각 값을, 값을 읽어 온 연결 및 양 끝의 컴포넌트와 함께 명시합니다. 분기는 소비하는 컴포넌트 자신의 값을 기준으로 하십시오. 연결된 FeatureRecipe의 injectMapping과 경계의 연결을 읽는 boundary 범위 FeatureRecipe에도 같은 내용이 적용됩니다. 더 긴 문자열 안에 쓴 값은 provider 자체의 제한에도 걸립니다. 교차 스택 참조는 값 전체로만 존재할 수 있으므로, 더 긴 문자열 안에 쓴 내장 함수는 주입된 값의 경우와 마찬가지로 빌드를 중단시킵니다.
내보내기 이름을 만드는 방법
네 부분은 이중 하이픈으로 연결되며, 각 부분은 내보내기 이름을 구성하는 문자, 숫자, 하이픈으로 작성됩니다. 문자나 숫자는 그대로 유지되며, 부분 내부의 하이픈도 마찬가지입니다. payments-db는 payments-db 그대로입니다. 그 밖의 문자는 -z로 시작하는 짧은 이스케이프로 작성됩니다. 슬래시는 -zs, 밑줄은 -zu, 점은 -zd입니다. 값이 전혀 없는 부분은 -ze로 작성됩니다. 스택 이름도 릴리스와 경계로부터 같은 방식으로 만들어집니다.
따라서 릴리스 orders에서 dist/ 아래 출력 디렉터리가 stack-a/cloudformation인 경계의 구성 요소 db의 host를 게시하는 내보내기는 다음과 같습니다.
aggrega--orders--stack-a-zscloudformation--db--host이를 다시 읽으면 모호함이 없으며, 이는 부수적인 장점이 아니라 핵심입니다. 한 부분에는 하이픈이 두 개 연속으로 들어가지 않고 하이픈으로 끝나지도 않으므로, 이중 하이픈은 항상 연결 지점입니다. 따라서 서로 다른 두 부분 집합은 항상 서로 다른 두 이름을 만듭니다. payments-db와 payments_db는 하나로 합쳐지지 않고 별개의 두 내보내기가 되며, 한 부분 끝의 하이픈이 인접한 부분에 속한 것으로 읽힐 수 없습니다.
내보내기 이름의 고유성 범위와 그 한계
하나의 빌드 내에서 내보내기 이름은 정확히 하나의 릴리스, 경계, 구성 요소, 제공 키를 식별합니다. 어떤 두 조합도 하나의 이름으로 합쳐지지 않으므로, 빌드에서 한 내보내기 값이 다른 값에 가려 사라지는 일은 없습니다.
CloudFormation은 추가로 내보내기 이름이 스택이 배포되는 계정과 리전에 이미 배포된 모든 항목에 걸쳐 고유해야 한다고 요구합니다. 이는 빌드가 아니라 배포의 속성이며, 빌드 시점의 어떤 파생으로도 닿을 수 없는 범위에 있습니다. 컴파일러는 AWS에 인증하지 않고, AWS를 조회하지 않으며, 다른 빌드의 출력을 읽을 수 없으므로, 미리 계산된 어떤 것도 그곳에 이미 배포된 내용을 관찰할 수 없습니다.
그 경계를 넘어 구분을 유지하는 것은 모든 내보내기 이름과 스택 이름의 맨 앞에 오는 릴리스 식별자입니다. 계정과 리전을 공유하는 두 배포는 서로 다른 이름으로 릴리스됨으로써 내보내기를 구분합니다. 이것이 사용자가 조정할 수 있는 수단이며, 릴리스 식별자가 이름의 뒤가 아니라 앞에 오는 이유입니다.
Outputs 항목은 자체 내보내기 이름을 선언할 수 있음
Recipe의 Outputs: 블록은 작성된 CloudFormation이며, 그 안의 항목은 Name:이 있는 자체 Export:를 가질 수 있습니다. 그 이름은 작성된 그대로 조립된 스택에 도달합니다. 프로바이더는 이를 다시 쓰지 않고, 접두사를 붙이지 않으며, 파생된 이름처럼 보이도록 요구하지도 않습니다.
대개는 이에 대해 더 말할 것이 없습니다. 프로바이더가 파생하는 어떤 이름과도 일치하지 않는 작성된 내보내기 이름은 파생된 이름들과 함께 게시되며 별도로 언급되지 않습니다. 이러한 작성은 지원되며, 지원되지 않는 것은 단 하나의 우연한 일치뿐입니다.
작성된 내보내기 이름이 같은 빌드에서 프로바이더가 경계 간 링크에 대해 파생하는 이름과 같으면 빌드가 중단됩니다. 두 선언이 모두 조립된 템플릿에 도달하면 한 스택에 하나의 내보내기 이름이 두 번 선언되는데, 내보내기 이름은 고유해야 하므로 둘 다 존재할 수 없습니다. 중단 시에는 파생된 내보내기 이름과 그 이름을 만든 네 부분이 제시되므로 어떤 링크가 이를 생성했는지 확인할 수 있으며, 작성된 선언이 속한 스택 출력도 표시됩니다. 이 출력은 Recipe가 작성한 이름이 아니라 프로바이더가 조립한 이름으로 표시됩니다. Recipes에서 검색할 대상은 내보내기 이름입니다. 작성된 항목은 중단 메시지와 정확히 같은 철자로 이를 표기하며, 바로 이 일치가 둘을 충돌로 만드는 요인이므로, 이것이 메시지와 사용자 자신의 파일 양쪽에 나타나는 유일한 문자열입니다. 해당 항목이 선언하는 내보내기 이름을 바꾸면 중단이 해소되며, 해당 항목의 Export: 블록을 제거하고 스택 간 연결이 직접 내보내기를 게시하도록 해도 해소됩니다.
이 검사는 빌드 범위의 검사이며, 그 범위는 하나의 스택입니다. 조립된 스택이 선언하는 내보내기 이름을, 같은 스택에 게시하는 경계 간 링크에 대해 프로바이더가 파생하는 이름과 비교합니다. 이는 빌드가 자신이 조립한 것으로부터 수행할 수 있는 비교입니다. 두 스택은 서로 비교되지 않습니다. 그리고 작성된 이름이 계정과 리전에 이미 배포된 내보내기들 중 무엇과 만나는지는 배포의 속성으로, 내보내기 이름의 고유성 범위와 그 한계에서 설명한 이유로 빌드 시점의 어떤 파생으로도 닿을 수 없는 범위에 있습니다. 컴파일러는 AWS에 인증하지 않고, AWS를 조회하지 않으며, 다른 빌드의 출력을 읽을 수 없습니다. 일반 문자열이 아니라 내장 함수로 작성된 내보내기 이름도 같은 경계의 너머에 있습니다. 이는 배포 시점에 해석되며, 여기서는 어떤 내장 함수도 평가하지 않으므로 빌드가 비교할 이름이 없습니다.
경계 간 링크가 게시하는 출력에 링크가 작성하지 않은 Export가 이미 있는 경우에도 빌드가 중단됩니다. 그 출력은 소비자가 읽는 제공 키에 대해 프로바이더가 조립하는 출력이므로, Outputs: 블록에서 같은 키 아래에 자체 Export:를 가진 항목을 작성한 Recipe는 링크의 내보내기가 들어갈 바로 그 자리에 자신의 내보내기를 두게 됩니다. 그 내보내기의 이름이 프로바이더가 파생하는 이름과 정확히 같은 경우(이때는 링크 자신의 내보내기이며 모든 소비자가 이를 가져옵니다)가 아니라면, 둘은 그 자리에 함께 존재할 수 없습니다. 링크의 내보내기를 작성하면 사용자의 내보내기를 덮어쓰게 되고, 사용자의 내보내기를 유지하면 모든 소비자가 링크가 게시하지 않은 이름을 가져오게 됩니다. 중단 시에는 파생된 내보내기 이름과 그 이름을 만든 네 부분이 제시되며, 해당 출력에서 발견한 것, 즉 항목이 선언한 내보내기 이름, 내장 함수로 작성된 이름, 아무것도 지정하지 않는 Export: 블록, 또는 블록이 아니라 일반 값으로 작성된 Export: 중 무엇인지가 표시됩니다. 해당 항목의 Export: 블록을 제거하면 중단이 해소되며, 그러면 스택 간 연결이 모든 소비자가 가져오는 내보내기를 게시합니다.
배포 순서
Release 경계의 syncWave: 값은 해당 경계가 조립되는 스택의 프로비저닝 순서를 정합니다. 경계 안의 모든 컴포넌트는 경계의 웨이브를 상속하며, 여러 경계가 같은 출력 디렉터리로 해석되어 그 프래그먼트가 하나의 템플릿으로 조립되는 경우에는 스택이 둘 이상의 웨이브를 담게 되고, 프로바이더는 웨이브 사이의 순서를 DependsOn으로 표현합니다.
각 리소스는 리소스가 하나라도 있는 바로 이전 웨이브의 모든 리소스를 지정하며, 그보다 더 이전의 웨이브는 지정하지 않습니다. 나머지 연결은 CloudFormation이 이어 줍니다. 웨이브 2의 리소스는 웨이브 1에 의존하고, 그 웨이브는 다시 웨이브 0에 의존하므로, 전체 순서가 정해지면서도 각 리소스의 목록은 스택 전체가 아니라 한 웨이브 크기로 유지됩니다. 웨이브는 연속적일 필요가 없으며 음수 값도 흔히 쓰입니다. -1은 스택의 나머지 부분이 읽는 버킷이나 역할에 자주 선택되는 값입니다. 가장 낮은 웨이브는 그보다 앞서는 것이 없으므로 아무것도 지정하지 않습니다.
이 순서는 생성 순서이며, 역으로는 삭제 순서입니다. CloudFormation은 가능한 한 리소스를 병렬로 처리하며, DependsOn은 그 병렬성을 무시하고 지정된 리소스를 명시된 순서로 처리하게 합니다. 이 속성은 양방향 모두에 적용되므로, 리소스를 먼저 생성하는 웨이브는 그 리소스를 나중에 삭제합니다. 올바른 해체 순서는 별도의 조치 없이 순서 지정과 함께 따라옵니다.
이것은 준비 상태 순서가 아닙니다. 스택 템플릿에는 리소스가 서비스 가능한 상태라는 개념이 없으므로, 여기서는 리소스가 준비되기를 기다리지 않고 CloudFormation이 생성을 마치기만을 기다립니다. 이는 compose의 같은 웨이브와 실제로 다른 점입니다. compose에서는 healthcheck를 선언한 서비스가 정상으로 보고할 때까지 대기합니다. compose에는 기준으로 삼을 준비 상태 기본 요소가 있지만 스택 템플릿에는 없습니다. 이 타깃이 제공하는 것은 생성 순서이며, 지킬 수 없는 약속에 단서를 붙이기보다 이를 분명히 밝히는 편이 더 유용합니다.
작성된 DependsOn은 확장될 뿐 대체되지 않습니다. 자체 순서 제약을 선언한 프래그먼트는 그 제약을 유지합니다. 작성된 항목은 작성된 순서대로 앞에 오고, 웨이브의 항목이 그 뒤를 따릅니다. 두 요구 사항이 모두 유지되며 어느 쪽도 다른 쪽을 가리지 않습니다. 단일 논리적 ID와 목록을 모두 읽으며, 병합된 값은 목록으로 출력됩니다. 목록은 병합 결과 항목이 몇 개이든 유효한 유일한 표기입니다.
모든 리소스가 하나의 웨이브를 갖는 스택은 이 기능의 영향을 받지 않습니다. syncWave를 전혀 선언하지 않은 Release도 마찬가지입니다. 모든 기여자가 이 필드의 기본값 0을 가지므로 조립된 템플릿은 하나의 웨이브만 담고, 출력은 프로바이더가 웨이브 순서를 전혀 표현하지 않았을 때와 정확히 같습니다.
두 스택 사이의 순서는 표현할 수 없으며, 근사하지도 않습니다. DependsOn은 같은 템플릿 안의 리소스를 지정하며, 다른 스택으로 조립되는 컴포넌트는 그 밖에 있습니다. 따라서 웨이브는 자신이 조립되는 스택 안의 모든 리소스의 순서를 정할 뿐 그 너머에는 미치지 않습니다. 두 스택의 순서를 정하는 것은 운영자의 몫이며, 이는 스택 간 참조가 빌드 시점이 아니라 배포 시점에 해석되는 것과 같습니다.
웨이브가 표현하지 않는 순서는 CloudFormation이 맡으며, 리소스 간 참조가 이미 그 상당 부분을 담고 있습니다. 생산자 리소스에 대한 Fn::GetAtt는 CloudFormation에 그 리소스를 먼저 생성하라고 알립니다. 참조와 웨이브 어느 쪽도 암시하지 않는 제약이 필요한 프래그먼트는 DependsOn을 직접 작성하며, 이것이 위에서 설명한 병합이 보존하는 경우입니다.
결정성
동일한 입력이 주어지면 provider는 실행할 때마다 바이트 단위로 동일한 스택 템플릿을 생성합니다. 논리적 ID, 출력 키, 내보내기 이름, 리소스 순서가 모두 결정적이므로 CloudFormation 스택 템플릿은 GitOps 리뷰에서 깔끔한 diff를 보여 줍니다.