在本機電腦上部署 DynamoDB

從下列其中一個位置免費下載 DynamoDB 本機版。

在您下載封裝後，請解壓縮內容，並將解壓縮的目錄複製到您選擇的位置。

若要在您的電腦上啟動 DynamoDB，請開啟命令提示視窗，導覽至您解壓縮 DynamoDBLocal.jar 的目錄，然後輸入下列命令。

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

以程式設計方式或透過 AWS Command Line Interface (AWS CLI) 存取 DynamoDB 之前，您必須先設定您的憑證，以便啟用您的應用程式授權。可下載版 DynamoDB 需要所有憑證才能運作，如下列範例所示。

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

您可以使用 AWS CLI 的 aws configure 命令來設定憑證。如需詳細資訊，請參閱 使用 AWS CLI。

開始寫入應用程式。若要使用 在本機執行的 DynamoDB AWS CLI，請使用 --endpoint-url 參數。例如，使用下列命令來列出 DynamoDB 資料表。

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

下載並安裝 Docker Desktop。

將以下程式碼複製到一個檔案中並儲存為 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

如果您想讓應用程式和 DynamoDB 本機版位於不同的容器中，請使用以下 yaml 檔案。

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

這個 docker-compose.yml 指令碼會建立一個 app-node 容器和一個 dynamodb-local 容器。指令碼會在 app-node 容器中執行命令，該命令使用 dynamodb-local 連線至 AWS CLI 容器，並說明帳戶和資料表限制。

若要搭配您自己的應用程式影像使用，請將下列範例中的 image 數值取代為您應用程式的數值：

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'

執行下列命令列命令：

docker-compose up

下載並安裝 Apache Maven。如需詳細資訊，請參閱下載 Apache Maven 和安裝 Apache Maven。

將 DynamoDB Maven 儲存庫新增至您應用程式的專案物件模型 (POM) 檔案。

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

與 Spring Boot 3 和/或 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>

AWS CloudShell 從主控台界面啟動，選擇可用的 AWS 區域，然後切換到您偏好的 shell，例如 Bash、PowerShell 或 Z shell。

若要選擇 AWS 區域，請前往選取區域功能表，然後選取支援的 AWS 區域 。(可用區域會反白顯示。)

從 中 AWS 管理主控台，選擇下列其中一個選項 AWS CloudShell 來啟動 ：

1. 在導覽列上，選擇 AWS CloudShell 圖示。

2. 在搜尋方塊中，輸入 CloudShell 一詞，然後選擇 CloudShell。

3. 在最近造訪的小工具中，選擇 CloudShell。

4. 從主控台工具列中，選擇 CloudShell。

若要在本機執行 DynamoDB AWS CloudShell ，您可以使用dynamodb-local別名。您可以指定變更 DynamoDB 本機版設定的其他命令列選項。關於可用的選項，請參閱 DynamoDB 本機版使用須知。

若要 AWS CloudShell 使用 存取在本機執行的 DynamoDB AWS CLI，請使用 --endpoint-url 參數。例如，使用下列命令來列出 DynamoDB 資料表：

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