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

# `register` 명령 사용
<a name="registered-instances-register-registering-command"></a>

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

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

인스턴스를 등록하려면 최소한 버전 1.16.180 이상의 AWS CLI를 실행하고 있어야 합니다. 다음은 `register` 명령의 일반적 구문을 보여 줍니다.

```
aws opsworks register \
  [--profile profile_name] \
  [--region region_name] \
  --infrastructure-class instance_type \
  --stack-id stack ID \
  [--local] | [--ssh-private-key key_file --ssh-username username] | [--override-ssh command_string] \
  [--override-hostname hostname] \
  [--debug] \
  [--override-public-ip public IP] \
  [--override-private-ip private IP] \
..[--use-instance-profile] \
  [ [IP address] | [hostname] | [instance ID]
```

다음 인수는 모든 AWS CLI 명령에 공통적입니다.

**`--profile`**  
(선택 사항) 자격 증명의 프로파일 이름. 이 인수를 생략하면 명령이 기본 자격 증명으로 실행됩니다. 가 기본 자격 증명을 AWS CLI 결정하는 방법에 대한 자세한 내용은 [AWS 명령줄 인터페이스 구성을 참조하세요](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

**`--region`**  
 (선택 사항) OpsWorks Stacks 서비스 엔드포인트의 리전입니다. 스택의 리전`--region`으로 설정하지 마십시오. OpsWorks 스택은 스택 ID에서 스택의 리전을 자동으로 결정합니다.  
기본 리전이 이미 설정되어 있다면 이 인수를 생략해도 됩니다. 기본 리전을 지정하는 방법에 대한 자세한 내용은 [AWS 명령줄 인터페이스 구성](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)을 참조하세요.

Amazon EC2 인스턴스와 온프레미스 인스턴스에 다음 인수를 사용하세요.

**`--infrastructure-class`**  
(필수) 이 파라미터는 Amazon EC2 인스턴스를 등록하는지 또는 온프레미스 인스턴스를 등록하는지 표시하기 위해 각각 `ec2` 또는 `on-premises`(으)로 설정해야 합니다.

**`--stack-id`**  
(필수) 인스턴스를 등록할 스택의 ID.  
스택 ID를 찾으려면 **스택** 페이지에서 **설정**을 클릭합니다. 스택 ID는 [**OpsWorks ID**]로 레이블이 지정되어 있으며, `ad21bce6-7623-47f1-bf9d-af2affad8907`와 비슷한 GUID입니다.

**SSH 로그인 인수**  
다음 인수를 사용하여 `register`가 인스턴스에 어떻게 로그인할지 지정합니다.    
**`--local`**  
(선택 사항) 명령을 실행하는 인스턴스를 등록하는 데 이 인수를 사용합니다.  
이 경우, `register`가 인스턴스에 로그인할 필요가 없습니다.  
**`--ssh-private-key` 및 `--ssh-username`**  
 (선택 사항) 별도의 워크스테이션에서 인스턴스를 등록하고 사용자 이름 또는 프라이빗 키 파일을 명시적으로 지정하려는 경우, 이 인수를 사용합니다.  
+ `--ssh-username` – SSH 사용자 이름을 지정하려면 이 인수를 사용합니다.

  `--ssh-username`를 생략하는 경우, `ssh`는 기본 사용자 이름을 사용합니다.
+ `--ssh-private-key` – 프라이빗 키 파일을 명시적으로 지정하려면 이 인수를 사용합니다.

  `--ssh-private-key`를 생략하는 경우, `ssh`는 기본 프라이빗 키 사용 등 암호가 필요 없는 인증 기법을 사용하여 로그인을 시도합니다. 이러한 기법이 모두 지원되지 않는 경우, `ssh`가 암호를 쿼리합니다. `ssh`가 인증을 처리하는 방법에 대한 자세한 정보는 [Secure Shell(SSH) 인증 프로토콜](https://www.ietf.org/rfc/rfc4252.txt) 단원을 참조하세요.  
**`--override-ssh`**  
 (선택 사항) 별도의 워크스테이션에서 인스턴스를 등록하고 [http://linux.about.com/od/commands/l/blcmdl1_ssh.htm](http://linux.about.com/od/commands/l/blcmdl1_ssh.htm) 명령 문자열을 지정하려는 경우, 이 인수를 사용합니다. `register` 명령은 이 명령 문자열을 사용하여 등록된 인스턴스에 로그인합니다.
`ssh`에 대한 자세한 정보는 [SSH](http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man1/slogin.1)를 참조하세요.

**`--override-hostname`**  
 (선택 사항) OpsWorks Stacks에서만 사용하는 인스턴스의 호스트 이름을 지정합니다. 기본값은 인스턴스의 호스트 이름입니다.

**`--debug`**  
(선택 사항) 등록 프로세스가 실패하는 경우, 디버깅 정보를 제공합니다. 문제 해결 정보는 [인스턴스 등록 문제 해결](common-issues.md#common-issues-instance-registration)를 참조하세요.

**`--use-instance-profile`**  
선택 사항이지만 Amazon EC2 인스턴스에 대해 매우 권장되는 옵션입니다. `register` 명령은 IAM 사용자를 생성하는 대신 연결된 인스턴스 프로파일을 사용합니다. 이 파라미터를 추가하면 IAM 사용자가 우연히 삭제되었을 때 등록된 인스턴스를 관리하려 시도하는 경우에 발생하는 오류를 예방하는 데 도움이 됩니다.  
등록 프로세스 중에 생성되는 IAM 사용자는 등록된 인스턴스의 수명이 끝날 때까지 필요합니다. 사용자를 삭제하면 OpsWorks Stacks 에이전트가 서비스와 통신할 수 없게 됩니다. 사용자가 우연히 삭제될 경우 발생하는 등록된 인스턴스 관리 문제를 예방하려면 `register` 명령에 `--use-instance-profile` 파라미터를 추가하여 인스턴스의 내장 인스턴스 프로파일을 대신 사용합니다. 또한 `--use-instance-profile` 파라미터를 추가하면 OpsWorks 90일마다 AWS 계정 액세스 키를 교체할 때 오류가 발생하는 것을 방지할 수 있습니다(권장 모범 사례). 에이전트가 사용할 수 있는 액세스 키와 필요한 사용자 간의 불일치를 방지하기 때문입니다.

**대상**  
(조건부) 이 명령을 워크스테이션에서 실행하는 경우, 명령 문자열의 최종 값은 다음 방법 중 하나로 등록 대상을 지정합니다.  
+ 인스턴스의 퍼블릭 IP 주소.
+ 인스턴스의 호스트 이름.
+ Amazon EC2 인스턴스의 경우, 인스턴스 ID입니다.

  OpsWorks Stacks는 인스턴스 ID를 사용하여 인스턴스의 퍼블릭 IP 주소를 포함한 인스턴스 구성을 가져옵니다. 기본적으로 OpsWorks Stacks는이 주소를 사용하여 인스턴스에 로그인하는 데 사용하는 `ssh` 명령 문자열을 구성합니다. 프라이빗 IP 주소에 연결해야 하는 경우, `--override-ssh`를 사용하여 사용자 지정 명령 문자열을 제공해야 합니다. 예제는 [워크스테이션에서 온프레미스 인스턴스 등록](registered-instances-register-registering-examples.md#registered-instances-register-registering-examples-workstation-onprem) 섹션을 참조하세요.
호스트 이름을 지정하면 `ssh`는 DNS 서버에 의존하여 이름을 특정 인스턴스로 확인합니다. 호스트 이름이 고유한지 확실하지 않으면 `ssh`를 사용하여 호스트 이름이 올바른 인스턴스로 확인되는지 확인합니다.
등록할 인스턴스에서 이 명령을 실행하는 경우, 인스턴스 ID를 생략하고 대신 `--local` 인수를 사용하세요.

다음 인수는 온프레미스 인스턴스에만 사용합니다.

**`--override-public-ip`**  
(선택 사항) OpsWorks Stacks는 지정된 주소를 인스턴스의 퍼블릭 IP 주소로 표시합니다. 인스턴스의 퍼블릭 IP 주소는 변경하지 않습니다. 그러나 사용자가 인스턴스 페이지에서 주소를 선택하는 등 콘솔을 사용하여 **인스턴스**에 연결하는 경우 OpsWorks Stacks는 지정된 주소를 사용합니다. OpsWorks Stacks는 인수의 기본값을 자동으로 결정합니다.

**`--override-private-ip`**  
(선택 사항) OpsWorks Stacks는 지정된 주소를 인스턴스의 프라이빗 IP 주소로 표시합니다. 인스턴스의 프라이빗 IP 주소는 변경되지 않습니다. OpsWorks Stacks는 인수의 기본값을 자동으로 결정합니다.