View a markdown version of this page

Men-deploy DynamoDB secara lokal pada komputer Anda - Amazon DynamoDB

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Men-deploy DynamoDB secara lokal pada komputer Anda

catatan
  • DynamoDB lokal tersedia dalam tiga versi: v3.x (Current), v2.x (Legacy), dan v1.x (Deprecated).

  • DynamoDB v3.x direkomendasikan untuk penggunaan pengujian dan pengembangan lokal Anda.

  • Migrasi dari DynamoDB lokal V2.x ke V3.x memerlukan pembaruan pernyataan impor dari com.amazonaws.services.dynamodbv2 ke software.amazon.dynamodb dan memperbarui dependensi Maven untuk pengguna Maven.

  • Jika Anda memigrasikan aplikasi yang menggunakan SDK untuk Java v1.x ke SDK untuk Java 2.x, ikuti langkah-langkah untuk AWS SDK untuk Java 2.x.

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

Untuk menyiapkan DynamoDB pada komputer Anda
  1. 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.6.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 versi JRE sebelumnya.

  2. Setelah Anda mengunduh arsip, ekstrak isinya dan salin direktori yang diekstrak ke lokasi pilihan Anda.

  3. 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 "-Djava.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

  4. 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.

  5. Mulai menulis aplikasi. Untuk mengakses DynamoDB berjalan secara lokal dengan AWS CLI, gunakan parameter. --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 aplikasi REST yang dibangun di atas AWS Serverless Application Model (AWS SAM), lihat aplikasi SAM DynamoDB 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:
  1. Unduh dan instal desktop Docker.

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

    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.

    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.

    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

    Skrip YAML 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.

  3. Jalankan perintah baris perintah berikut:

    docker-compose up
catatan

Jika Anda memigrasikan aplikasi yang menggunakan SDK untuk Java v1.x ke SDK untuk Java 2.x, ikuti langkah-langkah untuk AWS SDK untuk Java 2.x.

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

Untuk men-deploy DynamoDB sebagai repositori Apache Maven
  1. Unduh dan instal Apache Maven. Untuk informasi selengkapnya, lihat Mengunduh Apache Maven dan Menginstal Apache Maven.

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

    <!--Dependency:--> <dependencies> <dependency> <groupId>software.amazon.dynamodb</groupId> <artifactId>DynamoDBLocal</artifactId> <version>3.3.0</version> </dependency> </dependencies>

    Contoh template untuk digunakan dengan Spring Boot 3 and/or 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.1.0</version> </parent> <dependencies> <dependency> <groupId>software.amazon.dynamodb</groupId> <artifactId>DynamoDBLocal</artifactId> <version>3.3.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 URL repositori pusat Maven.

AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari. Konsol Manajemen AWS Anda dapat menavigasi ke AWS CloudShell dari Konsol Manajemen AWS beberapa cara yang berbeda. Untuk informasi selengkapnya, lihat Mem ulai dengan AWS CloudShell.

Ikuti langkah-langkah ini untuk menjalankan DynamoDB lokal di AWS CloudShell mana saja di. Konsol Manajemen AWS

Untuk menjalankan DynamoDB lokal di AWS CloudShell di Konsol Manajemen AWS
  1. Lun AWS CloudShell curkan dari antarmuka konsol, pilih yang tersedia Wilayah AWS, dan beralih ke shell pilihan Anda, seperti Bash, PowerShell, atau Z shell.

  2. Untuk memilih Wilayah AWS, buka menu Pilih Wilayah dan pilih yang didukung Wilayah AWS. (Wilayah yang tersedia disorot.)

  3. Dari Konsol Manajemen AWS, luncur AWS CloudShell kan dengan memilih salah satu opsi berikut:

    1. Pada bilah navigasi, pilih AWS CloudShell ikon.

    2. Di kotak Pencarian, masukkan kata CloudShell, lalu pilih CloudShell.

    3. Di widget Baru-baru ini dikunjungi, pilih CloudShell.

    4. Dari bilah alat konsol, pilih CloudShell.

  4. Untuk menjalankan DynamoDB lokal di AWS CloudShell Anda dapat menggunakan alias. dynamodb-local Anda dapat menentukan opsi baris perintah tambahan untuk mengubah pengaturan lokal DynamoDB. Lihat Catatan penggunaan DynamoDB lokal opsi yang tersedia.

    catatan

    Untuk menjalankan DynamoDB lokal di latar belakang, jalankan DynamoDB local menggunakan:. AWS CloudShell dynamodb-local &

  5. Untuk mengakses DynamoDB yang berjalan secara lokal AWS CloudShell dengan AWS CLI, gunakan parameter. --endpoint-url Misalnya, gunakan perintah berikut untuk mencantumkan tabel DynamoDB:

    aws dynamodb list-tables --endpoint-url http://localhost:8000

Untuk contoh proyek sampel yang menampilkan beberapa pendekatan untuk mengatur dan menggunakan DynamoDB lokal, termasuk mengunduh file JAR, menjalankannya sebagai gambar Docker, dan menggunakannya sebagai dependensi Maven, lihat Proyek Java Sampel Lokal DynamoDB.