安裝亞馬遜 QLDB Java 範例應用程式 - Amazon Quantum Ledger Database (Amazon QLDB)
先決條件安裝

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

安裝亞馬遜 QLDB Java 範例應用程式

本節說明如何安裝和執行針對 step-by-step Java 教學課程提供的 Amazon QLDB 範例應用程式。此示例應用程序的用例是一個機動車輛部門（DMV）數據庫，用於跟踪有關車輛註冊的完整歷史信息。

適用於 Java 的 DMV 示例應用程序在 GitHub 存儲庫中是開源的 aws-Sample/amazon-qldb-dmv-sample-java。

先決條件

在開始之前，請確定您已完成適用於 Java 的 QLDB 驅動程式先決條件。這包含下列項目：

  1. 註冊 AWS。

  2. 建立具有適當 QLDB 權限的使用者。若要完成本教學課程中的所有步驟，您需要透過 QLDB API 存取分類帳資源的完整管理存取權。

  3. 如果您使用的是 IDE 以外的其他 IDEAWS Cloud9，請安裝 Java 並授予程式設計存取權以進行開發。

安裝

下列步驟說明如何使用本機開發環境下載及設定範例應用程式。或者，您可以將範例應用AWS Cloud9程式設定自動化，方法是將您的 IDE 和AWS CloudFormation範本用於佈建您的開發資源。

這些指示說明如何使用您自己的資源和開發環境下載和安裝 QLDB Java 範例應用程式。

下載並執行範例應用程式

  1. 輸入下列命令以從中複製範例應用程式 GitHub。

    2.x
    git clone https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git
    1.x
    git clone -b v1.2.0 https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git

    此套件包含 Gradle 組態和來自Java 教學.

  2. 載入並執行提供的應用程式。

    • 如果您使用的是日食：

      1. 啟動 Eclipse，並在 Eclipse 菜單上，選擇文件，導入，然後現有搖籃項目。

      2. 在專案根目錄中，瀏覽並選取包含該build.gradle檔案的應用程式目錄。然後，選擇「完成」以使用導入的默認 Gradle 設置。

      3. 你可以嘗試運行程ListLedgers序作為一個例子。開啟檔案的內容 (按一下右鍵) 開啟ListLedgers.java檔案的內容 (按一下右鍵) 開啟檔案的內容選單

    • 如果您使用的是 Intellij：

      1. 啟動 IntelliJ，然後在 In telliJ 功能表上選擇檔案，然後選擇開啟。

      2. 在專案根目錄中，瀏覽並選取包含該build.gradle檔案的應用程式目錄。然後，選擇 「確定」。保留預設設定，然後再次選擇「確定」。

      3. 你可以嘗試運行程ListLedgers序作為一個例子。開啟檔案的內容 (按一下右鍵) 開啟ListLedgers.java檔案的內容 (按一下右鍵) 開啟檔案ListLedgers的內容

  3. 繼續進行步驟 1：建立新分類帳以啟動自學課程並建立分類帳。

這些指示說明如何將 Amazon QLDB 車輛註冊範例應用程式設定為 Java，並將其用AWS Cloud9作您的 IDE 自動化。在本指南中，您會使用AWS CloudFormation範本來佈建您的開發資源。

如需有關 AWS Cloud9 的詳細資訊，請參閱《 使用者指南》AWS Cloud9。若要進一步了解 AWS CloudFormation，請參閱 AWS CloudFormation 使用者指南。

第 1 部分：佈建資源

在第一個步驟中，您可AWS CloudFormation以使用 Amazon QLDB 範例應用程式佈建設定開發環境所需的資源。

開啟AWS CloudFormation主控台並載入 QLDB 範例應用程式範本

  1. 請登入 AWS Management Console，開啟位於 https://console.aws.amazon.com/cloudformation 的 AWS CloudFormation 主控台。

    切換至支援 QLDB 的地區。如需完整清單，請參閱中的 Amazon QLDB 端點和配額AWS 一般參考。下列的螢幕擷取得下列螢幕擷取得下列螢幕擷取得AWS Management Console了下列螢幕擷取得的畫AWS 區域面

    AWS Management Console將美國東部 (維吉尼亞北部) 顯示為已選取得AWS 區域。

  2. 在AWS CloudFormation主控台上，選擇 [建立堆疊]，然後選擇 [使用新資源 (標準)]。

  3. 在「建立堆疊」頁面的「指定範本」下，選擇 Amazon S3 URL。

  4. 輸入下列 URL，然後選擇 [下一步]。

    https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml

  5. 輸入堆疊名稱 (例如qldb-sample-app)，然後選擇「下一步」。

  6. 您可以視需要新增任何標籤，並保留預設選項。然後選擇 Next (下一步)。

  7. 檢閱堆疊設定，然後選擇 [建立堆疊]。指AWS CloudFormation令碼可能需要幾分鐘時間才能完成完成設定。

    在本教程中，此指令碼使用相關的 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體佈建您的AWS Cloud9環境，可供您用來執行 QLDB 範例應用程式。它還將 aws-Samples/amazon-qldb-dmv-sample-java 存儲庫從克隆 GitHub 到您的AWS Cloud9開發環境中。

第 2 部分：設定您的 IDE

在此步驟中，您將完成設定您的開發環境。您可以下載並執行提供的 shell 指令碼，以使用範例應用程式的相依性來設定AWS Cloud9 IDE。

設定您的AWS Cloud9環境。

  1. 請在以下位置開啟AWS Cloud9主控台。 https://console.aws.amazon.com/cloud9/

  2. 在 [您的環境] 下，找出名為 QLDB DMV 範例應用程式之環境的介面卡，然後選擇 [開啟 IDE]。基礎 EC2 執行個體啟動時，您的環境可能需要一分鐘的時間才能載入。

    您的AWS Cloud9環境已預先設定好執行教學課程所需的系統相依性。在主控台的 [環境] 導覽窗格中，確認您看到名為的資料夾QLDB DMV Sample Application。AWS Cloud9主控台的下列螢幕擷取畫面顯示 QLDB DMV 範例應用程式環境資料夾窗格。

    AWS Cloud9顯示 QLDB DMV 範例應用程式環境資料夾窗格的主控台。

    如果您沒有看到導覽窗格，請切換主機左側的 [環境] 索引標籤。如果您在窗格中沒有看到任何資料夾，請使用設定圖示啟用「顯示環境根目錄」( Settings icon )。

  3. 在控制台的底部窗格中，您應該會看到一個打開的bash終端窗口。如果沒有看到此選項，請從主機頂端的「視窗」 選單中選擇「新增終端機」。

  4. 接下來，下載並執行安裝程式指令碼以安裝 OpenJDK 8，如果適用的話，請從 Git 儲存庫中檢出適當的分支。在上一個步驟中建立的AWS Cloud9終端機中，執行下列兩個命令，按順序執行下列兩個命令：

    2.x
    aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup-v2.sh .
    sh dmv-setup-v2.sh
    1.x
    aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup.sh .
    sh dmv-setup.sh

    完成設定後，您應可看到在終端中打印下列訊息：

    ** DMV Sample App setup completed , enjoy!! **

  5. 請花點時間瀏覽中的範例應用程式程式碼AWS Cloud9，特別是在下列目錄路徑中：src/main/java/software/amazon/qldb/tutorial。

第 3 部分：執行 QLDB DMV 範例應用程式

在此步驟中，您將學習如何使用執行 Amazon QLDB DMV 範例應用程式任務AWS Cloud9。要運行示例代碼，請返回AWS Cloud9終端機或創建一個新的終端機窗口，就像在第 2 部分：設置 IDE 中所做的那樣。

執行範例應用程式

  1. 在終端機中執行下列命令以切換到專案根目錄：

    cd ~/environment/amazon-qldb-dmv-sample-java

    請確定您正在執行下列目錄路徑中的範例。

    /home/ec2-user/environment/amazon-qldb-dmv-sample-java/

  2. 下面的命令顯示了搖籃語法來運行每個任務。

    ./gradlew run -Dtutorial=Task

    例如，執行下列命令以列出您AWS 帳戶的所有分類帳。

    ./gradlew run -Dtutorial=ListLedgers

  3. 繼續進行步驟 1：建立新分類帳以啟動自學課程並建立分類帳。

  4. (選擇性) 完成教學課程後，如果不再需要資AWS CloudFormation源，請清理您的資源。

    1. 在 https://console.aws.amazon.com/cloudformation 開啟AWS CloudFormation主控台，然後刪除您在第 1 部分：佈建資源中建立的堆疊。

    2. 同時刪除AWS CloudFormation範本為您建立的AWS Cloud9堆疊。