教程:在 AppStream 2.0 上使用AWS藍光時代開發人員 - AWS Mainframe Modernization

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

教程:在 AppStream 2.0 上使用AWS藍光時代開發人員

本教程向您展示如何訪問 AppStream 2.0 上的 AWS Blu Age Developer 並將其與示例應用程序一起使用,以便您可以嘗試使用這些功能。完成本教學課程後,您可以對自己的應用程式使用相同的步驟。

步驟 1:建立資料庫

在此步驟中,您可以使用 Amazon RDS 建立受管 PostgreSQL 資料庫,示範應用程式用來儲存組態資訊。

  1. 開啟 Amazon RDS 主控台。

  2. 選擇資料庫 > 建立資料庫

  3. 選擇 [標準建立] > [PostgreSQL],保留預設版本,然後選擇 [免費方案]。

  4. 選擇資料庫執行個體識別碼。

  5. 在「身份證明設定」 中選擇「管理主要認證」AWS Secrets Manager。如需詳細資訊,請參閱《Amazon RDS 使用者指南》中的使用 Amazon RDS 和 AWS Secrets Manager 進行密碼管理

  6. 請確定 VPC 與您用於 AppStream 2.0 執行個體的 VPC 相同。您可以向管理員詢問此值。

  7. 對於 VPC 安全性群組,請選擇新建

  8. 保持 [公用存取] 設定為 []。

  9. 保留所有其他預設值。檢閱這些值。

  10. 選擇 Create database (建立資料庫)。

若要讓資料庫伺服器可從您的執行個體存取,請在 Amazon RDS 中選取資料庫伺服器。在 [連線與安全性] 底下,選擇資料庫伺服器的 VPC 安全性群組。此安全性群組先前是為您建立的,而且應具有類似於 RDS 建立的管理主控台中的說明。選擇「動作」>「編輯輸入規則」,選擇「新增規則」,然後建立 PostgreSQL 類型的規則。對於規則來源,請使用安全性群組預設值您可以開始在「來源」欄位中輸入來源名稱,然後接受建議的識別碼。最後,選擇「儲存規則」。

步驟 2:存取環境

在此步驟中,您可以在 AppStream 2.0 上訪問AWS藍光時代開發環境。

  1. 請聯絡您的管理員,以取得存取 AppStream 2.0 執行個體的正確方法。如需有關可能用戶端和組態的一般資訊,請參閱《Amazon AppStream 2.0 管理指南》中的 AppStream 2.0 存取方法和用戶端。考慮使用原生用戶端以獲得最佳體驗。

  2. 在 AppStream 2.0 中選擇桌面

步驟 3:設定執行階段

在此步驟中,您將設定AWS藍光時代執行階段。您必須在第一次啟動時設定執行階段,如果您收到執行階段升級的通知,請再次設定執行階段 此步驟會填入您的.m2資料夾。

  1. 從功能表列選擇 [應用程式],然後選擇 [終端機]。

  2. 輸入以下命令:

    ~/_install-velocity-runtime.sh

第 4 步:啟動日食 IDE

在此步驟中,您可以啟動 Eclipse IDE 並選擇要在其中創建工作區的位置。

  1. 在 AppStream 2.0 中,選擇工具欄上的啟動應用程序圖標,然後選擇 Eclipse JEE

    
      在 AppStream 2.0 中的工具欄上啟動應用程序圖標。已選取「日蝕 JEE」。
  2. 啟動器開啟後,輸入您要建立工作區的位置,然後選擇 [啟動]。

    
      AppStream2.0 中的藍光時代日食 IDE 發射器。已選取「工作區」。

或者,您可以從命令行啟動 Eclipse,如下所示:

~/eclipse &

第 5 步:設置一個 Maven 項目

在此步驟中,您會匯入行星示範應用程式的 Maven 專案。

  1. PlanetsDemo-pom.zip 上傳至您的個人專屬資料夾。您可以使用本機客戶端「我的文件」功能來執行此操作。

  2. 使用指unzip令行工具解壓縮檔案。

  3. 在解壓縮的文件夾中導航,然後在文本編輯器中打開項目pom.xml的根目錄。

  4. 編輯gapwalk.version屬性,使其符合已安裝的 AWS Blu Age 執行階段。

    如果您不確定安裝的版本,請在終端機中發出以下命令:

    cat ~/runtime-version.txt

    此指令會列印目前可用的執行階段版本,例如3.1.0-b3257-dev

    注意

    請勿在中包含-dev尾碼gapwalk.version。例如,一個有效的值將是<gapwalk.version>3.1.0-b3257</gapwalk.version>

  5. 在 Eclipse 中,選擇檔案,然後選擇匯入。在「入」對話方塊視窗中,展開 Maven 並選擇「現有的 Maven 專案」。選擇 下一步

  6. 導入 Maven 項目中,提供提取文件的位置,然後選擇完成

    您可以放心地忽略以下彈出窗口。Maven 下載的本地副本node.js來構建項目的角度(*-網絡)部分:

    
      關於缺少 node.js 的警告消息。

    等到構建結束。您可以在進度視圖中關注構建。

  7. 在 Eclipse 中,選取專案並選擇執行身分。然後選擇安裝。Maven 安裝成功後,它會在下PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war面創建war文件。

步驟 6:設定 Tomcat 伺服器

在此步驟中,您可以設定 Tomcat 伺服器,您可以在其中部署並啟動已編譯的應用程式。

  1. 在 Eclipse 中,選擇「視窗 > 顯示檢視 > 伺服器」以顯示「伺服器」檢視:

    
      AWS已選取伺服器檢視的藍光時代日食。
  2. 選擇沒有可用的伺服器。點擊此鏈接創建一個新的服務器... 。[新增伺服器] 精靈隨即出現 在精靈的 [選取伺服器類型] 欄位中,輸入 tomcat v9,然後選擇 [T omcat v 9.0 伺服器]。然後選擇 Next (下一步)。

    
      [新增伺服器] 對話方塊。選擇了服務器 V9.0。
  3. 選擇瀏覽,然後選擇位於主文件夾根目錄的 tomcat 文件夾。將 JRE 保留為其預設值,然後選擇「完成」。

    在工作區中建立「伺服器」專案,而 Tomcat v9.0 伺服器現在可在「服器」檢視中使用。這是編譯後的應用程序將被部署和啟動的地方:

    
      AWS藍光時代日食服務器選項卡,列出了新的 Tomcat 服務器。

第 7 步:部署到湯姆貓

在此步驟中,您將行星演示應用程序部署到 Tomcat 服務器,以便您可以運行該應用程序。

  1. 選擇該PlanetsDemo-web文件,然後選擇運行方式 > Maven 安裝PlanetsDemo-web再次選取並選擇「重新整理」,以確保 nPM 編譯的前端已正確編譯為 .war 並被 Eclipse 注意到。

  2. PlanetsDemo-runtime.zip 上傳至執行個體,然後在可存取的位置解壓縮檔案。這可確保示範應用程式可以存取所需的設定資料夾和檔案。

  3. PlanetsDemo-runtime/tomcat-config將的內容複製到您為 Tomcat 伺服器建立的Servers/Tomcat v9.0...子資料夾中:

    
      AWS藍光時代日食 Tomcat v9.0 子文件夾及其包含的文件。
  4. 在「伺tomcat v9.0服器」檢視中開啟伺服器項目。伺服器屬性編輯器隨即出現:

    
      伺服器屬性編輯器。即會選取「概觀」頁籤。
  5. 在 [概觀] 索引標籤中,將 [開始] 的 [逾時] 值增加到 450 秒,對於 [停止],將 [逾時] 值增加為 150 秒,如下所示:

    
      啟動逾時值設定為 450 秒。停止逾時值設定為 150 秒。
  6. 選擇 [開啟啟動設定]。這時系統顯示嚮導。在精靈中,導覽至「參數」資料夾,並針對「工作目錄」選擇「其他」。選擇文件系統,然後導航到先前解壓縮的文件PlanetsDemo-runtime夾。此資料夾應包含名為 config 的直接子資料夾。

    
      編輯模型組態對話方塊,其中包含在「其他」欄位中指定的工作目錄。
  7. 選擇伺服器屬性編輯器的「模組」索引標籤,然後進行下列變更:

    • 選擇添加 Web 模塊並添加PlanetsDemo-service

    • 選擇「新增外部 Web 模組」。這時系統顯示「添加 Web 模塊」對話框。進行下列變更:

      • 在「文件庫」中,選擇「瀏覽」並導覽至 ~/webapps/gapwalk-application...war

      • 路徑中,輸入/gapwalk-application

    • 選擇 OK (確定)。

    • 再次選擇「新增外部 Web 模組」,然後進行下列變更:

      • 在「文件庫」中,輸入前端 .war (在中) 的路徑 PlanetsDemo-web/target

      • 對於「路徑」,輸入 /demo

    • 選擇 OK (確定)。

    • 儲存編輯器所做的修改 (Ctrl + S)。

編輯器內容現在應該類似於以下內容。


    Tomcat 伺服器內容的 [Web 模組] 索引標籤,其中包含列出的模組。

步驟 8:建立 JICS 資料庫

在此步驟中,您會連線至您在中建立的資料庫步驟 1:建立資料庫

  1. 從 AppStream 2.0 實例中,在終端機中發出以下命令以啟動pgAdmin

    ./pgadmin-start.sh
  2. 選擇一個電子郵件地址和密碼作為登錄標識符。記下提供的網址(通常為 http://127.0.0.1:5050)。在實例中啟動 Google Chrome 瀏覽器,將網址複製並粘貼到瀏覽器中,然後使用您的標識符登錄。

    
      「管理員登入」對話方塊。
  3. 登入之後,請選擇「新增伺服器」,然後輸入先前建立之資料庫的連線資訊,如下所示。

    
      PgAdmin 註冊伺服器對話方塊。已選取「連線」標籤。
  4. 當您連線到資料庫伺服器時,請使用「物件」>「建立」>「資料庫」,並建立名為 jics 的新資料庫。

  5. 編輯示範應用程式使用的資料庫連線資訊。此資訊在中定義PlanetsDemo-runtime/config/application-main.yml。搜尋項jicsDs目。若要在 Amazon RDS 主控台password中擷取username和的值,請導覽至資料庫。在 Configuration (組態) 索引標籤的 Master Credentials ARN (主要憑證 ARN) 中,選擇 Manage in Secrets Manager (在 Secrets Manager 中管理)。然後,在密碼管理員主控台中,選擇 [擷取密碼值]。

步驟 9:啟動並測試應用程式

在此步驟中,您將啟動 Tomcat 伺服器和示範應用程式,以便您可以對其進行測試。

  1. 若要啟動 Tomcat 伺服器和先前部署的應用程式,請在 [伺服器] 檢視中選取伺服器項目,然後選擇 [啟動]。隨即出現顯示啟動記錄的主控台。

  2. 在「伺服器」檢視中檢查伺服器狀態,或等待主控台中的 [xxx] 毫秒內「伺服器啟動」訊息。服務器啟動後,檢查間隙行程應用程序是否正確部署。要做到這一點,訪問 http://localhost:8080/gapwalk-application 網址在谷歌瀏覽器瀏覽器。您應該會看到以下內容。

    
      顯示 jics 應用程式正在執行的確認訊息。
  3. 從谷歌瀏覽器訪問已部署的應用程序前端 http://localhost:8080/demo. 下列 [交易啟動器] 頁面應該會出現。

    
      JICS 交易啟動器頁面。
  4. 若要啟動應用程式交易,請PINQ在輸入欄位中輸入,然後選擇「執行」(或按 Enter)。

    應該會出現示範應用程式畫面。

    
      插入模式下的PlanetsDemo應用程序屏幕。
  5. 在對應的欄位中輸入行星名稱,然後按 Enter。

    
      在行星名稱欄位中輸入了地球的PlanetsDemo應用程式畫面。

步驟 10:調試應用程序

在此步驟中,您可以使用標準的 Eclipse 偵錯功能進行測試。當您使用現代化的應用程式時,就可以使用這些功能。

  1. 若要開啟主要服務類別,請按住 Ctrl + 轉移 + T。然後輸入PlanetsinqProcessImpl

    
      PlanetsinqProcessImpl輸入的「Eclipse 開啟類型」對話方塊視窗。
  2. 導航到該searchPlanet方法,並在那裡放置一個斷點。

  3. 選取伺服器名稱,然後選取在偵錯中重新啟動

  4. 重複前面的步驟。也就是說,訪問應用程序,輸入行星名稱,然後按 Enter 鍵。

    Eclipse 會在searchPlanet方法中停止應用程序。現在您可以檢查它。

清除資源

如果您不再需要為此教學課程建立的資源,請刪除這些資源,以免產生額外費用。完成下列步驟: