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 eseguito in locale con la AWS CLI, utilizza il parametro --endpoint-url . 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.

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

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:

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'

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>com.amazonaws</groupId>
      <artifactId>DynamoDBLocal</artifactId>
      <version>3.1.0</version>
   </dependency>
</dependencies>

Modello di esempio da utilizzare con Spring Boot 3 e/o 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>

Avvia AWS CloudShell dall’interfaccia della console, seleziona una Regione AWS disponibile e passa alla tua shell preferita (Bash, PowerShell o Z shell).

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

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

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

2. Nella casella Cerca, inserisci la parola CloudShell, quindi seleziona CloudShell.

3. Nel widget Visitato di recente, seleziona CloudShell.

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

Per eseguire DynamoDB locale in AWS CloudShell è possibile usare l’alias dynamodb-local. È 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 in locale in AWS CloudShell con la AWS CLI, utilizza il parametro --endpoint-url. Ad esempio, per elencare le tabelle DynamoDB utilizza il seguente comando:

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