Implementación de DynamoDB localmente en la computadora
importante
El jar de DynamoDB local se puede descargar desde nuestros enlaces de distribución de AWS CloudFront, a los que se hace referencia aquí. A partir del 1 de enero de 2025, los antiguos buckets de distribución de S3 dejarán de estar activos y DynamoDB local se distribuirá únicamente a través de los enlaces de distribución de CloudFront.
nota
-
Hay dos versiones principales de DynamoDB local disponibles: DynamoDB local v2.x (actual) y DynamoDB local v1.x (heredada). Los clientes deben usar la versión 2.x (actual) siempre que sea posible, ya que admite las versiones más recientes del Entorno de ejecución de Java y es compatible con el espacio de nombres jakarta.* del proyecto Maven. DynamoDB local v1.x dejará de ofrecer soporte estándar a partir del 1 de enero de 2025. Después de esta fecha, la versión 1.x ya no recibirá actualizaciones ni correcciones de errores.
-
AWS_ACCESS_KEY_ID
de DynamoDB local solo puede contener letras (A-Z, a-z) y números (0-9).
Siga estos pasos para configurar y ejecutar DynamoDB en el ordenador.
Para configurar DynamoDB en su ordenador
-
Descargue DynamoDB local gratis desde una de las siguientes ubicaciones.
Enlaces de descarga Sumas de comprobación importante
Para ejecutar la versión 2.5.3 o posterior de DynamoDB en el equipo, debe disponer del Entorno de ejecución de Java (JRE) versión 17.x o posterior. La aplicación no se ejecuta en versiones anteriores de JRE.
-
Después de descargar el archivo, extraiga el contenido y copie el directorio extraído en la ubicación que prefiera.
-
Para iniciar DynamoDB en el ordenador, abra una ventana del símbolo del sistema, vaya al directorio donde ha extraído
DynamoDBLocal.jar
e ingrese el comando siguiente.java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb
nota
Si utiliza Windows PowerShell, asegúrese de delimitar el nombre del parámetro o todo el nombre y el valor del siguiente modo:
java -D"java.library.path=./DynamoDBLocal_lib" -jar DynamoDBLocal.jar
DynamoDB procesa las solicitudes entrantes hasta que lo detiene. Para detener DynamoDB, escriba Ctrl+C en la ventana del símbolo del sistema.
De manera predeterminada, DynamoDB usa el puerto 8000. Si el puerto 8000 no está disponible, este comando genera una excepción. Para obtener una lista completa de opciones de tiempo de ejecución de DynamoDB, incluida
-port
, ingrese este comando.java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help
-
Para poder acceder a DynamoDB mediante programación o a través de la AWS Command Line Interface (AWS CLI), debe configurar sus credenciales para habilitar la autorización para sus aplicaciones. DynamoDB descargable requiere cualquier credencial para funcionar, como se muestra en el siguiente ejemplo.
AWS Access Key ID: "fakeMyKeyId" AWS Secret Access Key: "fakeSecretAccessKey" Default Region Name: "fakeRegion"
Puede utilizar el comando
aws configure
de la AWS CLI para configurar las credenciales. Para obtener más información, consulte Uso de la AWS CLI. -
Comience a escribir aplicaciones. Para acceder a DynamoDB ejecutado localmente con la AWS CLI, use el parámetro
--endpoint-url
. Por ejemplo, utilice el siguiente comando para enumerar las tablas de DynamoDB.aws dynamodb list-tables --endpoint-url http://localhost:8000
La versión descargable de Amazon DynamoDB también está disponible como imagen de Docker. Para obtener más información, consulte dynamodb-local
java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -version
Para ver un ejemplo del uso de DynamoDB local como parte de una aplicación REST construida en AWS Serverless Application Model (AWS SAM), consulte Aplicación DynamoDB de SAM para administración de pedidos
Si desea ejecutar una aplicación multicontenedor que también utilice el contenedor local de DynamoDB, utilice Docker Compose para definir y ejecutar todos los servicios de la aplicación, incluido DynamoDB local.
Para instalar y ejecutar DynamoDB local con Docker Compose:
-
Descargue e instale Docker Desktop
. -
Copie el siguiente código en un archivo y guárdelo como
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
Si desea que su aplicación y DynamoDB local estén en contenedores independientes use el siguiente archivo yaml.
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
Este script docker-compose.yml crea un contenedor
app-node
y un contenedordynamodb-local
. El script ejecuta un comando en el contenedorapp-node
que utiliza la AWS CLI para conectarse con el contenedordynamodb-local
y describe los límites de cuenta y tabla.Para usar con su propia imagen de aplicación, reemplace el valor
image
del ejemplo siguiente por el de su aplicación.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'nota
Los scripts de YAML requieren que especifique una clave de acceso de AWS y una clave secreta de AWS, pero no se requiere que sean claves de AWS válidas para que pueda acceder a DynamoDB local.
-
Ejecute el siguiente comando de línea de comandos:
docker-compose up
Siga estos pasos para usar Amazon DynamoDB en su aplicación como dependencia.
Para implementar DynamoDB como repositorio de Apache Maven
-
Descargue e instale Apache Maven. Para obtener más información, consulte Downloading Apache Maven
e Installing Apache Maven . -
Agregue el repositorio de Maven para DynamoDB al archivo POM (Project Object Model) de la aplicación.
<!--Dependency:--> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>DynamoDBLocal</artifactId> <version>2.5.3</version> </dependency> </dependencies>
Ejemplo de plantilla para usar con Spring Boot 3 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>2.5.3</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>
nota
También puede usar la URL del repositorio central de Maven
.
Para ver un ejemplo de un proyecto de ejemplo que muestre varios enfoques para configurar y usar DynamoDB local, incluida la descarga de archivos JAR, su ejecución como imagen de Docker y su uso como una dependencia de Maven, consulte DynamoDB Local Sample Java Project