AWS大型主機現代化應用程式定義參考 - AWSMainframe Modernization Services

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

AWS大型主機現代化應用程式定義參考

在AWS大型主機現代化中,您可以在應用程式定義 JSON 檔案中設定已移轉的大型主機應用程式,這是您選擇的執行階段引擎所特有的。應用程式定義包含一般資訊和引擎特定資訊。本主題說明 Blu Age 和 Micro Focus 應用程式定義,並識別所有必要和選用元素。

。一般頭部分。

每個應用程式定義都會從範本版本和來源位置的一般資訊開始。應用程式定義的目前版本為 2.0。雖然版本 1 仍然有效,但它即將被取代。我們建議您在建立或更新應用程式時使用第 2 版。

使用下列結構來指定範本版本和來源位置。

"template-version": "2.0", "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "mainframe-deployment-bucket-aaa", "s3-key-prefix": "v1" } } ]
範本版本

必要。指定應用程式定義檔案的版本。請不要變更此值。目前唯一允許的值是 2.0。以字串指定 template-version

來源位置

指定應用程式在執行階段所需的檔案和其他資源的位置。

屬性

提供來源位置的詳細資訊。每個屬性皆以字串指定。

  • s3-bucket-必需 指定檔案要存放的 Amazon S3 儲存貯體名稱。

  • s3-key-prefix-必需 指定檔案要存放的 Amazon S3 儲存貯體名稱。

    注意

    請確定您指定的是 Amazon S3 儲存貯體名稱,而非儲存貯體 ARN。請勿指定值區中資源的絕對路徑。

定義區段概觀

指定應用程式需要執行之服務、設定、資料及其他一般資源的資源定義。當您更新應用程式定義時,AWS大型主機現代化會比較先前source-locations和目前版本的應用程式定義 JSON 檔案中的和definition清單,來偵測變更。

定義部分是引擎特定的,並可能有所變更。下列各節顯示兩個引擎的引擎特定應用程式定義範例。

藍色時代應用程式定義範例

{ "template-version": "2.0", "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "mainframe-deployment-bucket-aaa", "s3-key-prefix": "v1" } } ], "definition" : { "listeners": [{ "port": 8194, "type": "http" }], "ba-application": { "app-location": "${s3-source}/murachs-v6/" }, "blusam": { "db": { "nb-threads": 8, "batch-size": 10000, "name": "blusam", "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG" }, "redis": { "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com", "port": 6379, "useSsl": true, "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm" } } } }

Blu Age 定義

監聽程式-必要

指定您將用來透過AWS大型主機現代化建立的 Elastic Load Balancing 存取應用程式的連接埠。請使用下列結構:

"listeners": [{ "port": 8194, "type": "http" }],
port

必要。您可以使用任何可用的端口,儘管我們建議使用從 8192 到 8199 的範圍。確保沒有其他監聽器或應用程序在此端口上運行。

類型

必要。目前僅支援 http

藍光時代申請-必填

使用下列結構指定引擎拾取應用程式影像檔的位置。

"ba-application": { "app-location": "${s3-source}/murachs-v6/" },
App-Location

Amazon S3 中存放應用程式映像檔案的特定位置。

Blu Am-必要

使用下列結構指定 BLUSAM 資料庫和 Redis 快取。

"blusam": { "db": { "nb-threads": 8, "batch-size": 10000, "name": "blusam", "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG" }, "redis": { "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com", "port": 6379, "useSsl": true, "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm" } }
db

指定與應用程式搭配使用的資料庫屬性。資料庫必須是 Aurora 資料庫。您可以指定下列屬性:

  • nb-threads-可選。指定 blusam 引擎所依賴的寫入式機制所使用的專用執行緒數目。預設值為 8。

  • batch-size-可選。指定寫入機制用來啟動批次儲存作業的臨界值。臨界值代表將啟動批次儲存作業的已修改記錄數目,以確保已修改的記錄持續存在。觸發程序本身是基於批次大小和一秒的經過時間的組合,以先到達者為準。預設為。

  • name-可選。指定資料庫的名稱。

  • secret-manager-arn-指定包含資料庫登入資料的秘密 Amazon Resource Name (ARN)。如需詳細資訊,請參閱 步驟 3:建立和設定AWS Secrets Manager密碼

redis

指定應用程式用來將暫存資料儲存在中央位置,以提升效能的 Redis 快取屬性。我們建議您同時加密和密碼保護 Redis 快取。

  • hostname-指定 Redis 快取的位置。

  • port-指定 Redis 快取傳送和接收通訊的連接埠 (通常為 6379)。

  • useSsl-指定 Redis 快取是否加密。如果快取未加密,請設定useSsl為 false。

  • secret-manager-arn-指定包含 Redis 快取密碼的 Amazon Resource Name (ARN)。如果 Redis 快取未受密碼保護,請勿指定secret-manager-arn。如需詳細資訊,請參閱 步驟 3:建立和設定AWS Secrets Manager密碼

Amazon Cognito 身分驗證和授權處理常式-選用

AWS大型主機現代化使用 Amazon Cognito 進行已遷移應用程式的身份驗證和授權。使用下列結構指定 Amazon Cognito 身份驗證處理常式。

"cognito-auth-handler": { "user-pool-id": "cognito-idp.Region.amazonaws.com/Region_rvYFnQIxL", "client-id": "58k05jb8grukjjsudm5hhn1v87", "identity-pool-id": "Region:64464b12-0bfb-4dea-ab35-5c22c6c245f6" }
user-pool-id

指定AWS大型主機現代化用來驗證已遷移應用程式使用者的 Amazon Cognito 使用者集區。使用者集區應與AWS大型主機現代化應用程式的相符。AWS 區域AWS 區域

用戶端 ID

指定已驗證使用者可存取的移轉應用程式。

identity-pool-id

指定 Amazon Cognito 身分集區,經驗證的使用者將使用者集區權杖交換為可讓使用者存取AWS大型主機現代化的登入資料。識別集區應符合AWS大型主機現代化應用程式的。AWS 區域AWS 區域

Micro Focus 應用程式定義

下列範例定義區段適用於 Micro Focus 執行階段引擎,且包含必要元素和選用元素。

{ "template-version": "2.0", "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "mainframe-deployment-bucket-aaa", "s3-key-prefix": "v1" } } ], "definition" : { "listeners": [{ "port": 5101, "type": "TN3270" }], "dataset-location": { "db-locations": [{ "name": "Database1", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456" }] }, "cognito-auth-handler": { "user-pool-id": "cognito-idp.us-west-2.amazonaws.com/us-west-2_rvYFnQIxL", "client-id": "58k05jb8grukjjsudm5hhn1v87", "identity-pool-id": "us-west-2:64464b12-0bfb-4dea-ab35-5c22c6c245f6" }, "batch-settings": { "initiators": [{ "classes": ["A", "B"], "description": "initiator...." }], "jcl-file-location": "${s3-source}/batch/jcl" }, "cics-settings": { "binary-file-location": "${s3-source}/cics/binaries", "csd-file-location": "${s3-source}/cics/def", "system-initialization-table": "BNKCICV" }, "xa-resources" : [{ "name": "XASQL", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456", "module": "${s3-source}/xa/ESPGSQLXA64.so" }] } }

Micro Focus 定義

Micro Focus 應用程式定義檔案的定義區段中的內容會因您移轉的大型主機應用程式在執行階段所需的資源而有所不同。

監聽程式-必要

使用下列結構指定監聽器:

"listeners": [{ "port": 5101, "type": "TN3270" }],
port

若為 TN3270,則預設為 5101。對於其他類型的服務接聽程式,連接埠會有所不同。每個接聽程式都應該有一個獨特的連接埠。監聽器不應共享端口。如需詳細資訊,請參閱 Micro Focus 企業伺服器說明文件中的監聽程式控制

類型

指定服務接聽程式的類型。如需詳細資訊,請參閱 Micro Focus 企業伺服器說明文件中的監聽

資料集位置-必填

使用下列結構指定資料集位置。

"dataset-location": { "db-locations": [{ "name": "Database1", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456" }], }
資料庫位置

指定資料庫的詳細資料,或包含已移轉應用程式所匯入之資料集的資料庫。目前,AWS大型主機現代化僅支援來自單一 VSAM 資料庫的資料集。

  • name-指定包含資料集中資料的資料庫執行個體名稱。

  • secret-manager-arn-指定包含資料庫登入資料的秘密 Amazon Resource Name (ARN)。

Amazon Cognito 身分驗證和授權處理常式-選用

AWS大型主機現代化使用 Amazon Cognito 進行已遷移應用程式的身份驗證和授權。使用下列結構指定 Amazon Cognito 身份驗證處理常式。

"cognito-auth-handler": { "user-pool-id": "cognito-idp.Region.amazonaws.com/Region_rvYFnQIxL", "client-id": "58k05jb8grukjjsudm5hhn1v87", "identity-pool-id": "Region:64464b12-0bfb-4dea-ab35-5c22c6c245f6" }
user-pool-id

指定AWS大型主機現代化用來驗證已遷移應用程式使用者的 Amazon Cognito 使用者集區。使用者集區應與AWS大型主機現代化應用程式的相符。AWS 區域AWS 區域

用戶端 ID

指定已驗證使用者可存取的移轉應用程式。

identity-pool-id

指定 Amazon Cognito 身分集區,經驗證的使用者將使用者集區權杖交換為可讓使用者存取AWS大型主機現代化的登入資料。識別集區應符合AWS大型主機現代化應用程式的。AWS 區域AWS 區域

Batch 設定-必要

使用下列結構指定作為應用程式一部分執行的批次工作所需的詳細資料。

"batch-settings": { "initiators": [{ "classes": ["A","B"], "description": "initiator...." }], "jcl-file-location": "${s3-source}/batch/jcls" }
引發劑

指定在遷移的應用程式成功啟動時啟動並繼續執行,直到應用程式停止為止的批次啟動器。您可以針對每個初始器定義一或多個類別。您也可以定義多個初始器。例如:

"batch-settings": { "initiators": [ { "classes": ["A", "B"], "description": "initiator...." }, { "classes": ["C", "D"], "description": "initiator...." } ], "jcl-file-location": "${s3-source}/batch/jcls" }

如需詳細資訊,請參Micro Focus 企業伺服器說明文件中的若要定義批次啟動器或印表機 SEP

  • classes-指定啟動器可以執行的工作類別。

  • description-描述初始器的用途。

  • jcl-file-location-指定移轉應用程式執行的批次工作所需的 JCL 檔案位置。

CICS 設定值-必要

使用下列結構,指定做為應用程式一部分執行之 CICS 交易所需的詳細資訊。

"cics-settings": { "binary-file-location": "${s3-source}/cics/binaries", "csd-file-location": "${s3-source}/cics/def", "system-initialization-table": "BNKCICV" }
binary-file-location

指定 CICS 交易程式檔案的位置。

csd-file-location

指定此應用程式的 CICS 資源定義 (CSD) 檔案的位置。如需詳細資訊,請參閱微焦點企業伺服器文件中的 CICS 資源定義

system-initialization-table

指定移轉的應用程式使用的系統初始化表格 (SIT)。如需詳細資訊,請參閱 Micro Focus 企業伺服器文件中的 CICS 資源定義

XA 資源-必要

使用下列結構指定應用程式所需的 XA 資源所需的詳細資料。

"xa-resources" : [{ "name": "XASQL", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456", "module": "${s3-source}/xa/ESPGSQLXA64.so" }]
name

必要。指定 XA 資源的名稱。

secret-manager-arn

針對包含用於連線至資料庫的登入資料指定秘密的 Amazon Resource Name (ARN)。

模組

指定 RM 交換器模組可執行檔的位置。如需詳細資訊,請參閱 Micro Focus 企業伺服器文件中的規劃和設計 XAR