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

# Toolkit에서 Amazon DocumentDB 작업
<a name="docdb-overview"></a>

Amazon DocumentDB(MongoDB 호환)는 클라우드에서 MongoDB와 호환되는 데이터베이스를 설정, 운영 및 조정을 간소화하는 빠르고 믿을 만한 관리형 데이터베이스 서비스입니다.

Amazon DocumentDB, 시작 정보 및 튜토리얼에 대한 자세한 내용은 [Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/what-is.html) 개발자 안내서를 참조하세요.

다음 섹션에서는 AWS Toolkit for Visual Studio Code을 사용해 Amazon DocumentDB 작업을 수행하는 방법을 설명합니다.

## AWS 도구 키트에서 Amazon DocumentDB에 액세스
<a name="docdb-overview-access"></a>

 AWS 도구 키트를 사용하여 Amazon DocumentDB에 액세스하려면 다음 절차를 완료하세요.

**AWS 도구 키트에서 Amazon DocumentDB 액세스**

1. VS Code에서를 엽니다 AWS Toolkit for Visual Studio Code.

1.  AWS 도구 키트에서 **탐색**기를 확장합니다.

1. **Explorer**에서 Amazon DocumentDB를 확장하여 기존 Amazon DocumentDB 리소스를 표시합니다.

## 인스턴스 기반 클러스터 생성.
<a name="docdb-overview-create-cluster"></a>

Amazon DocumentDB 작업을 시작하려면, 다음 절차를 완료해 클러스터를 생성합니다.

**인스턴스 기반 클러스터 생성**

1. 에서 Amazon DocumentDB의 컨텍스트 메뉴(마우스 오른쪽 버튼 클릭)를 AWS Toolkit for Visual Studio Code연 다음 **클러스터 생성을** 선택하여 VS Code에서 ** Amazon DocumentDB 클러스터 생성** 대화 상자를 엽니다.

1. **클러스터 유형** 화면에서 **인스턴스 기반 클러스터**를 선택합니다.

1. **클러스터 이름** 화면에서 새 클러스터의 이름을 입력합니다.

1. **엔진 버전 선택** 화면에서 원하는 Amazon DocumentDB 엔진 버전을 선택합니다.

1. **관리자 계정 이름 및 암호** 화면에서 관리자 계정 이름과 암호를 지정해 클러스터를 보호합니다.

1. **스토리지 암호화 지정** 화면에서 클러스터 암호화 여부를 선택합니다.

1. **인스턴스 수** 화면에서 원하는 인스턴스 수를 구성합니다.

1. **인스턴스 클래스 선택** 화면에서 원하는 인스턴스 클래스를 선택한 다음 새 클러스터 생성으로 넘어갑니다.
**참고**  
클러스터 가동에 몇 분 정도 걸릴 수 있습니다.

## 클러스터 엔드포인트 복사
<a name="docdb-overview-create-cluster"></a>

Amazon DocumentDB 클러스터 엔드포인트를 복사하려면 다음 절차를 완료하세요.

**클러스터 엔드포인트 복사**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 연결 세부 정보를 복사할 클러스터를 마우스 우클릭한 다음 **엔드포인트 복사**를 선택하여 클러스터 엔드포인트 정보를 클립보드에 복사합니다.

1. 이제 클러스터 엔드포인트를 문서에 붙여 넣을 수 있습니다.

## 브라우저에서 열기
<a name="docdb-overview-browser-cluster"></a>

더 많은 클러스터 관리 기능을 사용하려면 AWS 콘솔에서 Amazon DocumentDB 클러스터를 엽니다. 기본 웹 브라우저에서 AWS 콘솔을 Amazon DocumentDB 클러스터로 열려면 다음 절차를 완료하세요.

**AWS 콘솔에서 클러스터 열기**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1.  AWS 콘솔에서 보려는 클러스터를 마우스 오른쪽 버튼으로 클릭한 다음 **브라우저에서 열기**를 선택합니다.

1.  AWS 콘솔이 열리고 기본 웹 브라우저의 Amazon DocumentDB 클러스터가 열립니다.

## 기존 클러스터 확장
<a name="docdb-overview-expand-cluster"></a>

인스턴스를 추가하여 Amazon DocumentDB 클러스터의 규모를 조정하려면, ‘’’다음 절차를 완료하세요.

**클러스터 확장을 위한 인스턴스 추가**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 확장하려는 클러스터를 마우스 우클릭하고 **인스턴스 추가를** 선택하여 VS Code에서 **인스턴스 추가** 대화 상자를 엽니다.

1. 프롬프트가 표시되면 텍스트 필드에 새 인스턴스의 이름을 입력한 다음 **Enter** 키를 눌러 계속합니다.

1. 프롬프트가 표시되면 목록에서 인스턴스 클래스를 선택하여 계속합니다.

1. 새 인스턴스가 준비되면 **AWS Explorer**에 생성 상태가 표시되고 업데이트됩니다.

## 클러스터 중지
<a name="docdb-overview-stopping-cluster"></a>

다음 절차를 완료하여 Amazon DocumentDB 클러스터를 중지합니다.

**참고**  
클러스터가 중지된 동안에는 대부분의 클러스터 관리 기능을 사용할 수 없습니다.

**Amazon DocumentDB 클러스터 중지**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 중지하려는 클러스터 옆에 있는 **클러스터 중지** 버튼을 선택하거나 클러스터를 마우스 우클릭하고 **클러스터 중지**를 선택합니다.

1. 프롬프트가 표시되면 **예**를 선택하여 클러스터를 중지하거나 **취소**를 선택하여 중지 프로세스를 취소하고 클러스터를 실행 상태로 둡니다.

1. **AWS 탐색기**는 클러스터의 상태를 표시하고 클러스터가 중지되면 업데이트합니다.

## 인스턴스 재부팅
<a name="docdb-overview-reboot-cluster"></a>

인스턴스 재부팅은 전체 클러스터에 영향을 주지 않으면서 문제를 해결하고 사소한 변경을 수행하는 데 유용합니다. Amazon DocumentDB 인스턴스를 재부팅하려면 다음 절차를 완료하세요.

**클러스터 인스턴스 재부팅**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 재부팅하려는 클러스터 인스턴스를 마우스 우클릭한 다음 **인스턴스 재부팅을** 선택합니다.

1. 프롬프트가 표시되면 **예**를 선택하여 인스턴스를 재부팅하거나 **취소**를 선택하여 재부팅 프로세스를 취소하고 인스턴스가 중지된 상태로 둡니다.

1. **AWS 탐색기**는 클러스터의 상태를 표시하고 인스턴스가 재부팅되면 업데이트합니다.

## 인스턴스 삭제
<a name="docdb-overview-delete-cluster"></a>

Amazon DocumentDB 클러스터 인스턴스를 삭제하려면 다음 절차를 완료하세요.

**참고**  
인스턴스를 삭제해도 클러스터의 데이터는 영향을 받지 않습니다. 기본 인스턴스를 삭제하면 복제본 인스턴스 중 하나가 쓰기 가능한 인스턴스로 대체됩니다.

**클러스터 인스턴스 삭제**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 삭제하려는 클러스터 인스턴스를 마우스 우클릭한 다음 **삭제**를 선택하여 VS Code에서 delete-cluster-instance 확인 대화 상자를 엽니다.

1. 확인 프롬프트에 따라 **Enter** 키를 눌러 클러스터 인스턴스를 삭제합니다.

1. **AWS 탐색기**는 클러스터 인스턴스의 상태를 표시하고 인스턴스가 삭제되면 업데이트합니다.

## 태그 보기, 추가 및 제거
<a name="docdb-overview-tags"></a>

태그는 환경 내에서 리소스를 구성하고 추적하는 데 사용됩니다. Amazon DocumentDB 클러스터와 연결된 태그를 보거나 편집하려면 다음 절차 중 하나를 완료합니다.

**클러스터 태그 보기**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 태그를 보려는 클러스터를 마우스 우클릭한 다음 **태그…**를 선택하여 ****your cluster name**용 태그** 대화 상자를 엽니다.

1. 태그가 대화 창에 표시되고 클러스터와 연결된 태그가 없는 경우, **[할당된 태그 없음]** 메시지가 표시됩니다.

**클러스터에 태그 추가**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 태그를 추가할 클러스터를 마우스 우클릭한 다음 **태그…**를 선택하여 ****your cluster name**용 태그** 대화 상자를 엽니다.

1. **태그 추가…** 버튼을 선택하여 VS Code에서 **태그 추가** 대화 상자를 엽니다.

1. 텍스트 필드에 새 태그를 입력한 다음 **입력** 키를 눌러 계속합니다.

1. 텍스트 필드에 값을 입력한 다음 **입력**을 눌러 키와 값 페어를 클러스터에 추가합니다.

**클러스터에서 태그 제거**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 태그를 제거할 클러스터를 마우스 우클릭한 다음 **태그…**를 선택하여 ****your cluster name**용 태그** 대화 상자를 엽니다.

1. **태그 제거…** 버튼을 선택하여 VS Code에서 ****your cluster name**에서 태그 제거** 대화 상자를 엽니다.

1. 제공된 목록에서 제거할 태그를 선택하여 클러스터에서 태그를 제거합니다.

## 인스턴스 클래스 수정
<a name="docdb-overview-instance-class"></a>

Amazon DocumentDB 클러스터 인스턴스의 클래스를 수정하려면 다음 절차를 완료하세요.

**인스턴스 클래스 수정**

1. 에서 **Amazon DocumentDB**를 AWS Toolkit for Visual Studio Code확장하여 Amazon DocumentDB 클러스터를 표시합니다.

1. 수정할 클러스터 인스턴스를 마우스 우클릭한 다음 **클래스 수정…**을 선택하여 VS Code에서 **인스턴스 클래스 선택** 대화 상자를 엽니다.

1. 목록에서 인스턴스의 새 클래스를 선택하여 클래스를 업데이트합니다.

1. **AWS 탐색기**는 클러스터 인스턴스의 상태를 표시하고 인스턴스의 클래스가 업데이트되면 업데이트합니다.