# Systems Manager 파라미터를 사용하여 AMI 참조
Amazon EC2 콘솔에서 EC2 인스턴스 시작 마법사를 사용하여 인스턴스를 시작할 때 목록에서 AMI를 선택하거나 AMI ID(이 섹션에서 설명)를 가리키는 AWS Systems Manager 파라미터를 선택할 수 있습니다. 자동화 코드를 사용하여 인스턴스를 시작하는 경우 AMI ID 대신 Systems Manager 파라미터를 지정할 수 있습니다.
Systems Manager 파라미터는 Systems Manager 파라미터 스토어에서 생성할 수 있는 고객 정의 키-값 페어입니다. 파라미터 스토어는 애플리케이션 구성 값을 외부화할 수 있는 중앙 스토어를 제공합니다. 자세한 내용은 *AWS Systems Manager 사용 설명서*에서 [AWS Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html)를 참조하세요.
AMI ID를 가리키는 파라미터를 생성할 때는 데이터 유형을 `aws:ec2:image`로 지정해야 합니다. 이 데이터 유형을 지정하면 파라미터가 생성되거나 수정될 때 파라미터 값이 AMI ID로 확인됩니다. 자세한 내용은 AWS Systems Manager 사용 설명서**에서 [Amazon Machine Image ID에 대한 기본 파라미터 지원](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-ec2-aliases.html)을 참조하세요.
**Topics**
+ [사용 사례](#systems-manager-parameter-use-case)
+ [권한](#systems-manager-permissions)
+ [제한 사항](#AMI-systems-manager-parameter-limitations)
+ [Systems Manager 파라미터를 사용하여 인스턴스 시작](#systems-manager-parameter-launch-instance)
## 사용 사례
Systems Manager 파라미터를 사용하여 AMI ID를 가리키면 사용자가 인스턴스를 시작할 때 올바른 AMI를 더 쉽게 선택할 수 있습니다. Systems Manager 파라미터를 통해 자동화 코드의 유지 관리가 간소화될 수도 있습니다
**사용자의 사용 편의성 향상**
특정 AMI를 사용하여 인스턴스를 시작해야 하고 AMI가 정기적으로 업데이트되는 경우 사용자가 Systems Manager 파라미터를 선택하여 AMI를 찾도록 하는 것이 좋습니다. 사용자에게 Systems Manager 파라미터를 선택하도록 하면 인스턴스를 시작하는 데 최신 AMI가 사용될 수 있습니다.
예를 들어 조직에서 매달 최신 운영 체제 및 애플리케이션 패치가 포함된 새 버전의 AMI를 생성하며 사용자가 최신 버전의 AMI를 사용하여 인스턴스를 시작하도록 하려는 경우, 사용자가 최신 버전을 사용하도록 올바른 AMI ID를 가리키는 Systems Manager 파라미터(예: `golden-ami`)를 생성할 수 있습니다. 새 버전의 AMI가 생성될 때마다 이 파라미터의 AMI ID 값을 업데이트하여 항상 최신 AMI를 가리키도록 합니다. 사용자는 매번 동일한 Systems Manager 파라미터를 계속 선택하므로 AMI에 대한 정기 업데이트에 대해 알 필요가 없습니다. AMI에 대한 Systems Manager 파라미터를 사용하면 사용자가 인스턴스 시작에 대한 올바른 AMI를 더 쉽게 선택할 수 있습니다.
**자동화 코드 유지 관리 간소화**
자동화 코드를 사용하여 인스턴스를 시작하는 경우 AMI ID 대신 Systems Manager 파라미터를 지정할 수 있습니다. 새 버전의 AMI가 생성되면 최신 AMI를 가리키도록 이 파라미터의 AMI ID 값을 변경할 수 있습니다. 파라미터를 참조하는 자동화 코드는 새 버전의 AMI가 생성될 때마다 수정할 필요가 없습니다. 이를 통해 자동화 유지 관리가 간소화되며 배포 비용을 절감할 수 있습니다.
**참고**
Systems Manager 파라미터가 가리키는 AMI ID를 변경해도 실행 중인 인스턴스는 영향을 받지 않습니다.
## 권한
인스턴스 시작 마법사에서 AMI ID를 가리키는 Systems Manager 파라미터를 사용하는 경우 IAM 정책에 다음 권한을 추가해야 합니다.
+ `ssm:DescribeParameters` – Systems Manager 파라미터를 보고 선택할 수 있는 권한을 부여합니다.
+ `ssm:GetParameters` – Systems Manager 파라미터 값을 검색할 수 있는 권한을 부여합니다.
특정 Systems Manager 파라미터에 대한 액세스를 제한할 수도 있습니다. 자세한 내용과 IAM 정책 예는 [예: EC2 인스턴스 시작 마법사 사용](iam-policies-ec2-console.md#ex-launch-wizard) 섹션을 참조하세요.
## 제한 사항
AMI 및 Systems Manager 파라미터는 리전별로 다릅니다. 여러 리전에서 동일한 Systems Manager 파라미터 이름을 사용하려면 동일한 이름(예: `golden-ami`)을 가진 Systems Manager 파라미터를 각 리전에 생성합니다. 각 리전에서 Systems Manager 파라미터가 해당 리전의 AMI를 가리키도록 지정합니다.
파라미터 이름은 대/소문자를 구분합니다. 파라미터 이름의 백슬래시는 파라미터가 계층 구조의 일부인 경우에만 필요합니다(예: `/amis/production/golden-ami`). 파라미터가 계층의 일부가 아닌 경우 백슬래시를 생략할 수 있습니다.
## Systems Manager 파라미터를 사용하여 인스턴스 시작
인스턴스를 시작할 때 AMI ID를 지정하는 대신 AMI ID를 가리키는 Systems Manager 파라미터를 지정할 수 있습니다.
프로그래밍 방식으로 파라미터를 지정하려면 다음 구문을 사용합니다. 여기서 `resolve:ssm`은 표준 접두사이고 `parameter-name`은 고유한 파라미터 이름입니다.
```
resolve:ssm:parameter-name
```
Systems Manager 파라미터는 버전을 지원합니다. 파라미터의 각 이터레이션에는 고유한 버전 번호가 지정됩니다. 다음과 같이 파라미터의 버전을 참조할 수 있습니다. 여기서 `version`은 고유한 버전 번호입니다. 버전이 지정되지 않은 경우 기본적으로 최신 버전의 파라미터가 사용됩니다.
```
resolve:ssm:parameter-name:version
```
AWS에서 제공하는 퍼블릭 파라미터를 사용하여 인스턴스를 시작하려면 [Systems Manager 퍼블릭 파라미터를 사용하여 최신 AMI 참조](finding-an-ami-parameter-store.md)를 참조하세요.
------
#### [ Console ]
**Systems Manager 파라미터를 사용하여 AMI 찾으려면**
1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)에서 Amazon EC2 콘솔을 엽니다.
1. 탐색 모음에서 인스턴스를 실행할 리전을 선택합니다. 현재 위치와 관계없이 사용자가 고를 수 있는 리전을 임의로 선택합니다.
1. 콘솔 대시보드에서 **인스턴스 시작(Launch instance)**을 선택합니다.
1. **Application and OS Images (Amazon Machine Image)**(애플리케이션 및 OS 이미지(Amazon Machine Image))에서 **Browse more AMIs**(더 많은 AMI 찾아보기)를 선택하세요.
1. 검색 창 오른쪽에 있는 화살표 버튼을 선택한 다음 **Search by Systems Manager parameter**(Systems Manager 파라미터로 검색)를 선택하세요.
1. [**Systems Manager 파라미터(Systems Manager parameter)**]에서 파라미터를 선택합니다. 해당 AMI ID가 **Currently resolves to**(현재 확인된 값) 아래 나타납니다.
1. **검색**을 선택합니다. AMI ID와 일치하는 AMI가 목록에 나타납니다.
1. 목록에서 해당 AMI를 선택하고 **선택**을 선택합니다.
인스턴스 시작 마법사를 사용하여 인스턴스를 시작하는 방법에 대한 자세한 내용은 [콘솔에서 인스턴스 시작 마법사를 사용하여 EC2 인스턴스 시작](ec2-launch-instance-wizard.md) 섹션을 참조하세요.
------
#### [ AWS CLI ]
**Systems Manager 파라미터를 사용하여 인스턴스를 시작하려면**
[run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) 명령을 `--image-id` 옵션과 함께 사용합니다. 이 예제에서는 AMI ID를 지정하는 **golden-ami**이라는 Systems Manager 파라미터를 사용합니다.
```
--image-id resolve:ssm:/golden-ami
```
Systems Manager 파라미터의 버전을 생성할 수 있습니다. 다음 예시에서는 **golden-ami** 파라미터의 버전 2를 지정합니다.
```
--image-id resolve:ssm:/golden-ami:2
```
------
#### [ PowerShell ]
**Systems Manager 파라미터를 사용하여 인스턴스를 시작하려면**
`-ImageId` 파라미터와 함께 [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) cmdlet을 사용합니다. 이 예제에서는 AMI ID를 지정하는 **golden-ami**이라는 Systems Manager 파라미터를 사용합니다.
```
-ImageId "resolve:ssm:/golden-ami"
```
Systems Manager 파라미터의 버전을 생성할 수 있습니다. 다음 예시에서는 **golden-ami** 파라미터의 버전 2를 지정합니다.
```
-ImageId "resolve:ssm:/golden-ami:2"
```
------