1단계: 스택 및 인스턴스 생성 2단계: AWS CLI설치 및 구성 3단계: EC2Register 스택에 인스턴스 등록

안내: 워크스테이션에서 인스턴스 등록

중요

이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 고객과 기존 고객 모두 사용할 수 없게 되었습니다. 고객은 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션할 것을 강력히 권장합니다. 마이그레이션에 대해 궁금한 점이 있으면 AWS re:Post 또는 Premium AWS Support를 통해 AWS Support 팀에 문의하세요.

참고

이 기능은 Linux 스택에서만 지원됩니다.

등록 프로세스는 여러 시나리오를 지원합니다. 이 섹션에서는 워크스테이션을 사용하여 Amazon EC2 인스턴스를 등록하는 방법 등 한 가지 시나리오의 end-to-end 예를 안내합니다. 다른 등록 시나리오도 비슷한 절차를 사용합니다. 자세한 정보는 Amazon EC2 및 온프레미스 인스턴스 등록을 참조하세요.

참고

일반적으로는 기존 Amazon EC2 인스턴스를 등록하게 됩니다. 하지만 이 안내에서는 새 인스턴스와 새 스택을 생성한 다음 마친 후 삭제할 수도 있습니다.

1단계: 스택 및 인스턴스 생성

시작하려면 스택과 해당 스택에 등록할 Amazon EC2 인스턴스가 필요합니다.

스택 및 인스턴스를 생성하려면

AWS OpsWorks Stacks 콘솔을 사용하여 EC2Register(이)라는 이름의 새로운 스택을 생성합니다. 다른 스택 설정에 대해서는 기본값을 수락할 수 있습니다.
Amazon EC2 콘솔에서 새 인스턴스를 시작합니다. 다음을 참조하세요.
- 인스턴스는 스택과 같은 리전 및 VPC에 있어야 합니다.
  
  VPC를 사용하는 경우 이 연습에서는 퍼블릭 서브넷을 선택합니다.
- SSH 키를 생성해야 하는 경우 워크스테이션에 프라이빗 키 파일을 저장하고 파일의 이름 및 위치를 적어 둡니다.
  
  기존 키를 사용하는 경우 이름 및 프라이빗 키 파일 위치를 적어 둡니다. 이러한 값은 나중에 필요합니다.
- 인스턴스는 지원되는 Linux 운영 체제 중 하나를 기반으로 해야 합니다. 예를 들어, 스택이 미국 서부(오레곤)에 있는 경우 ami-35501205을(를) 사용하여 해당 리전에 있는 Ubuntu 14.04 LTS 인스턴스를 시작할 수 있습니다.
그렇지 않으면 기본값을 수락합니다.

인스턴스가 부팅 중일 때 다음 섹션으로 넘어갈 수 있습니다.

2단계: AWS CLI설치 및 구성

등록은 명령을 사용하여 수행됩니다. AWS CLI aws opsworks register 첫 번째 인스턴스를 등록하려면 먼저 버전 1.16.180 이상을 실행해야 합니다. AWS CLI 설치 세부 정보는 워크스테이션의 운영 체제에 따라 다릅니다. 설치에 AWS CLI대한 자세한 내용은 AWS 명령줄 인터페이스 설치를 참조하십시오. 실행 중인 AWS CLI 의 버전을 확인하려면 셸 세션에 aws --version을 입력합니다.

참고

사용자나 역할이 인스턴스를 등록하지 못하게 하려면 register 명령에 대한 액세스를 거부하도록 인스턴스 프로파일을 업데이트하세요.

워크스테이션에서 이미 실행하고 있더라도 이 단계를 건너뛰지 않는 것이 좋습니다. AWS CLI 보안 모범 사례로 AWS CLI 의 가장 최신 릴리스를 사용하는 것이 좋습니다.

적절한 권한이 있는 AWS 자격 증명 세트와 함께 register를 제공해야 합니다. 보안 인증을 인스턴스에 직접 설치하지 않도록 하기 위해 권장되는 방법은 인스턴스 프로파일로 시작된 인스턴스를 등록한 다음 register 명령에 --use-instance-profile 스위치를 추가하는 것입니다. 인스턴스 프로파일에서 자격 증명을 얻는 경우 이 주제의 3단계: EC2Register 스택에 인스턴스 등록 단원으로 건너뛰십시오. 그러나 인스턴스 프로파일로 인스턴스가 실행되지 않은 경우 IAM 사용자를 생성할 수 있습니다. 다음 절차에서는 적절한 권한이 있는 새 사용자를 생성하고 이 사용자의 자격 증명을 워크스테이션에 설치한 다음 이러한 자격 증명을 register에 전달합니다.

주의

IAM 사용자는 장기 자격 증명을 보유하므로 보안 위험이 발생할 수 있습니다. 이 위험을 줄이려면 이러한 사용자에게 작업을 수행하는 데 필요한 권한만 제공하고 더 이상 필요하지 않을 경우 이러한 사용자를 제거하는 것이 좋습니다.

사용자를 생성하려면

IAM 콘솔의 탐색 창에서 사용자를 선택한 다음, 사용자 추가를 선택합니다.
EC2Register라는 사용자를 추가합니다.
다음을 선택합니다.
권한 설정 페이지에서 직접 기존 정책 연결을 선택합니다.
권한 정책 필터 상자에 AWS OpsWorks 정책을 표시하고 다음 정책 중 하나를 선택한 후 다음: 검토를 선택합니다. OpsWorks 이 정책은 register를 실행하는 데 필요한 권한을 사용자에게 부여합니다.
- 사용자 권한이 인스턴스 프로파일을 사용하는 EC2 인스턴스를 등록하도록 허용하려면 AWSOpsWorksRegisterCLI_EC2를 선택합니다.
- 사용자 권한이 온프레미스 인스턴스를 등록하도록 허용하려면 AWSOpsWorksRegisterCLI_OnPremises를 선택합니다.
다음을 선택합니다.
검토 페이지에서 사용자 생성을 선택합니다.
사용자에 대해 액세스 키를 생성합니다. 탐색 창에서 사용자를 선택한 후 액세스 키를 생성하려는 사용자를 선택합니다.
보안 자격 증명 탭을 선택한 후 액세스 키 생성을 선택합니다.
작업에 가장 적합한 액세스 키 모범 사례 및 대안을 선택합니다.
다음을 선택합니다.
(선택 사항) 액세스 키를 식별할 태그를 입력합니다.
다음을 선택합니다.
.csv 파일 다운로드를 선택하고 시스템의 원하는 위치에 자격 증명 파일을 저장한 다음 완료를 선택합니다.

IAM 사용자의 자격 증명을 register에 제공해야 합니다. 이 안내서에서는 EC2Register 자격 증명을 워크스테이션의 credentials 파일에 설치하여 이 작업을 처리합니다. 의 자격 증명을 관리하는 다른 방법에 대한 자세한 내용은 구성 및 자격 증명 파일을 참조하십시오. AWS CLI

사용자의 자격 증명을 설치하려면

워크스테이션의 credentials 파일을 생성하거나 엽니다. 이 파일은 ~/.aws/credentials(Linux, Unix 및 OS X) 또는 C:\Users\User_Name\.aws\credentials(Windows 시스템)에 있습니다.
credentials 파일에 EC2Register 사용자에 대한 프로파일을 다음과 같은 형식으로 추가합니다.
```
[ec2register]
aws_access_key_id = access_key_id
aws_secret_access_key = secret_access_key
```
앞서 다운로드한 EC2Register 키로 access_key_id 및 secret_access_key를 바꿉니다.

3단계: EC2Register 스택에 인스턴스 등록

이제 인스턴스를 등록할 준비가 되었습니다.

인스턴스를 등록하려면

AWS OpsWorks 스택에서 EC2Register 스택으로 돌아가 탐색 창에서 [Instances] 를 선택한 다음 [인스턴스 등록] 을 선택합니다.
EC2 인스턴스를 선택하고, 다음: 인스턴스 선택을 클릭한 다음 목록에서 인스턴스를 선택합니다.
[다음: AWS CLI 설치] 를 선택하고 [다음: 인스턴스 등록] 을 선택합니다. AWS OpsWorks 스택은 스택 ID 및 인스턴스 ID와 같은 사용 가능한 정보를 자동으로 사용하여 register 명령 템플릿을 생성하며, 이 템플릿은 인스턴스 등록 페이지에 표시됩니다. 이 예제에서는 register가 SSH 키를 사용하여 인스턴스에 로그인하도록 하고 키 파일을 명시적으로 지정할 것이기 때문에 SSH 키를 사용하여 인스턴스에 연결을 예로 설정합니다. 이 명령 템플릿은 다음과 유사합니다.
```
aws opsworks register --infrastructure-class ec2 --region region endpoint ID
  --stack-id 247be7ea-3551-4177-9524-1ff804f453e3 --ssh-username [username]
  --ssh-private-key [key-file] i-f1245d10 
```
참고
AWS OpsWorks 스택이 지역 엔드포인트와 연결된 클래식 지역 내에 있는 경우 스택의 지역이 아닌 스택 서비스의 엔드포인트 지역으로 지역을 설정해야 합니다. us-east-1 AWS OpsWorks 스택은 스택 ID를 기반으로 스택의 지역을 결정합니다.
명령 템플릿에는 사용자 지정 인수 값이 여러 개 포함되어 있는데, 이러한 인수 값은 대괄호로 표시되며 적절한 값으로 바꿔야 합니다. 명령 템플릿을 텍스트 편집기에 복사하고 다음과 같이 편집합니다.

중요
등록 프로세스 중에 생성되는 IAM 사용자는 등록된 인스턴스의 수명이 끝날 때까지 필요합니다. 사용자를 삭제하면 AWS OpsWorks Stacks 에이전트가 서비스와 통신할 수 없게 됩니다. 사용자가 우연히 삭제될 경우 발생하는 등록된 인스턴스 관리 문제를 예방하려면 register 명령에 --use-instance-profile 파라미터를 추가하여 인스턴스의 내장 인스턴스 프로파일을 대신 사용합니다. 또한 --use-instance-profile 파라미터를 추가하면 AWS OpsWorks 에이전트가 사용할 수 있는 액세스 키와 필수 IAM 사용자 간의 불일치를 방지할 수 있으므로 90일마다 AWS 계정 액세스 키를 교체할 때 오류가 발생하는 것을 방지할 수 있습니다 (권장되는 모범 사례).
- 키 파일은 인스턴스를 생성할 때 저장한 Amazon EC2 키 페어의 프라이빗 키 파일에 대한 정규화된 경로로 바꿉니다.
  
  원한다면 상대 경로를 사용해도 됩니다.
- username을 인스턴스의 사용자 이름으로 바꿉니다.
  
  이 예제에서 사용자 이름은 Ubuntu 인스턴스의 경우 ubuntu이고, Red Hat Enterprise Linux(RHEL) 또는 Amazon Linux 인스턴스의 경우 ec2-user입니다.
- 키 교체 중 또는 주요 IAM 사용자를 실수로 삭제한 경우 오류를 방지하기 위해 인스턴스 프로파일로 register을(를) 실행하는 --use-instance-profile을(를) 추가합니다.
명령은 다음과 유사합니다.
```
aws opsworks register --use-instance-profile --infrastructure-class ec2 \
  --region us-west-2  --stack-id 247be7ea-3551-4177-9524-1ff804f453e3 --ssh-username ubuntu \
  --ssh-private-key "./keys/mykeys.pem" i-f1245d10
```
워크스테이션에서 터미널 창을 열고 편집기에서 register 명령을 붙여 넣은 다음 명령을 실행합니다.

등록에는 일반적으로 약 5분 가량 걸립니다. 작업이 완료되면 AWS OpsWorks Stacks 콘솔로 돌아가서 [Done] 을 선택합니다. 탐색 창에서 인스턴스를 선택합니다. 인스턴스가 [미할당 인스턴스]에 표시되어야 합니다. 그런 다음 계획한 인스턴스 관리 방법에 따라 해당 인스턴스를 계층에 할당하거나 그대로 둘 수 있습니다.
작업을 마치면 인스턴스를 중지한 다음 AWS OpsWorks Stacks 콘솔 또는 명령을 사용하여 인스턴스를 삭제합니다. 그러면 Amazon EC2 인스턴스가 종료되어 더 이상 요금이 발생하지 않습니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

스택 스택에 인스턴스 AWS OpsWorks 등록

Amazon EC2 및 온프레미스 인스턴스 등록