기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB Serverless로 마이그레이션
**Topics**
+ [기존 DocumentDB 클러스터를 서버리스로 마이그레이션](#w2aac41c19b5)
+ [MongoDB에서 DocumentDB Serverless로 마이그레이션](#w2aac41c19b7)
## 기존 DocumentDB 클러스터를 서버리스로 마이그레이션
### 클러스터의 엔진 버전 업그레이드
프로비저닝된 클러스터가 DocumentDB Serverless를 지원하지 않는 하위 엔진 버전을 실행하는 경우 먼저 지원되는 엔진 버전으로 클러스터를 업그레이드해야 합니다. 자세한 내용은 [Amazon DocumentDB 인플레이스 주요 버전 업그레이드](docdb-mvu.md) 단원을 참조하십시오.
### 프로비저닝된 클러스터를 DocumentDB Serverless로 마이그레이션
DocumentDB Serverless를 사용하도록 프로비저닝된 클러스터를 전환하려면 다음 단계를 따르세요.
1. DocumentDB Serverless와 함께 사용하기 위해 프로비저닝된 클러스터의 엔진 버전을 업그레이드해야 하는지 확인합니다. [DocumentDB Serverless 요구 사항 및 제한 사항](docdb-serverless-limitations.md)을(를) 참조하세요.
**참고**
프로비저닝된 클러스터가 DocumentDB Serverless에 사용할 수 없는 엔진 버전을 실행 중인 경우 클러스터의 엔진 버전을 업그레이드하세요. [Amazon DocumentDB 인플레이스 주요 버전 업그레이드](docdb-mvu.md)을(를) 참조하세요.
1. 클러스터에 대한 크기 조정 구성을 구성합니다. 규모 조정 구성의 선택에 대한 자세한 내용은 [DocumentDB Serverless 클러스터의 규모 조정 용량 범위 선택](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing) 섹션을 참조하세요. 클러스터의 규모 조정 구성을 수정하려면 [클러스터의 규모 조정 용량 범위 구성 보기 및 수정](docdb-serverless-managing.md#docdb-serverless-range-config) 섹션을 참조하세요.
1. [DocumentDB Serverless 요구 사항 및 제한 사항](docdb-serverless-limitations.md)의 DocumentDB Serverless 요구 사항 및 제한 사항을 고려하도록 다른 클러스터 속성을 구성합니다.
1. 클러스터에 하나 이상의 DocumentDB Serverless 인스턴스를 추가합니다. [Amazon DocumentDB Serverless 인스턴스 추가](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance)의 프로시저를 따르세요.
**참고**
경우에 따라 클러스터에 이미 하나 이상의 프로비저닝된 리더 인스턴스가 있을 수 있습니다. 그렇다면 새 인스턴스를 생성하는 대신 리더 중 하나를 DocumentDB Serverless 인스턴스로 변환할 수 있습니다. 이 작업을 수행하려면 [인스턴스의 클래스 변경](db-instance-classes.md#db-instance-class-changing)의 프로시저를 따르세요.
1. (선택 사항) 장애 조치 작업을 수행하여 DocumentDB Serverless 인스턴스를 클러스터 라이터로 만듭니다. [Amazon DocumentDB 장애 조치](failover.md)을(를) 참조하세요.
1. (선택 사항) 나머지 프로비저닝된 Amazon DocumentDB 인스턴스를 DocumentDB Serverless 인스턴스로 변환하거나([인스턴스의 클래스 변경](db-instance-classes.md#db-instance-class-changing) 참조) 클러스터에서 제거합니다([Amazon DocumentDB 인스턴스 삭제](db-instance-delete.md) 참조).
------
#### [ Using the AWS Management Console ]
다음 AWS Management Console 구성 예제는 Amazon DocumentDB 서버리스 사용을 시작하기 위해 엔진 버전 업그레이드가 필요하지 않은 Amazon DocumentDB 5.0.0을 실행하는 Amazon DocumentDB 프로비저닝 클러스터를 사용하는 마이그레이션 프로세스를 보여줍니다. 클러스터의 이름은 `sample`이고 `sample`, `sample2`, `sample3`라는 프로비저닝된 인스턴스 3개로 시작합니다. 이 예제에서는 이 세 인스턴스를 세 개의 서버리스 인스턴스로 대체합니다.
1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
**클러스터** 테이블이 표시됩니다.
1. **클러스터** 테이블에서 서버리스 인스턴스를 추가할 클러스터의 확인란을 선택합니다.
1. **작업**을 선택한 다음 **인스턴스 추가**를 선택합니다.
1. **인스턴스 추가** 대화 상자에서 생성하려는 각각의 새 서버리스 인스턴스마다 **DB 인스턴스 클래스** 섹션에서 **서버리스**를 선택합니다.
1. **서버리스 용량 설정**에서는 대화 상자의 용량 설명에 따라 규모 조정 구성을 설정합니다.
1. (선택 사항) 다른 인스턴스를 추가하려면 **인스턴스 추가**를 선택합니다. 원하는 새 인스턴스 수에 도달할 때까지 인스턴스를 계속 추가합니다.
이 예제에서는 세 개의 새 서버리스 인스턴스가 생성됩니다.
1. **생성(Create)**을 선택합니다.
인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔 또는를 사용하여 인스턴스의 상태를 AWS CLI 볼 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 상태 모니터링](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)을 참조하세요.
1. **클러스터** 테이블로 돌아가서 원래 프로비저닝된 인스턴스 세 개 모두에 대해 확인란을 선택합니다.
1. **작업**을 선택한 후 **삭제**를 선택합니다.
삭제하는 동안 장애 조치가 자동으로 수행되어 나머지 인스턴스 중 하나를 라이터로 승격합니다. 몇 분 후 삭제 프로세스가 완료됩니다. 이제 기존 클러스터에 DocumentDB Serverless 인스턴스 3개가 포함됩니다(**크기** 열에 정의됨).
------
#### [ Using the AWS CLI ]
다음 AWS CLI 구성 예제는 Amazon DocumentDB 서버리스 사용을 시작하기 위해 엔진 버전 업그레이드가 필요하지 않은 Amazon DocumentDB 5.0.0을 실행하는 Amazon DocumentDB 프로비저닝 클러스터를 사용하는 마이그레이션 프로세스를 보여줍니다. 클러스터의 이름은 `sample`이고 `sample`, `sample2`, `sample3`라는 프로비저닝된 인스턴스 3개로 시작합니다. 이 예제에서는 이 세 인스턴스를 세 개의 서버리스 인스턴스로 대체합니다. 클러스터의 이름은 `sample-cluster`이고, 라이터와 리더 인스턴스인 `sample-provisioned-instance-1`과 `sample-provisioned-instance-2`라는 두 개의 프로비저닝된 DB 인스턴스로 시작합니다.
다음은 각각의 *사용자 입력 자리 표시자*를 자신의 정보 또는 구성 파라미터로 변경하는 예제입니다.
`aws docdb describe-db-clusters` 작업을 사용하여 클러스터의 상태를 확인합니다. 다음 코드는 클러스터 `sample-cluster`의 상태를 찾고 결과를 테이블에 출력합니다.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
클러스터에 대한 규모 조정 구성을 추가합니다.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16
```
서버리스 인스턴스를 추가합니다. 이 예제에서는 `sample-serverless-instance-1` 및 `sample-serverless-instance-2`라는 새 서버리스 인스턴스를 추가합니다.
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-1 \
--db-instance-class db.serverless \
--engine docdb
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-2 \
--db-instance-class db.serverless \
--engine docdb
```
다음을 입력하여 서버리스 인스턴스를 사용할 수 있을 때까지 기다린 후 계속 진행합니다.
```
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-1
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-2
```
장애 조치 작업을 수행하여 새 `sample-serverless-instance-1` 인스턴스를 클러스터의 새 라이터로 만듭니다.
```
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-1
```
장애 조치를 완료하는 데 몇 초가 걸리며, 이후 sample-serverless-instance-1이 클러스터 라이터가 됩니다. 다음을 입력해서 이를 확인합니다.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | False | 1 |
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
마지막으로 원래 프로비저닝된 인스턴스를 삭제합니다.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-1
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-2
```
------
## MongoDB에서 DocumentDB Serverless로 마이그레이션
프로비저닝된 Amazon DocumentDB와 마찬가지로 MongoDB 데이터베이스를 DocumentDB Serverless로 마이그레이션할 수 있습니다. 자세한 내용은 [Amazon DocumentDB로 마이그레이션](docdb-migration.md) 단원을 참조하십시오.