Distribuzione di DynamoDB in locale sul computer

Scarica DynamoDB locale gratuitamente da una delle seguenti posizioni.

Dopo aver scaricato l'archivio, estrai i contenuti e copia la directory estratta in una ubicazione a scelta.

Per avviare DynamoDB sul computer, aprire una finestra del prompt dei comandi, spostarsi nella directory in cui è stato estratto DynamoDBLocal.jar, quindi immettere il comando seguente.

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

Prima di poter accedere a AWS Command Line Interface in modo programmatico o tramite (AWS CLI), è necessario configurare le credenziali per abilitare l'autorizzazione per le applicazioni. Perché possa funzionare, la versione scaricabile di DynamoDB richiede le credenziali, come mostrato nell'esempio seguente.

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

È possibile utilizzare il comando aws configure di AWS CLI per impostare le credenziali. Per ulteriori informazioni, consulta Utilizzo di AWS CLI.

Inizia a scrivere le applicazioni. Per accedere a DynamoDB in esecuzione localmente con AWS CLI, usa --endpoint-url parametro. Ad esempio, per elencare le tabelle DynamoDB utilizzare il seguente comando:

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

Scarica e installa Docker Desktop.

Copiare il codice seguente in un file e salvarlo con nome 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

Se vuoi che l'applicazione e DynamoDB locale si trovino in container separati, utilizza il file yaml seguente.

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

Lo script docker-compose.yml crea un container app-node e un container dynamodb-local. Lo script esegue un comando nel container app-node che utilizza la AWS CLI per connettersi al container dynamodb-local e descrive i limiti di account e tabelle.

Per utilizzarlo con la propria immagine dell'applicazione, sostituire il valore image nell'esempio seguente con quello dell'applicazione:

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'

Emettere il seguente comando dalla riga di comando:

docker-compose up

Scarica e installa Apache Maven. Per ulteriori informazioni, consulta le pagine relative al download di Apache Maven e all'installazione di Apache Maven.

Aggiungi il repository Maven DynamoDB al file POM (Project Object Model) dell'applicazione:

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

Modello di esempio da utilizzare con 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.2</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>

Avviare AWS CloudShell dall'interfaccia della console, scegli una disponibile Regione AWS e passa alla tua shell preferita, come Bash, PowerShello shell Z.

Per scegliere un Regione AWS, vai al Seleziona una regione menu e seleziona un supportato Regione AWS. (Le Regioni disponibili sono evidenziate.)

Dal Console di gestione AWS, avvia AWS CloudShell scegliendo una delle seguenti opzioni:

1. Nella barra di navigazione seleziona l’icona AWS CloudShell.

2. Nel Cerca casella, inserisci la parola CloudShell, quindi scegli CloudShell.

3. Nel Visitato di recente widget, scegli CloudShell.

4. Dalla barra degli strumenti della console, scegli CloudShell.

Per eseguire DynamoDB localmente in AWS CloudShell puoi usare dynamodb-local alias. È possibile specificare opzioni aggiuntive della riga di comando per modificare le impostazioni di DynamoDB locale. Consulta Note per l'utilizzo locale di DynamoDB per conoscere le opzioni disponibili.

Per accedere a DynamoDB in esecuzione localmente in AWS CloudShell con AWS CLI, usa il --endpoint-url parametro. Ad esempio, per elencare le tabelle DynamoDB utilizza il seguente comando:

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