기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CloudFormation 템플릿에서 스택 \| 업데이트 CFN 스택의 템플릿 및/또는 파라미터를 업데이트합니다. 수정된 CFN 템플릿이 필요하지 않은 기존 스택의 파라미터만 업데이트하려면 수정된 파라미터를 대신 제공할 수 있습니다. 기존 파라미터의 값을 덮어쓰고 새 파라미터의 값이 추가됩니다. 리소스를 추가, 삭제 또는 수정하거나 파라미터를 통해 참조되지 않는 속성을 변경하려면 수정된 CFN 템플릿을 사용합니다. 업데이트로 인해 스택의 리소스가 교체되거나 제거되는 경우 RFC가 실패하고 "ChangeSet 승인 및 CloudFormation 스택 업데이트" CT(ct-1404e21baa2ox)를 통한 승인이 필요합니다. **전체 분류:** 관리 \| 사용자 지정 스택 \| CloudFormation 템플릿의 스택 \| 업데이트 ## 변경 유형 세부 정보 **** | | | | --- |--- | | 유형 ID 변경 | ct-361tlo1k7339x | | 현재 버전 | 2.0 | | 예상 실행 기간 | 360분 | | AWS 승인 | 필수 | | 고객 승인 | 불필요 | | 실행 모드 | 자동 | ## 추가 정보 ### CloudFormation 수집 스택 업데이트 #### 콘솔을 사용하여 CloudFormation 수집 스택 업데이트 ![](http://docs.aws.amazon.com/ko_kr/managedservices/latest/ctref/images/guiCfnStackUpdateCT-v2.png) **콘솔을 사용하여 CloudFormation Ingest Stack을 업데이트하려면** 1. **RFC 생성** 페이지로 이동합니다. AMS 콘솔의 왼쪽 탐색 창에서 **RFCs** 클릭하여 RFCs 목록 페이지를 연 다음 **RFC 생성을** 클릭합니다. 1. 기본 변경 유형 **찾아보기 보기에서 널리 사용되는 변경 유형**(CT)을 선택하거나 **범주별 선택** 보기에서 CT를 선택합니다. + **변경 유형별 찾아보**기: **빠른 생성** 영역에서 인기 있는 CT를 클릭하여 **RFC 실행** 페이지를 즉시 열 수 있습니다. 빠른 생성으로 이전 CT 버전을 선택할 수 없습니다. CTs 정렬하려면 **카드** 또는 **테이블** 보기에서 **모든 변경 유형** 영역을 사용합니다. 어느 보기에서든 CT를 선택한 다음 **RFC 생성을** 클릭하여 **RFC 실행** 페이지를 엽니다. 해당하는 경우 RFC **생성 버튼 옆에 이전 버전으로** 생성 옵션이 나타납니다. **** + **범주별 선택**: 범주, 하위 범주, 항목 및 작업을 선택하면 해당하는 경우 **이전 버전으로 생성** 옵션이 있는 CT 세부 정보 상자가 열립니다. **RFC 생성을** 클릭하여 **RFC 실행** 페이지를 엽니다. 1. **RFC 실행** 페이지에서 CT 이름 영역을 열어 CT 세부 정보 상자를 확인합니다. **제목**은 필수입니다(**변경 유형 찾아보**기 보기에서 CT를 선택하면 입력됨). **추가 구성** 영역을 열어 RFC에 대한 정보를 추가합니다. **실행 구성** 영역에서 사용 가능한 드롭다운 목록을 사용하거나 필요한 파라미터의 값을 입력합니다. 선택적 실행 파라미터를 구성하려면 **추가 구성** 영역을 엽니다. 1. 완료되면 **실행**을 클릭합니다. 오류가 없는 경우 **성공적으로 생성된 RFC** 페이지에 제출된 RFC 세부 정보와 초기 **실행 출력**이 표시됩니다. 1. **실행 파라미터** 영역을 열어 제출한 구성을 확인합니다. 페이지를 새로 고쳐 RFC 실행 상태를 업데이트합니다. 선택적으로 RFC를 취소하거나 페이지 상단의 옵션을 사용하여 RFC 사본을 생성합니다. #### CLI를 사용하여 CloudFormation 수집 스택 업데이트 **CLI를 사용하여 CloudFormation 수집 스택을 업데이트하려면** 1. 인라인 생성(모든 RFC 및 실행 파라미터가 포함된 `create-rfc` 명령을 실행) 또는 템플릿 생성(2개의 JSON 파일 생성, 하나는 RFC 파라미터용이고 다른 하나는 실행 파라미터용)을 사용하고 두 파일을 입력으로 사용하여 `create-rfc` 명령을 실행합니다. 두 방법 모두 여기에 설명되어 있습니다. 1. 반환된 RFC ID로 RFC: `aws amscm submit-rfc --rfc-id {{ID}}` 명령을 제출합니다. RFC: `aws amscm get-rfc --rfc-id {{ID}}` 명령을 모니터링합니다. 변경 유형 버전을 확인하려면 다음 명령을 사용합니다. ``` aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}} ``` **참고** 변경 유형에 대한 스키마의 일부인지 여부에 관계없이 모든 `CreateRfc` 파라미터를 RFC와 함께 사용할 수 있습니다. 예를 들어 RFC 상태가 변경될 때 알림을 받으려면 요청의 `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` RFC 파라미터 부분(실행 파라미터 아님)에이 줄을 추가합니다. 모든 CreateRfc 파라미터 목록은 [AMS Change Management API 참조](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html)를 참조하세요. 1. 스택을 업데이트하는 데 사용할 CloudFormation 템플릿을 준비하고 S3 버킷에 업로드합니다. 중요한 세부 정보는 [AWS CloudFormation 수집 지침, 모범 사례 및 제한을 참조하세요](https://docs.aws.amazon.com/managedservices/latest/appguide/cfn-author-templates.html). 1. RFC를 생성하여 AMS에 제출합니다. 1. 실행 파라미터 JSON 파일을 생성 및 저장하고 원하는 CloudFormation 템플릿 파라미터를 포함합니다. 이 예제에서는 UpdateCfnParams.json. 인라인 파라미터 업데이트가 포함된 UpdateCfnParams.json 파일의 예: ``` { "StackId": "{{stack-yjjoo9aicjyqw4ro2}}", "VpcId": "{{VPC_ID}}", "CloudFormationTemplate": "{\"AWSTemplateFormatVersion\":\"{{2010-09-09}}\",\"Description\":\"{{Create a SNS topic}}\",\"Parameters\":{\"{{TopicName}}\":{\"Type\":\"String\"},\"DisplayName\":{\"Type\":\"String\"}},\"{{Resources}}\":{\"SnsTopic\":{\"Type\":\"AWS::SNS::Topic\",\"Properties\":{\"TopicName\":{\"Ref\":\"TopicName\"},\"DisplayName\":{\"Ref\":\"DisplayName\"}}}}}", "TemplateParameters": [ { "Key": "TopicName", "Value": "{{TopicNameCLI}}" }, { "Key": "DisplayName", "Value": "{{DisplayNameCLI}}" } ], "TimeoutInMinutes": 1440 } ``` 업데이트된 CloudFormation 템플릿이 포함된 S3 버킷 엔드포인트가 있는 UpdateCfnParams.json 파일의 예: ``` { "StackId": "{{stack-yjjoo9aicjyqw4ro2}}", "VpcId": "{{VPC_ID}}", "CloudFormationTemplateS3Endpoint": "{{s3_url}}", "TemplateParameters": [ { "Key": "TopicName", "Value": "{{TopicNameCLI}}" }, { "Key": "DisplayName", "Value": "{{DisplayNameCLI}}" } ], "TimeoutInMinutes": {{1080}} } ``` 1. 다음 콘텐츠와 함께 RFC 파라미터 JSON 파일을 생성하고 저장합니다. 이 예제에서는 UpdateCfnRfc.json 파일의 이름을 지정합니다. ``` { "ChangeTypeId": "ct-361tlo1k7339x", "ChangeTypeVersion": "1.0", "Title": "{{cfn-ingest-template-update}}" } ``` 1. UpdateCfnRfc 파일과 UpdateCfnParams 파일을 지정하여 RFC를 생성합니다. ``` aws amscm create-rfc --cli-input-json file://UpdateCfnRfc.json --execution-parameters file://UpdateCfnParams.json ``` 응답에서 새 RFC의 ID를 수신하고 이를 사용하여 RFC를 제출하고 모니터링할 수 있습니다. 제출하기 전까지는 RFC가 편집 상태로 유지되고 시작되지 않습니다. #### 팁 + 이 변경 유형은 이제 버전 2.0입니다. 변경 사항에는이 CT 버전 1.0에서 사용된 **AutoApproveUpdateForResources** 파라미터 제거와 **AutoApproveRiskyUpdates** 및 **BypassDriftCheck**라는 두 가지 새 파라미터 추가가 포함됩니다. + S3 버킷이 AMS 계정에 있는 경우이 명령에 AMS 자격 증명을 사용해야 합니다. 예를 들어 AMS AWS Security Token Service (AWS STS) 자격 증명을 얻은 `--profile saml` 후를 추가해야 할 수 있습니다. + CloudFormation 템플릿의 리소스에 대한 모든 `Parameter` 값은 기본값을 통해 또는 CT의 파라미터 섹션을 통해 사용자 지정 값을 가져야 합니다. 파라미터 키를 참조하도록 CloudFormation 템플릿 리소스를 구조화하여 파라미터 값을 재정의할 수 있습니다. 수행 방법을 보여주는 예제는 [CloudFormation 수집 스택: CFN 검사기 예제](https://docs.aws.amazon.com/managedservices/latest/appguide/ex-cfn-ingest-validator.html)를 참조하세요. 중요: 양식에 명시적으로 제공되지 않은 파라미터가 누락되었습니다. 기본값은 기존 스택 또는 템플릿에서 현재 설정된 값입니다. + CloudFormation Ingest를 사용하여 추가할 수 있는 자체 프로비저닝된 서비스의 목록은 [CloudFormation Ingest Stack: Supported Resources](https://docs.aws.amazon.com/managedservices/latest/appguide/cfn-ingest-supp-services.html)를 참조하세요. 에 대한 자세한 내용은 [AWS Cloud Formation](https://aws.amazon.com/cloudformation/)을 CloudFormation참조하세요. #### CloudFormation 수집 검증 템플릿은 AMS 계정에서 생성할 수 있도록 검증되었습니다. 검증을 통과하면 AMS를 준수하는 데 필요한 리소스 또는 구성을 포함하도록 업데이트됩니다. 여기에는 AMS Operations가 스택을 모니터링할 수 있도록 Amazon CloudWatch 경보와 같은 리소스 추가가 포함됩니다. 다음 중 하나에 해당하는 경우 RFC가 거부됩니다. + RFC JSON 구문이 잘못되었거나 지정된 형식을 따르지 않습니다. + 제공된 S3 버킷 미리 서명된 URL이 유효하지 않습니다. + 템플릿이 유효한 CloudFormation 구문이 아닙니다. + 템플릿에는 모든 파라미터 값에 대해 기본값이 설정되어 있지 않습니다. + 템플릿이 AMS 검증에 실패합니다. AMS 검증 단계는이 주제 뒷부분의 정보를 참조하세요. 리소스 생성 문제로 인해 CloudFormation 스택이 생성되지 않으면 RFC가 실패합니다. CFN 검증 및 검사기에 대한 자세한 내용은 [템플릿 검증](https://docs.aws.amazon.com/managedservices/latest/appguide/cfn-author-templates.html) 및 [CloudFormation 수집 스택: CFN 검사기 예제](https://docs.aws.amazon.com/managedservices/latest/appguide/ex-cfn-ingest-validator.html)를 참조하세요. ## 실행 입력 파라미터 실행 입력 파라미터에 대한 자세한 내용은 섹션을 참조하세요[변경 유형 ct-361tlo1k7339x 스키마](schemas.md#ct-361tlo1k7339x-schema-section). ## 예: 필수 파라미터 ``` { "StackId": "stack-kiwonebfnadq08sol", "VpcId": "vpc-01234567890abcdef", "TimeoutInMinutes": 360 } ``` ## 예: 모든 파라미터 ``` Example not available. ```