기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS CLI설치 및 구성
**중요**
이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 서비스 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요.
첫 번째 인스턴스를 등록하기 전에를 실행하는 컴퓨터에서 버전 1.16.180 AWS CLI 이상의를 실행해야 합니다`register`. 설치 세부 정보는 워크스테이션의 운영 체제에 따라 다릅니다. 설치에 대한 자세한 내용은 [AWS 명령줄 인터페이스 설치](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) 및 AWS 명령줄 인터페이스 구성을 AWS CLI참조하세요. [https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 실행 중인 AWS CLI 의 버전을 확인하려면 셸 세션에 `aws --version`을 입력합니다.
**참고**
[PowerShell용 AWS 도구](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-welcome.html)에는 `register` API 작업을 호출하는 [https://docs.aws.amazon.com/powershell/latest/reference/items/Register-OPSInstance.html](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-OPSInstance.html) cmdlet이 포함되어 있지만 대신 AWS CLI 를 사용하여 `register` 명령을 실행하는 것이 좋습니다.
적절한 권한으로 `register`를 실행해야 합니다. IAM 역할을 사용하여 권한을 얻을 수 있습니다. 또는 최적의 방법은 아니지만, 적절한 권한이 있는 사용자 자격 증명을 워크스테이션이나 등록할 인스턴스에 설치하여 권한을 얻을 수도 있습니다. 그런 다음 나중에 설명하는 것처럼 이러한 자격 증명을 사용하여 `register`를 실행할 수 있습니다. IAM 정책을 사용자 또는 역할에 연결하여 권한을 지정합니다. `register`의 경우, `AWSOpsWorksRegisterCLI_EC2` 또는 `AWSOpsWorksRegisterCLI_OnPremises` 정책을 사용합니다. 이러한 정책은 각각 Amazon EC2 또는 온프레미스 인스턴스를 등록할 수 있는 권한을 부여합니다.
**참고**
Amazon EC2 인스턴스에서 `register`을(를) 실행하는 경우, 원칙적으로는 IAM 역할을 사용하여 자격 증명을 제공해야 합니다. 기존 인스턴스에 IAM 역할을 연결하는 방법에 대한 내용은 [인스턴스에 IAM 역할 연결](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#attach-iam-role) 또는 *Amazon EC2 사용 설명서*의 [IAM 역할 교체](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#replace-iam-role)를 참조하세요.
`AWSOpsWorksRegisterCLI_EC2` 및 `AWSOpsWorksRegisterCLI_OnPremises` 정책의 예제 코드 조각은 [인스턴스 등록 정책](registered-instances-register-registering-template.md) 단원을 참조하세요. AWS 자격 증명 생성 및 관리에 대한 자세한 내용은 [AWS 보안 자격 증명](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)을 참조하세요.
**Topics**
+ [IAM 역할 사용](#registered-instances-register-registering-cli-role)
+ [설치된 자격 증명 사용](#registered-instances-register-registering-cli-creds)
## IAM 역할 사용
등록하려는 Amazon EC2 인스턴스에서 명령을 실행하는 경우, `register`에 자격 증명을 제공하기 위한 기본 전략은 `AWSOpsWorksRegisterCLI_EC2` 정책 또는 동등한 권한이 연결된 IAM 역할을 사용하는 것입니다. 이 방법을 사용하면 인스턴스에 자격 증명을 설치하지 않아도 됩니다. 이렇게 하는 한 가지 방법은 다음 그림과 같이 EC2 콘솔에서 **IAM 역할 연결/교체** 명령을 사용하는 것입니다.
![\[AWS EC2 console showing Instance Settings menu with Attach/Replace IAM Role option highlighted.\]](http://docs.aws.amazon.com/ko_kr/opsworks/latest/userguide/images/instance_register_attachrole.png)
기존 인스턴스에 IAM 역할을 연결하는 방법에 대한 내용은 [인스턴스에 IAM 역할 연결](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#attach-iam-role) 또는 *Amazon EC2 사용 설명서*의 [IAM 역할 교체](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#replace-iam-role)를 참조하세요. 인스턴스 프로파일(권장)로 실행한 인스턴스의 경우 `register` 명령에 `--use-instance-profile` 스위치를 추가하여 자격 증명을 추가합니다. 단, `--profile` 파라미터는 사용하지 마십시오.
인스턴스가 실행 중이고 역할을 가지고 있는 경우, `AWSOpsWorksRegisterCLI_EC2` 정책을 역할에 연결하여 필요한 권한을 부여할 수 있습니다. 이 역할은 인스턴스에 기본 자격 증명 세트를 제공합니다. 인스턴스에 자격 증명을 설치하지 않았다면 `register`가 역할을 자동으로 수행하고 권한을 실행합니다.
**중요**
인스턴스에 자격 증명을 설치하지 않는 것이 좋습니다. 보안 위험을 생성하는 것 외에도 인스턴스의 역할은가 기본 자격 증명을 찾는 데 AWS CLI 사용하는 기본 공급자 체인의 끝에 있습니다. 설치된 자격 증명이 역할보다 우선할 수 있으며 따라서 `register`가 필요한 권한을 갖지 못할 수 있습니다. 자세한 내용은 [AWS CLI시작하기](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#config-settings-and-precedence)를 참조하세요.
실행 중인 인스턴스에 역할이 없는 경우, [설치된 자격 증명 사용](#registered-instances-register-registering-cli-creds)에 설명된 것처럼 필요한 권한이 있는 자격 증명을 인스턴스에 설치해야 합니다. 인스턴스 프로파일을 사용하여 실행되는 인스턴스를 사용하는 것이 권장되는 방법으로, 더 쉽고, 오류가 적게 발생합니다.
## 설치된 자격 증명 사용
시스템에 사용자 자격 증명을 설치하고 AWS CLI 명령에 제공하는 방법에는 여러 가지가 있습니다. 아래에는 더 이상 권장되지 않는 접근 방식에 대한 설명이 나와 있지만, 인스턴스 프로파일을 사용하지 않고 실행한 EC2 인스턴스를 등록하는 경우에는 이러한 방식을 사용할 수 있습니다. 연결된 정책이 필요한 권한을 부여한다면 기존 사용자의 자격 증명을 사용할 수도 있습니다. 자격 증명을 설치하는 기타 방법에 대한 설명을 포함한 자세한 내용은 [구성 및 자격 증명 파일](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-config-files)을 참조하세요.
**설치된 자격 증명을 사용하려면**
1. [IAM 사용자를 생성](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-config-files)하고 안전한 위치에 액세스 키 ID 및 비밀 액세스 키를 저장합니다.
**주의**
IAM 사용자는 장기 자격 증명을 가지므로 보안 위험이 있습니다. 이 위험을 줄이려면 이러한 사용자에게 작업을 수행하는 데 필요한 권한만 제공하고 더 이상 필요하지 않을 경우 이러한 사용자를 제거하는 것이 좋습니다.
1. 이 사용자에게 [AWSOpsWorksRegisterCLI\$1OnPremises 정책을 연결](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingPolicies.html)합니다. `AWSOpsWorksRegisterCLI_OnPremises` 권한을 포함하고 있는 한, 원한다면 더 광범위한 권한을 부여하는 정책을 연결할 수 있습니다.
1. 시스템의 `credentials` 파일에서 사용자에 대한 프로파일을 만듭니다. 이 파일은 `~/.aws/credentials`(Linux, Unix 및 OS X) 또는 `C:\Users\User_Name\.aws\credentials`(Windows 시스템)에 있습니다. 이 파일에는 다음 형식의 프로파일이 하나 이상 포함되어 있으며 각 프로파일에는 사용자의 액세스 키 ID 및 비밀 액세스 키가 포함되어 있습니다.
```
[profile_name]
aws_access_key_id = access_key_id
aws_secret_access_key = secret_access_key
```
*이전에 저장한 IAM 자격 증명을 *access\$1key\$1id* 및 secret\$1access\$1key* 값으로 대체하세요. 프로파일 이름에 원하는 이름을 지정할 수 있지만, 이름은 고유해야 하고 기본 프로파일의 이름은 `default`여야 한다는 두 가지 제한 사항이 있습니다. 또한 필요한 권한이 포함되어 있는 한 기존 프로파일을 사용할 수도 있습니다.
1. `register` 명령의 `--profile` 파라미터를 사용하여 프로파일 이름을 지정합니다. 그러면 `register` 명령이 연결된 자격 증명에 부여된 권한으로 실행됩니다.
뿐만 아니라 `--profile`은 생략할 수도 있습니다. 이러한 경우 `register`는 기본 자격 증명으로 실행됩니다. 하지만 이러한 자격 증명이 기본 프로파일의 자격 증명이 아닐 수도 있기 때문에 기본 자격 증명에 필수 권한이 있는지 확인해야 합니다. 가 기본 자격 증명을 AWS CLI 결정하는 방법에 대한 자세한 내용은 [AWS 명령줄 인터페이스 구성을 참조하세요](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).