

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 인스턴스 등록
<a name="registered-instances-register-registering-register"></a>

**중요**  
이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 서비스 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요.

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

워크스테이션 또는 인스턴스에서 명령을 실행 AWS CLI `register`하여 인스턴스를 등록합니다. 이 작업을 처리하는 가장 간단한 방법은 명령 문자열 생성 프로세스를 단순화하는 [OpsWorks Stacks 콘솔](https://console.aws.amazon.com/opsworks/)의 등록 마법사를 사용하는 것입니다. 등록 절차에 익숙해진 후에는 원한다면 마법사를 건너뛰고 `register` 명령을 실행할 수 있습니다.

다음은 등록 마법사를 사용하여 인스턴스를 기존 스택에 등록하는 방법을 설명합니다.

**참고**  
새 스택에 인스턴스를 등록하려면 OpsWorks Stacks 대시보드에서 **인스턴스 등록을** 선택하면 됩니다. 이렇게 하면 새 스택을 구성하는 추가 페이지만 제외하고 기존 스택의 마법사와 동일한 마법사가 시작됩니다.

**등록 마법사를 사용하여 인스턴스를 등록하려면**

1. [OpsWorks Stacks 콘솔](https://console.aws.amazon.com/opsworks/)에서 스택을 생성하거나 기존 스택을 엽니다.

1. 탐색 창에서 [**인스턴스**]를 선택한 다음 [**인스턴스 등록**]을 선택합니다.

1. **인스턴스 유형 추가** 페이지에서 Amazon EC2 또는 온프레미스 인스턴스를 등록할지 여부를 지정합니다.
   + Amazon EC2 인스턴스를 등록 중인 경우 **다음: 인스턴스 선택**을 선택합니다.
   + 온프레미스 인스턴스를 등록 중인 경우 **다음: AWS CLI 설치**를 선택한 다음 5단계로 진행합니다.

1. Amazon EC2 인스턴스를 등록하는 경우 **인스턴스 선택** 페이지를 열어 등록할 인스턴스를 선택합니다. OpsWorks Stacks는 명령을 빌드하는 데 필요한 정보를 수집합니다. 완료되면 **다음: AWS CLI 설치**를 선택합니다.

1. 실행하려는 인스턴스는 버전 1.16.180 AWS CLI 이상의를 실행해야 `register` 합니다. AWS CLI를 설치하거나 업데이트할 수 있도록 등록 마법사 페이지에서는 설치 및 구성 지침에 대한 링크를 제공합니다. AWS CLI 설치를 확인한 후, 등록할 인스턴스 또는 개별 워크스테이션에서 명령을 실행 중인지 여부를 선택한 다음, **다음: 인스턴스 등록**을 선택합니다.

1. [**인스턴스 등록**] 페이지에는 선택한 옵션을 포함한 `register` 명령 문자열에 대한 템플릿이 표시됩니다. 예를 들어, 별도의 워크스테이션에서 Amazon EC2 인스턴스를 등록하면 기본 템플릿은 다음과 유사합니다.

   ```
   aws opsworks register --infrastructure-class ec2 --region us-west-2
     --stack-id 247be7ea-3551-4177-9524-1ff804f453e3 --ssh-username [username] i-f1245d10
   ```
**중요**  
등록 프로세스 중에 생성되는 IAM 사용자는 등록된 인스턴스의 수명이 끝날 때까지 필요합니다. 사용자를 삭제하면 OpsWorks Stacks 에이전트가 서비스와 통신할 수 없게 됩니다. 사용자가 우연히 삭제될 경우 발생하는 등록된 인스턴스 관리 문제를 예방하려면 `register` 명령에 `--use-instance-profile` 파라미터를 추가하여 인스턴스의 내장 인스턴스 프로파일을 대신 사용합니다. 또한 `--use-instance-profile` 파라미터를 추가하면 에이전트가 사용할 수 있는 액세스 키와 필요한 IAM 사용자 간의 불일치를 방지하기 때문에 90일마다 AWS 계정 액세스 키를 교체할 때 오류가 발생하는 것을 방지할 수 OpsWorks 있습니다(권장하는 모범 사례).

   **SSH 키 사용을** **예로** 설정하면 OpsWorks Stacks는 프라이빗 SSH 키 파일을 지정하는 데 사용할 수 있는 `--ssh-private-key` 인수를 문자열에 추가합니다.
**참고**  
비밀번호로 `register`이(가) 로그온하도록 하려면 **SSH 키 사용**을 **아니요**로 설정하세요. `register`을(를) 실행하면 암호를 입력하라는 메시지가 표시됩니다.

   이 문자열을 텍스트 편집기에 복사하고 필요에 따라 편집합니다. 다음을 참조하세요.
   + 대괄호로 묶인 텍스트는 입력해야 하는 정보(예: SSH 키 파일의 위치)를 나타냅니다.
   + 이 템플릿에서는 기본 AWS 자격 증명을 사용하여 `register`를 실행 중이라고 가정합니다. 그렇지 않은 경우 명령 문자열에 `--profile` 인수를 추가하고 사용하려는 자격 증명 프로파일 이름을 지정합니다.

   다른 시나리오의 경우 명령을 좀 더 변경해야 할 수 있습니다. 사용 가능한 `register` 인수와 명령 문자열을 구성하는 대체 방법에 대한 설명은 [`register` 명령 사용](registered-instances-register-registering-command.md) 단원을 참조하세요. 또한 명령줄에서 `aws opsworks help register`를 실행하여 명령의 문서를 표시할 수도 있습니다. 몇 가지 예제 명령 문자열은 [예제 register 명령](registered-instances-register-registering-examples.md) 단원을 참조하세요.

1. 명령 문자열 편집을 마치면 워크스테이션에서 터미널 창을 열거나 SSH를 사용하여 인스턴스에 로그온하고 명령을 실행합니다. 전체 작업에는 일반적으로 약 5분 가량이 소요되며 그 동안 인스턴스의 상태는 [**등록 중**]입니다.

1. 작업이 완료되면 [**완료**]를 선택합니다. 이제 인스턴스는 [**등록됨**] 상태이고 스택의 [**인스턴스**] 페이지에 할당되지 않은 인스턴스로 나열됩니다.

`register` 명령은 다음 작업을 수행합니다.

1. `register`가 워크스테이션에서 실행 중인 경우, 이 명령은 먼저 SSH를 사용하여 등록할 인스턴스에 로그인합니다.

   나머지 프로세스는 인스턴스에서 이루어지며, 명령을 어디서 실행하는가에 상관없이 동일합니다.

1. Amazon S3에서 OpsWorks Stacks 에이전트 패키지를 다운로드합니다.

1. 에이전트와 [AWS SDK for Ruby](https://aws.amazon.com/documentation/sdk-for-ruby/) 같은 에이전트의 종속성을 압축 해제하고 설치합니다.

1. 다음을 생성합니다.
   + 에이전트를 OpsWorks Stacks 서비스로 부트스트랩하여 보안 통신을 제공하는 IAM 사용자입니다.

     이 사용자의 권한은 `opsworks:RegisterInstance` 작업만을 허용하며, 15분 후 만료됩니다.
   + 등록된 인스턴스의 사용자가 포함된 스택의 IAM 그룹.

1. RSA 키 페어를 생성하고 퍼블릭 키를 OpsWorks Stacks로 보냅니다.

   이 키 페어는 에이전트와 OpsWorks Stacks 간 통신을 암호화하는 데 사용됩니다.

1. 인스턴스를 OpsWorks Stacks에 등록합니다. 그러면 스택이 초기 설정 레시피 세트를 실행하여 다음과 같이 인스턴스를 구성합니다.
   + 인스턴스의 호스트 파일 덮어쓰기.

     인스턴스를 등록하면 SSH 로그인 권한을 제어하기 위해 자체 호스트 파일이 있어야 하는 OpsWorks Stacks에 사용자 관리를 인계한 것입니다.
   + Amazon EC2 인스턴스의 경우, 연결된 Amazon EBS 볼륨 또는 탄력적 IP 주소를 스택에 등록하는 것 역시 초기 설정에 포함됩니다.

     Amazon EBS 볼륨이 `/var/www`을(를) 비롯한 예약된 탑재 지점과 인스턴스의 계층에 의해 예약된 탑재 지점에 탑재되지 않아야 합니다. 스택 리소스 관리에 대한 자세한 정보는 [리소스 관리](resources.md) 단원을 참조하세요. 계층 탑재 지점에 대한 자세한 정보는 [OpsWorks Stacks 계층 참조](layers.md) 단원을 참조하세요.

   초기 설정 구성 변경에 대한 전체 설명은 [초기 설정 구성 변경](registered-instances-lifecycle.md#registered-instances-lifecycle-setup-config) 단원을 참조하세요.
**참고**  
초기 설정은 등록된 인스턴스의 운영 체제를 업데이트하지 않으므로 이 작업은 직접 처리해야 합니다. 자세한 내용은 [보안 업데이트 관리](workingsecurity-updates.md) 단원을 참조하십시오.