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

# Amazon QLDB Node.js 샘플 애플리케이션 설치
샘플 애플리케이션 설치

**중요**  
지원 종료 공지: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 [Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)을 참조하세요.

이 섹션에서는 단계별 Node.js 자습서를 위해 제공된 Amazon QLDB 샘플 애플리케이션을 설치하고 실행하는 방법을 설명합니다. 이 샘플 애플리케이션의 사용 사례는 차량 등록에 대한 전체 기록 정보를 추적하는 자동차 부서(DMV) 데이터베이스입니다.

Node.js용 DMV 샘플 애플리케이션은 GitHub 리포지토리 [aws-samples/amazon-qldb-dmv-sample-nodejs](https://github.com/aws-samples/amazon-qldb-dmv-sample-nodejs)의 오픈 소스입니다.

## 사전 조건


시작하기 전에 Node.js [사전 조건](getting-started.nodejs.md#getting-started.nodejs.prereqs)용 QLDB 드라이버를 완료했는지 확인합니다. 여기에는 Node.js 설치 및 다음 작업이 포함됩니다.

1. 가입합니다 AWS.

1. 적절한 QLDB 권한을 가진 사용자를 생성합니다.

1. 개발을 위한 프로그래밍 방식 액세스 권한을 부여합니다.

이 자습서의 모든 단계를 완료하려면 QLDB API를 통해 원장 리소스에 대한 전체 관리 액세스 권한이 필요합니다.

## 설치


**샘플 애플리케이션을 설치하려면**

1. 다음 명령을 입력하여 GitHub에서 샘플 애플리케이션을 복제합니다.

------
#### [ 2.x ]

   ```
   git clone https://github.com/aws-samples/amazon-qldb-dmv-sample-nodejs.git
   ```

------
#### [ 1.x ]

   ```
   git clone -b v1.0.0 https://github.com/aws-samples/amazon-qldb-dmv-sample-nodejs.git
   ```

------

   샘플 애플리케이션은 Node.js 드라이버 및 [Node.js의 JavaScript용AWS SDK](https://aws.amazon.com/sdk-for-node-js)를 포함하여 이 자습서의 전체 소스 코드와 해당 종속성을 패키징합니다. 이 애플리케이션은 TypeScript로 작성되었습니다.

1. `amazon-qldb-dmv-sample-nodejs` 패키지가 복제된 디렉토리로 전환합니다.

   ```
   cd amazon-qldb-dmv-sample-nodejs
   ```

1. 종속성을 클린 설치합니다.

   ```
   npm ci
   ```

1. 패키지를 트랜스파일합니다.

   ```
   npm run build
   ```

   트랜스파일된 JavaScript 파일은 `./dist` 디렉터리에 작성됩니다.

1. [1단계: 새 원장 생성](getting-started.nodejs.step-1.md)로 진행하여 자습서를 시작하고 원장을 생성하세요.