

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

# AWS DataSync 에이전트 활성화
<a name="activate-agent"></a>

 AWS DataSync 에이전트 생성을 완료하려면 에이전트를 활성화해야 합니다. 이 단계에서는 에이전트를와 연결합니다 AWS 계정.

**참고**  
한 AWS 계정 AWS 리전 번에 둘 이상에서 에이전트를 활성화할 수 없습니다.

## 사전 조건
<a name="activate-agent-prerequisites"></a>

DataSync 에이전트를 활성화하려면 다음 정보가 있어야 합니다.
+ 에이전트를 활성화하는 [DataSync 서비스 엔드포인트](choose-service-endpoint.md)입니다.

  VPC 서비스 엔드포인트를 사용하는 경우 다음 세부 정보가 필요합니다.
  + VPC 서비스 엔드포인트 ID입니다.
  + VPC 서비스 엔드포인트가 위치한 서브넷입니다.
  + DataSync [VPC 서비스 엔드포인트](datasync-network.md#using-vpc-endpoint)를 사용하는 데 필요한 트래픽을 허용하는 보안 그룹입니다.
+ 에이전트의 IP 주소 또는 도메인 이름입니다.

  이를 찾는 방법은 [배포](deploy-agents.md)하는 에이전트 유형에 따라 다릅니다. 예를 들어 에이전트가 Amazon EC2 인스턴스인 경우, Amazon EC2 콘솔의 인스턴스 페이지로 이동하여 해당 IP 주소를 찾을 수 있습니다.

**참고**  
FIPS VPC 엔드포인트의 경우 AWS CLI 또는 DataSync API를 사용합니다.

## 활성화 키 가져오기
<a name="get-activation-key"></a>

배포된 DataSync 에이전트에 대한 활성화 키를 얻는 몇 가지 방법이 있습니다. 일부 옵션은 포트 80(HTTP)에서 에이전트에 대한 액세스가 필요합니다. 이러한 옵션 중 하나를 사용하는 경우 에이전트를 활성화하면 DataSync가 포트를 닫습니다.

**참고**  
에이전트 활성화 키는 사용하지 않으면 30분 후에 만료됩니다.

------
#### [ DataSync console ]

[DataSync 콘솔에서 에이전트를 활성화](#activate-agent-how-to)할 때 DataSync는 **에이전트에서 활성화 키 자동 가져오기** 옵션을 사용하여 활성화 키를 가져올 수 있습니다.

이 옵션을 사용하려면 브라우저가 포트 80에서 에이전트에 연결할 수 있어야 합니다.

------
#### [ Agent local console ]

활성화 키를 가져오는 다른 옵션과 달리 이 옵션은 포트 80에서 에이전트에 액세스할 필요가 없습니다.

1. 에이전트 가상 머신(VM) 또는 Amazon EC2 인스턴스의 [로컬 콘솔](local-console-vm.md#local-console-login)에 로그인합니다.

1. **AWS DataSync 활성화 - 구성** 기본 메뉴에서 **0**를 입력하여 활성화 키를 가져옵니다.

1. 에이전트를 활성화 AWS 리전 하려는를 입력합니다.

1. 에이전트가 사용하는 서비스 엔드포인트 유형을 입력합니다.

1. 표시되는 활성화 키를 복사합니다.

   예: `F0EFT-7FPPR-GG7MC-3I9R3-27DOH`

   [에이전트를 활성화](#activate-agent-how-to)할 때 이 키를 지정합니다.

------
#### [ CLI ]

표준 Unix 도구를 사용하면 에이전트의 IP 주소에 대한 `curl` 요청을 실행하여 활성화 키를 가져올 수 있습니다.

이 옵션을 사용하려면 클라이언트가 포트 80에서 에이전트에 연결할 수 있어야 합니다. 다음 명령을 실행하여 확인할 수 있습니다.

```
nc -vz agent-ip-address 80
```

에이전트에 연결할 수 있음을 확인한 후 사용 중인 서비스 엔드포인트 유형에 따라 다음 명령 중 하나를 실행합니다.
+ **퍼블릭 서비스 엔드포인트**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&no_redirect"
  ```
+ **FIPS 서비스 엔드포인트**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&endpointType=FIPS&no_redirect"
  ```
+ **VPC 서비스 엔드포인트**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&privateLinkEndpoint=vpc-endpoint-ip-address&endpointType=PRIVATE_LINK&no_redirect"
  ```
+ **FIPS VPC 서비스 엔드포인트**:

  ```
  curl "http://agent-ip-address/?gatewayType=SYNC&activationRegion=your-region&privateLinkEndpoint=vpc-endpoint-ip-address&endpointType=FIPS_PRIVATE_LINK&no_redirect"
  ```

**참고**  
`vpc-endpoint-ip-address`를 찾으려면 [Amazon VPC 콘솔](https://console.aws.amazon.com/vpc/)을 열고 **엔드포인트**를 선택한 다음 DataSync VPC 서비스 엔드포인트를 선택합니다. **서브넷** 탭에서 [VPC 서비스 엔드포인트의 서브넷](choose-service-endpoint.md#datasync-in-vpc)의 IP 주소를 찾습니다. 이는 엔드포인트의 IP 주소입니다.

이 명령은 활성화 키를 반환합니다. 예제:

`F0EFT-7FPPR-GG7MC-3I9R3-27DOH`

[에이전트를 활성화](#activate-agent-how-to)할 때 이 키를 지정합니다.

------

## 에이전트 활성화
<a name="activate-agent-how-to"></a>

DataSync 에이전트를 활성화하는 몇 가지 옵션이 있습니다. 활성화되면 AWS 에서 [에이전트를 관리](managing-agent.md)합니다.

------
#### [ DataSync console ]

1. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) AWS DataSync 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **에이전트**를 선택한 다음, **에에이전트 생성**을 선택합니다.

1. **서비스 엔드포인트** 섹션에서 다음을 수행하여 에이전트의 서비스 엔드포인트를 지정합니다.
   + 퍼블릭 서비스 엔드포인트의 경우 ***현재 AWS 리전*에서 퍼블릭 서비스 엔드포인트**를 선택합니다.
   + FIPS 서비스 엔드포인트의 경우 ***현재 AWS 리전*에서 FIPS 서비스 엔드포인트**를 선택합니다.
   + VPC 서비스 엔드포인트의 경우 다음을 수행합니다.
     + ** AWS PrivateLink를 사용하여 VPC 엔드포인트**를 선택합니다.
     + **VPC 엔드포인트**에서 에이전트가 사용할 VPC 서비스 엔드포인트를 선택합니다.
     + **서브넷**에서 VPC 서비스 엔드포인트가 있는 서브넷을 선택합니다.
     + **보안 그룹**에서 DataSync [VPC 서비스 엔드포인트](datasync-network.md#using-vpc-endpoint)를 사용하는 데 필요한 트래픽을 허용하는 보안 그룹을 선택합니다.

1. **활성화 키** 섹션에서 다음 중 하나를 수행하여 에이전트의 활성화 키를 지정합니다.
   + **에이전트에서 DataSync용 활성화 키 자동 가져오기**를 선택하여 키를 가져옵니다.
     + **에이전트 주소**에서 에이전트의 IP 주소 또는 도메인 이름을 입력합니다.
     + **Get key**를 선택합니다.

       활성화에 실패하면 사용 중인 서비스 엔드포인트 유형에 따라 [네트워크 구성을 확인](datasync-network.md)합니다.
   + 브라우저와 에이전트를 연결하지 않으려면 **에이전트 활성화 키 수동 입력**을 선택합니다.
     +  에이전트 로컬 콘솔에서 또는 `curl` 명령을 사용하여 [키를 가져옵니다](#get-activation-key).
     + DataSync 콘솔로 돌아가서 **활성화 키** 필드에 키를 입력합니다.

1. (권장) **에이전트 이름**에서 에이전트에 기억할 수 있는 이름을 지정합니다.

1. (선택 사항) **태그에는** 에이전트을 태그할 **키** 및 **값** 필드에 값을 입력합니다.

   태그는 AWS 리소스 관리, 필터링 및 검색에 도움이 됩니다.

1. **Create agent(에이전트 생성)**을 선택합니다.

1. **에이전트** 페이지에서 사용 중인 서비스 엔드포인트 유형이 올바른지 확인합니다.
**참고**  
이 시점에서는 에이전트가 오프라인 상태임을 알 수 있습니다. 이 문제는 에이전트를 활성화한 후 잠시 후에 발생합니다.

------
#### [ AWS CLI ]

1. [활성화 키를 가져오면](#get-activation-key) 사용 중인 서비스 엔드포인트 유형에 따라 다음 `create-agent` 명령 중 하나를 복사합니다.
   + **퍼블릭 또는 FIPS 서비스 엔드포인트**:

     ```
     aws datasync create-agent \
       --activation-key activation-key \
       --agent-name name-for-agent
     ```
   + **VPC 또는 FIPS VPC 서비스 엔드포인트**:

     ```
     aws datasync create-agent \
       --activation-key activation-key \
       --agent-name name-for-agent \
       --vpc-endpoint-id vpc-endpoint-id \
       --subnet-arns subnet-arn \
       --security-group-arns security-group-arn
     ```

1. `--activation-key`에서 [에이전트 활성화 키](#get-activation-key)를 지정합니다.

1. (권장) `--agent-name`에서 기억할 수 있는 에이전트의 이름을 지정합니다.

1. VPC 서비스 엔드포인트를 사용하는 경우 다음 옵션을 지정합니다.
   + `--vpc-endpoint-id`에서 사용 중인 VPC 서비스 엔드포인트의 ID를지정합니다.
   + `--subnet-arns`에서 VPC 서비스 엔드포인트가 위치한 서브넷의 ARN을 지정합니다.
   + `--security-group-arns`에서 DataSync [VPC 서비스 엔드포인트](datasync-network.md#using-vpc-endpoint)를 사용하는 데 필요한 트래픽을 허용하는 보안 그룹의 ARN을 지정합니다.

1. `create-agent` 명령을 실행합니다.

   방금 활성화한 에이전트의 ARN에 대한 응답을 받습니다. 예제:

   ```
   {
       "AgentArn": "arn:aws:datasync:us-east-1:111222333444:agent/agent-0b0addbeef44baca3"
   }
   ```

1. `list-agents` 명령을 실행하여 에이전트가 활성화되었는지 확인합니다.

   ```
   aws datasync list-agents
   ```
**참고**  
이 시점에서는 에이전트 `Status`가 `OFFLINE` 상태임을 알 수 있습니다. 이 문제는 에이전트를 활성화한 후 잠시 후에 발생합니다.

------
#### [ DataSync API ]

[활성화 키를 가져오면](#get-activation-key) [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html) 작업을 사용하여 에이전트를 활성화합니다.

**참고**  
완료되면 에이전트가 오프라인 상태일 수 있습니다. 이 문제는 에이전트를 활성화한 후 잠시 후에 발생합니다.

------

## 다음 단계
<a name="activate-agent-next-steps"></a>
+ 스토리지 시스템 및 DataSync 서비스에 대한 [에이전트의 연결을 확인](test-agent-connections.md)합니다.
+ 에이전트를 활성화하는 데 문제가 발생하면 [문제 해결](troubleshooting-datasync-agents.md) 도움을 받으세요.
+ 에이전트와 함께 사용할 DataSync 위치를 생성합니다. [온프레미스](transferring-on-premises-storage.md) 또는 [기타 클라우드](transferring-other-cloud-storage.md) 위치일 수 있습니다.