Men-deploy DynamoDB secara lokal pada komputer Anda

penting

Toples lokal DynamoDB dapat diunduh dari tautan distribusi AWS CloudFront kami yang direferensikan di sini. Mulai 1 Januari 2025, bucket distribusi S3 lama tidak lagi aktif dan DynamoDB lokal akan didistribusikan melalui tautan distribusi saja. CloudFront

catatan

Ada dua versi utama DynamoDB lokal yang tersedia: DynamoDB local v2.x (Current) dan DynamoDB local v1.x (Legacy). Pelanggan harus menggunakan versi 2.x (Current) bila memungkinkan, karena mendukung versi terbaru Java Runtime Environment dan kompatibel dengan namespace jakarta.* untuk proyek Maven. DynamoDB local v1.x akan mencapai akhir dukungan standar mulai 1 Januari 2025. Setelah tanggal ini, v1.x tidak akan lagi menerima pembaruan atau perbaikan bug.
DynamoDB lokal AWS_ACCESS_KEY_ID hanya dapat berisi huruf (A–Z, a–z) dan angka (0–9).

Ikuti langkah berikut untuk menyiapkan dan menjalankan DynamoDB pada komputer Anda.

Untuk menyiapkan DynamoDB pada komputer Anda

Unduh DynamoDB lokal secara gratis dari salah satu lokasi berikut.

Tautan Unduhan	Checksum
.tar.gz \| .zip	.tar.gz.sha256 \| .zip.sha256

penting

Untuk menjalankan DynamoDB v2.5.0 atau lebih tinggi di komputer Anda, Anda harus memiliki Java Runtime Environment JRE () versi 17.x atau yang lebih baru. Aplikasi tidak berjalan pada JRE versi sebelumnya.

Setelah Anda mengunduh arsip, ekstrak isinya dan salin direktori yang diekstrak ke lokasi pilihan Anda.
Untuk memulai DynamoDB di komputer Anda, buka jendela prompt perintah, navigasikan ke direktori tempat Anda mengekstrak DynamoDBLocal.jar, dan ketik perintah berikut.
```
java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb
```
catatan
Jika Anda menggunakan Windows PowerShell, pastikan untuk melampirkan nama parameter atau seluruh nama dan nilai seperti ini:
java -D"java.library.path=./DynamoDBLocal_lib" -jar DynamoDBLocal.jar
DynamoDB memproses permintaan masuk hingga Anda menghentikannya. Untuk menghentikan DynamoDB, tekan Ctrl+C pada prompt perintah.
DynamoDB menggunakan port 8000 secara default. Jika port 8000 tidak tersedia, perintah ini memunculkan pengecualian. Untuk daftar lengkap opsi runtime DynamoDB, termasuk -port, masukkan perintah ini.
java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help
Sebelum Anda dapat mengakses DynamoDB secara terprogram atau melalui AWS Command Line Interface (AWS CLI), Anda harus mengonfigurasi kredensial Anda untuk mengaktifkan otorisasi bagi aplikasi Anda. DynamoDB yang dapat diunduh memerlukan kredensial untuk bisa berfungsi, seperti yang ditunjukkan dalam contoh berikut.
```
AWS Access Key ID: "fakeMyKeyId"
AWS Secret Access Key: "fakeSecretAccessKey"
Default Region Name: "fakeRegion"
```
Anda dapat menggunakan perintah aws configure dari AWS CLI untuk menyiapkan kredensial. Untuk informasi selengkapnya, lihat Menggunakan AWS CLI.
Mulai menulis aplikasi. Untuk mengakses DynamoDB berjalan secara lokal dengan, gunakan parameter AWS CLI. --endpoint-url Misalnya, gunakan perintah berikut untuk membuat daftar tabel DynamoDB.
```
aws dynamodb list-tables --endpoint-url http://localhost:8000
```

Versi Amazon DynamoDB yang dapat diunduh tersedia sebagai citra Docker. Untuk informasi selengkapnya, lihat dynamodb-local. Untuk melihat versi lokal DynamoDB Anda saat ini, masukkan perintah berikut:


java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -version

Untuk contoh penggunaan DynamoDB lokal sebagai bagian dari REST aplikasi yang dibangun di atas AWS Serverless Application Model AWS SAM(), lihat aplikasi SAMDynamoDB untuk mengelola pesanan. Contoh aplikasi ini menunjukkan cara menggunakan DynamoDB lokal untuk pengujian.

Jika Anda ingin menjalankan aplikasi multi-kontainer yang juga menggunakan kontainer lokal DynamoDB, gunakan Docker Compose untuk menentukan dan menjalankan semua layanan di aplikasi Anda, termasuk DynamoDB lokal.

Untuk menginstal dan menjalankan DynamoDB lokal dengan penulisan Docker:

Unduh dan instal desktop Docker.

Salin kode berikut ke file dan simpan sebagai docker-compose.yml.


version: '3.8'
services:
 dynamodb-local:
   command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data"
   image: "amazon/dynamodb-local:latest"
   container_name: dynamodb-local
   ports:
     - "8000:8000"
   volumes:
     - "./docker/dynamodb:/home/dynamodblocal/data"
   working_dir: /home/dynamodblocal

Jika Anda ingin aplikasi Anda dan DynamoDB lokal berada dalam kontainer terpisah, gunakan file yaml berikut.


version: '3.8'
services:
 dynamodb-local:
   command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data"
   image: "amazon/dynamodb-local:latest"
   container_name: dynamodb-local
   ports:
     - "8000:8000"
   volumes:
     - "./docker/dynamodb:/home/dynamodblocal/data"
   working_dir: /home/dynamodblocal
 app-node:
   depends_on:
     - dynamodb-local
   image: amazon/aws-cli
   container_name: app-node
   ports:
    - "8080:8080"
   environment:
     AWS_ACCESS_KEY_ID: 'DUMMYIDEXAMPLE'
     AWS_SECRET_ACCESS_KEY: 'DUMMYEXAMPLEKEY'
   command:
     dynamodb describe-limits --endpoint-url http://dynamodb-local:8000 --region us-west-2

Skrip docker-compose.yml ini membuat kontainer app-node dan kontainer dynamodb-local. Skrip menjalankan perintah di kontainer app-node yang menggunakan AWS CLI untuk terhubung ke kontainer dynamodb-local dan menjelaskan batas akun dan tabel.

Untuk digunakan dengan gambar aplikasi Anda sendiri, ganti nilai image pada contoh di bawah dengan nilai gambar aplikasi Anda.


version: '3.8'
services:
 dynamodb-local:
   command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data"
   image: "amazon/dynamodb-local:latest"
   container_name: dynamodb-local
   ports:
     - "8000:8000"
   volumes:
     - "./docker/dynamodb:/home/dynamodblocal/data"
   working_dir: /home/dynamodblocal
 app-node:
   image: location-of-your-dynamodb-demo-app:latest
   container_name: app-node
   ports:
     - "8080:8080"
   depends_on:
     - "dynamodb-local"
   links:
     - "dynamodb-local"
   environment:
     AWS_ACCESS_KEY_ID: 'DUMMYIDEXAMPLE'
     AWS_SECRET_ACCESS_KEY: 'DUMMYEXAMPLEKEY'
     REGION: 'eu-west-1'

catatan

YAMLSkrip mengharuskan Anda menentukan kunci AWS akses dan kunci AWS rahasia, tetapi mereka tidak diharuskan menjadi AWS kunci yang valid bagi Anda untuk mengakses DynamoDB lokal.

Jalankan perintah baris perintah berikut:
```
docker-compose up
```

Ikuti langkah-langkah berikut untuk menggunakan Amazon DynamoDB dalam aplikasi Anda sebagai dependensi.

Untuk men-deploy DynamoDB sebagai repositori Apache Maven

Unduh dan instal Apache Maven. Untuk informasi selengkapnya, lihat Mengunduh Apache Maven dan Menginstal Apache Maven.

Tambahkan repositori DynamoDB Maven ke file Project Object Model () aplikasi Anda. POM


<!--Dependency:-->
<dependencies>
   <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>DynamoDBLocal</artifactId>
      <version>2.5.0</version>
   </dependency>
</dependencies>

Contoh template untuk digunakan dengan Spring Boot 3 dan/atau Spring Framework 6:


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>

<groupId>org.example</groupId>
<artifactId>SpringMavenDynamoDB</artifactId>
<version>1.0-SNAPSHOT</version>

<properties>
   <spring-boot.version>3.0.1</spring-boot.version>
   <maven.compiler.source>17</maven.compiler.source>
   <maven.compiler.target>17</maven.compiler.target>
   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>3.0.1</version>
   </parent>

<dependencies>
   <dependency>
       <groupId>com.amazonaws</groupId>
       <artifactId>DynamoDBLocal</artifactId>
       <version>2.5.0</version>
   </dependency>
   <!-- Spring Boot -->
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter</artifactId>
       <version>${spring-boot.version}</version>
   </dependency>
   <!-- Spring Web -->
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
       <version>${spring-boot.version}</version>
   </dependency>
   <!-- Spring Data JPA -->
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-jpa</artifactId>
       <version>${spring-boot.version}</version>
   </dependency>
   <!-- Other Spring dependencies -->
   <!-- Replace the version numbers with the desired version -->
   <dependency>
       <groupId>org.springframework</groupId>
       <artifactId>spring-context</artifactId>
       <version>6.0.0</version>
   </dependency>
   <dependency>
       <groupId>org.springframework</groupId>
       <artifactId>spring-core</artifactId>
       <version>6.0.0</version>
   </dependency>
   <!-- Add other Spring dependencies as needed -->
   <!-- Add any other dependencies your project requires -->
</dependencies>
</project>

catatan

Anda juga dapat menggunakan repositori pusat Maven. URL

Untuk contoh proyek sampel yang menampilkan beberapa pendekatan untuk menyiapkan dan menggunakan DynamoDB lokal, termasuk JAR mengunduh file, menjalankannya sebagai image Docker, dan menggunakannya sebagai dependensi Maven, lihat DynamoDB Local Sample Java Project.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menyiapkan DynamoDB lokal (versi yang dapat diunduh)

Catatan penggunaan