지원 종료 알림: 2026년 10월 7일에 AWS 에 대한 지원이 종료됩니다 AWS Proton. 2026년 10월 7일 이후에는 AWS Proton 콘솔 또는 AWS Proton 리소스에 더 이상 액세스할 수 없습니다. 배포된 인프라는 그대로 유지됩니다. 자세한 내용은 [AWS Proton 서비스 사용 중단 및 마이그레이션 안내서](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Proton 파라미터
IaC(코드형 인프라) 파일에서 파라미터를 정의하고 사용하여 유연하고 재사용 가능하게 만들 수 있습니다. 네임 AWS Proton *스페이스*에서 파라미터의 이름을 참조하여 IaC 파일의 파라미터 값을 읽습니다. 파라미터 값은 리소스 프로비저닝 중에 생성하는 렌더링된 IaC 파일에 AWS Proton 주입됩니다. AWS CloudFormation IaC 파라미터를 처리하려면 [Jinja](https://jinja.palletsprojects.com/en/2.11.x/)를 AWS Proton 사용합니다. Terraform IaC 파라미터를 처리하기 위해는 Terraform 파라미터 값 파일을 AWS Proton 생성하고 HCL에 내장된 파라미터화 기능에 의존합니다.
를 사용하면 코드가 가져올 수 있는 입력 파일을 [CodeBuild 프로비저닝](ag-works-prov-methods.md#ag-works-prov-methods-codebuild) AWS Proton 생성합니다. 파일은 템플릿 매니페스트의 속성에 따라 JSON 또는 HCL 파일입니다. 자세한 내용은 [CodeBuild 프로비저닝 파라미터 세부 정보 및 예제](parameters-codebuild.md) 단원을 참조하세요.
환경, 서비스, 구성 요소 IaC 파일의 파라미터 또는 프로비저닝 코드에서 다음 요구 사항을 참조할 수 있습니다.
+ 각 파라미터 이름의 길이는 100자를 초과할 수 없습니다.
+ 파라미터 네임스페이스와 리소스 이름을 합친 길이는 리소스 이름의 문자 제한을 초과하지 않습니다.
AWS Proton 이러한 할당량을 초과하면 프로비저닝이 실패합니다.
## 파라미터 유형
다음 파라미터 유형을 AWS Proton IaC 파일에서 참조할 수 있습니다.
**입력 파라미터**
환경 및 서비스 인스턴스는 환경 또는 서비스 템플릿에 연결하는 [스키마 파일](ag-schema.md)에 정의한 입력 파라미터를 사용할 수 있습니다. 리소스의 IaC 파일에서 리소스의 입력 파라미터를 참조할 수 있습니다. 구성 요소 IaC 파일은 구성 요소가 연결된 서비스 인스턴스의 입력 파라미터를 참조할 수 있습니다.
AWS Proton 는 스키마 파일에 대해 입력 파라미터 이름을 확인하고 IaC 파일에서 참조되는 파라미터와 일치시켜 리소스 프로비저닝 중에 사양 파일에 제공하는 입력 값을 주입합니다.
**출력 파라미터**
모든 IaC 파일에서 출력을 정의할 수 있습니다. 출력은 예를 들어 템플릿에서 제공하는 리소스 중 하나의 이름, ID 또는 ARN일 수도 있고 템플릿의 입력 중 하나를 전달하는 방법일 수도 있습니다. 다른 리소스의 IaC 파일에서 이러한 출력을 참조할 수 있습니다.
클라우드포메이션 IaC 파일에서 `Outputs:` 블록의 출력 파라미터를 정의합니다. Terraform IaC 파일에서 `output` 명령문을 사용하여 각 출력 파라미터를 정의합니다.
**리소스 파라미터**
AWS Proton 는 AWS Proton 리소스 파라미터를 자동으로 생성합니다. 이러한 파라미터는 AWS Proton 리소스 객체의 속성을 노출합니다. 리소스 파라미터의 예는 `environment.name`입니다.
## IaC 파일에서 AWS Proton 파라미터 사용
IaC 파일에서 파라미터 값을 읽으려면 파라미터 네임스페이스에서 AWS Proton 파라미터 이름을 참조합니다. AWS CloudFormation IaC 파일의 경우 *Jinja* 구문을 사용하고 파라미터를 중괄호와 따옴표 쌍으로 묶습니다.
다음 표는 지원되는 각 템플릿 언어에 대한 참조 구문을 예제와 함께 보여 줍니다.
| 템플릿 언어 | 구문 | 예: "VPC"라는 이름의 환경 입력 |
| --- | --- | --- |
| CloudFormation | `"{{ parameter-name }}"` | `"{{ environment.inputs.VPC }}"` |
| Terraform | `var.parameter-name` | `var.environment.inputs.VPC` [생성된 테라폼 변수 정의](ag-infrastructure-tmp-files-terraform.md#compiled-tform) |
**참고**
IaC 파일에서 [CloudFormation 동적 파라미터](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html)를 사용하는 경우 Jinja의 오해 오류를 방지하려면 [파라미터를 이스케이프 처리](https://jinja.palletsprojects.com/en/2.11.x/templates/#escaping)해야 합니다. 자세한 내용은 [문제 해결 AWS Proton](ag-troubleshooting.md) 섹션을 참조하세요.
다음 표에는 모든 AWS Proton 리소스 파라미터의 네임스페이스 이름이 나열되어 있습니다. 각 템플릿 파일 형식은 파라미터 네임스페이스의 다른 하위 집합을 사용할 수 있습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/proton/latest/userguide/parameters.html)
자세한 내용과 예제는 다양한 리소스 유형 및 템플릿 언어에 대한 IaC 템플릿 파일의 파라미터에 대한 하위 항목을 참조하세요.
**Topics**
+ [파라미터 유형](#param-name-types)
+ [IaC 파일에서 AWS Proton 파라미터 사용](#param-name-spaces)
+ [환경 CloudFormation IaC 파일 파라미터 세부 정보 및 예제](env-parameters.md)
+ [CloudFormation IaC 파일 파라미터 세부 정보 및 예제](svc-parameters.md)
+ [구성 요소 CloudFormation IaC 파일 파라미터 세부 정보 및 예제](comp-parameters.md)
+ [CloudFormation IaC 파일용 파라미터 필터](parameter-filters.md)
+ [CodeBuild 프로비저닝 파라미터 세부 정보 및 예제](parameters-codebuild.md)
+ [Terraform 코드형 인프라(IaC) 파일 파라미터 세부 정보 및 예제](env-parameters-tform.md)