Bereitstellen der lokalen Version von DynamoDB auf Ihrem Computer

Laden Sie die lokale Version von DynamoDB kostenlos von einem der folgenden Speicherorte herunter.

Nachdem Sie das Archiv heruntergeladen haben, extrahieren Sie die Inhalte und kopieren Sie das entpackte Verzeichnis an einen Speicherort Ihrer Wahl.

Zum Starten von DynamoDB auf Ihrem Computer, öffnen Sie ein Befehlszeilenfenster, gehen Sie zu dem Verzeichnis, in das Sie DynamoDBLocal.jar extrahiert haben, und geben Sie den folgenden Befehl ein.

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

Bevor Sie programmgesteuert oder über die AWS Command Line Interface(AWS CLI) auf DynamoDB zugreifen können, müssen Sie die Anmeldeinformationen so konfigurieren, dass die Autorisierung für die Anwendungen aktiviert wird. Die herunterladbare Version von DynamoDB benötigt Anmeldeinformationen, um arbeiten zu können, wie in dem folgenden Beispiel gezeigt.

AWS Access Key ID: "fakeMyKeyId" 
AWS Secret Access Key: "fakeSecretAccessKey"
Default Region Name: "fakeRegion"

Sie können die Anmeldeinformationen mit dem AWS CLI-Befehl aws configure einrichten. Weitere Informationen finden Sie unter Verwendung der AWS CLI.

Beginnen Sie mit dem Schreiben von Anwendungen. Um mit der DynamoDB auf die lokal ausgeführte AWS CLI-Version zuzugreifen, verwenden Sie den Parameter --endpoint-url . Sie können z. B. den folgenden Befehl verwenden, um DynamoDB-Tabellen aufzulisten.

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

Führen Sie Download und Installation von Docker Desktop durch.

Kopieren Sie den folgenden Code in eine Datei, und speichern Sie ihn unter 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

Wenn sich Ihre Anwendung und DynamoDB lokal in separaten Containern befinden sollen, verwenden Sie die folgende YAML-Datei:

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

Dieses docker-compose.yml-Skript erstellt einen app-node-Container und einen dynamodb-local-Container. Das Skript führt einen Befehl im Container app-node aus, der mithilfe der AWS CLI eine Verbindung mit dem dynamodb-local-Container herstellt und die Konten- und Tabellenlimits beschreibt.

Wenn Sie diesen Vorgang bei Ihrem eigenen Anwendungsimage verwenden möchten, ersetzen Sie den Wert image im folgenden Beispiel durch den Wert Ihrer Anwendung.

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'

Führen Sie die folgende Befehlzeilen-Befehle aus:

docker-compose up

Laden Sie Apache Maven herunter und installieren Sie es. Weitere Informationen finden Sie unter Downloading Apache Maven und Installing Apache Maven.

Fügen Sie das DynamoDB-Maven-Repository zur POM-Datei (Project Object Model) Ihrer Anwendung hinzu.

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

Beispielvorlage zur Verwendung mit Spring Boot 3 und/oder 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>3.1.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>

Starten Sie AWS CloudShell von der Konsolenoberfläche aus, wählen Sie eine verfügbare AWS-Region aus und wechseln Sie zu Ihrer bevorzugten Shell (z. B. Bash, PowerShell oder Z-Shell).

Rufen Sie das Menü Auswählen einer Region auf und wählen Sie eine unterstützte AWS-Region aus, um einen AWS-Region auszuwählen. (Verfügbare Regionen sind hervorgehoben.)

Starten Sie AWS CloudShell aus der AWS-Managementkonsole, indem Sie eine der folgenden Optionen wählen:

1. Klicken Sie in der Navigationsleiste auf das AWS CloudShell-Symbol.

2. Geben Sie in das Suchfeld das Wort CloudShell ein, und wählen Sie dann CloudShell aus.

3. Wählen Sie im Widget Kürzlich besucht die Option CloudShell aus.

4. Wählen Sie in der Werkzeugleiste der Konsole CloudShell aus.

Um die lokale Version von DynamoDB in AWS CloudShell auszuführen, können Sie den dynamodb-local-Alias verwenden. Sie können zusätzliche Befehlszeilenoptionen zum Ändern der Einstellungen Ihrer lokalen Version von DynamoDB angeben. Die verfügbaren Optionen finden Sie unter DynamoDB-Local-Nutzungshinweise .

Verwenden Sie den Parameter --endpoint-url, um auf die lokal ausgeführte Version von DynamoDB in AWS CloudShell über die AWS CLI zuzugreifen. Sie können z. B. den folgenden Befehl verwenden, um DynamoDB-Tabellen aufzulisten:

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