教程：设置 CI/CD 管道以与 Micro Focus Enterprise Developer 搭配使用

1. 登录 AWS Management Console 并打开 AWS CloudFormation 控制台，网址为 https://console.aws.amazon.com/cloudformation。

2. 使用以下其中一个选项创建堆栈：

   • 选择Create Stack（创建堆栈）。如果您当前有正在运行的堆栈，这将是唯一选项。

   • 在堆栈页面上，选择 创建堆栈。仅当您没有运行堆栈时，才可以看到此选项。

3. 在指定模板页面上：

   • 在准备模板中，选择模板准备就绪。

   • 在指定模板中，选择 Amazon S3 URL 作为模板来源，并根据您的 AWS 区域，输入以下 URL 之一。

     • https://m2-us-east-1.s3.us-east-1.amazonaws.com/cicd/mf/basic-infra.yaml

     • https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/basic-infra.yaml

   • 接受您的设置，选择下一步。

   随后会打开创建堆栈页面。

   

   进行以下更改：

   • 为堆栈名称和网络配置参数提供适当的值。

   • 部署配置中的大多数参数都已适当预先填充，因此您无需对其进行修改。根据您的情况 AWS 区域，将管道 AWS CloudFormation 模板更改为以下 Amazon S3 网址之一。

     • https://m2-us-east-1.s3.amazonaws.com/cicd/mf/pipeline.yaml

     • https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/pipeline.yaml

   • 选择下一步。

   注意

   除非您自己修改了 AWS CloudFormation 模板，否则不要更改默认参数值。

4. 在配置堆栈选项中，选择下一步。

5. 在 “能力” 中，选择我确认 AWS CloudFormation 可能会创建 IAM 资源 AWS CloudFormation 以允许代表您创建 IAM 角色。选择创建堆栈。

   注意

   该堆栈配置需要花费 3 到 5 分钟。

6. 成功创建堆栈后，导航至新配置堆栈的输出部分。在此，您可以找到需要上传大型机代码和相关文件的 Amazon S3 存储桶。

   

1. 将BankDemo 示例应用程序下载到您的本地计算机上。

2. 将 bankdemo.zip 从本地机器上传到创建 CI/CD 管道基本基础设施中创建的 Amazon S3 桶。

3. 下载 config_git.yml。

4. 按如下方式修改 config_git.yml（如有必要）：

   • 添加您自己的目标存储库名称、目标分支和提交消息。

     repository-config:
       target-repository: bankdemo-repo
       target-branch: main
       commit-message: Initial commit for bankdemo-repo main branch

   • 输入您用于接收通知的电子邮件地址。

     pipeline-config:
       # Send pipeline failure notifications to these email addresses
       alert-notifications:
         - myname@mycompany.com
       # Send notifications for manual approval before production deployment to these email addresses
       approval-notifications:
         - myname@mycompany.com 

5. 将包含 CodeCommit 存储库文件夹结构定义config_git.yml的文件上传到中创建的 Amazon S3 存储桶创建 CI/CD 管道基本基础设施。这将调用 Lambda 函数，该函数将自动配置存储库和管道。

   这将使用config_git.yml文件中target-repository定义的名称创建一个 CodeCommit 存储库；例如，bankdemo-repo。

   Lambda 函数还将通过创建 CI/CD 管道堆栈。 AWS CloudFormation AWS CloudFormation 堆栈使用提供的 target-repository 名称作为前缀，后跟一个随机字符串（例如 bankdemo-repo-01234567）。您可以在 AWS 管理控制台中找到 CodeCommit 存储库 URL 和访问已创建管道的 URL。

   

6. 如果 CodeCommit 存储库创建完成，将立即触发 CI/CD 管道以执行完整的 CI/CD。

7. 推送文件后，将自动触发管道，该管道将构建、分阶段部署、运行一些测试并等待手动批准，然后再将其部署到生产环境中。

1. 从 Windows“开始”中，启动 Enterprise Developer。选择“Micro Focus Enterprise Developer”，然后选择“Enterprise Developer for Eclipse”。如果您是初次启动，则可能需要一些时间。

2. 在 Eclipse 启动器中的工作区中，输入 C:\Users\<username>\workspace 然后选择启动。

   注意

   请确保在重新连接到 AppStream 2.0 实例后选择相同的位置。工作区选择不是永久性的。

3. 在欢迎中，选择打开 COBOL 透视图。这仅在新工作区首次使用时显示。

1. 选择窗口 / 透视图 / 打开透视图 / 其他... / Git。

2. 选择克隆 Git 存储库。

3. 在克隆 Git 存储库中，输入以下信息：

   • 在位置 URI 中，输入 CodeCommit存储库的 HTTPS 网址。

     注意

     在 AWS 管理控制台中复制 CodeCommit 存储库的克隆 URL HTTPS 并将其粘贴到此处。URI 将分为主机和存储库路径。

   • 在 “身份验证用户和密码” 中输入用户 CodeCommit 存储库凭据，然后选择 “存储在安全存储中”。

4. 在分支选择中，选择主分支，然后选择下一步。

5. 在本地目标的目录中，输入 C:\Users\<username>\workspace 并选择完成。

   Git 存储库视图中显示 BANKDEMO [main] 时，即表示克隆过程完成。

1. 更改为 COBOL 透视图。

2. 在项目 中，禁用自动构建。

3. 在文件中，选择新建，然后选择大型机 COBOL 项目。

4. 在新建大型机 COBOL 项目中，输入以下信息：

   • 在项目名称中，输入 BankDemo。

   • 选择 Micro Focus 模板 [64 位]。

   • 选择完成。

5. 在 COBOL 资源管理器中，展开新 BankDemo 项目。

   注意

   [BANKDEMO main]方括号中表示该项目已与本地 BankDemo CodeCommit 存储库相连。

6. 如果树视图不显示 COBOL 程序、Copybook、BMS 源代码和 JCL 文件的条目，请从项目上下文菜单中选择 “刷新”。 BankDemo

7. 从快捷 BankDemo 菜单中选择 “属性”/“Micro Focus”/“项目设置”/“COBOL”：

   • 选择字符集 – ASCII。

   • 选择应用，然后选择确定。

8. 如果 BMS 和 COBOL 源的构建没有立即启动，在项目菜单中检查是否已启用自动构建选项。

   构建输出将显示在控制台视图中，应在几分钟后完成，并显示消息 BUILD SUCCESSFUL 和 Build finished with no errors。

   现在， BankDemo 应用程序应已编译并准备好在本地执行。

1. 在 COBOL 资源管理器中，展开 BANKDEMO / config。

2. 在编辑器中，打开 BANKDEMO_ED.json。

3. 找到字符串 ED_Home= 并更改路径以指向 Enterprise Developer 项目，如下所示：D:\\<username>\\workspace\\BANKDEMO。请注意在路径定义中使用双斜杠 (\\)。

4. 保存并关闭文件。

5. 选择服务器资源管理器。

6. 从默认上下文菜单中，选择打开管理页面。随后，Micro Focus Enterprise Server 管理页面在默认浏览器中打开。

7. 仅适用于 AppStream 2.0 会话，请进行以下更改，以便保留本地企业服务器区域供本地测试使用：

   • 在目录服务器 / 默认中，选择属性 / 配置。

   • 将存储库位置替换为 D:\<username>\My Files\Home Folder\MFDS。

   注意

   每次与 AppStream 2.0 实例建立新连接后，您都必须完成步骤 5-8。

8. 在目录服务器 / 默认中，选择导入，然后完成以下步骤：

   • 在步骤 1：导入类型中，选择 JSON，然后选择下一步。

   • 在步骤 2：上传中，单击以在蓝色方块中上传文件。

   • 在选择要上传的文件中，输入：

     • 文件名：D:\<username>\workspace\BANKDEMO\config\BANKDEMO_ED.json。

     • 选择打开。

   • 选择下一步。

   • 在步骤 3 中：区域中，取消选中从端点清除端口。

   • 选择下一步。

   • 在步骤 4：导入中，选择导入。

   • 选择完成。

   此时，列表中将显示一个新的服务器名称 BANKDEMO。

1. 选择Enterprise Developer。

2. 在服务器资源管理器中，选择默认，然后从上下文菜单中选择刷新。

   此时，服务器列表中也应该显示 BANKDEMO。

3. 选择 BANKDEMO。

4. 从上下文菜单中，选择与项目关联，然后选择 BANKDEMO。

5. 从上下文菜单中，选择启动。

   控制台视图中应显示服务器启动的日志。

   如果显示消息 BANKDEMO CASSI5030I PLTPI Phase 2 List(PI) Processing Completed，则服务器已准备好用于测试 CICS BANKDEMO 应用程序。

1. 从 Windows“开始”中，启动 Micro Focus Rumba+ Desktop / Rumba+ Desktop。

2. 在欢迎中，选择创建新会话 / 大型机显示。

3. 在大型机显示中，选择连接 / 配置。

4. 在会话配置中，选择连接 / TN3270。

5. 在主机名 / 地址中，选择插入并输入 IP 地址 127.0.0.1。

6. 在 Telnet 端口中，输入端口 6000。

7. 选择 应用。

8. 选择连接。

   CICS 欢迎屏幕显示的屏幕带有第 1 行消息：This is the Micro Focus MFE CICS region BANKDEMO。

9. 按 Ctrl+Shift+Z 可清除屏幕。

1. 在空白屏幕中，输入 BANK。

2. 在屏幕 BANK10 中，在用户 ID...：输入字段中，输入 guest 并按 Enter。

3. 在屏幕 BANK20 中，在计算贷款成本之前的输入字段中，输入 /（正斜杠），然后按 Enter。

4. 在屏幕 BANK70 中：

   • 在希望借贷的金额...：中，输入 10000。

   • 在利率为...：中，输入 5.0。

   • 在借期（月）为...：中，输入 10。

   • 按 Enter。

   此时应显示以下结果：

   Resulting monthly payment.............:   $1023.06

   Enterprise Developer 中的 BANKDEMO 应用程序设置到此完成。

1. 在服务器资源管理器中，选择默认，然后从上下文菜单中选择刷新。

2. 选择 BANKDEMO。

3. 从上下文菜单中，选择停止。

   控制台视图中应显示服务器停止的日志。

   如果显示消息 Server: BANKDEMO stopped successfully，即表示服务器已成功关闭。

可从 Enterprise Analyzer 导出 Micro Focus Enterprise Analyzer 中定义的分析规则，并将其导入到 Enterprise Developer 中，以便在 Enterprise Developer 项目中跨源运行相同的分析规则。

1. 打开 Window/Preferences/Micro Focus/COBOL/Code Analysis/Rules。

2. 选择编辑... 并输入文件夹名称 D:\PhotonUser\My Files\Home Folder\AnalysisRules（其中包含规则文件 Loan+Calculation+Update.General-1.xml）。

3. 选择完成。

4. 选择应用，然后选择关闭。

5. 从 BANKDEMO 项目上下文菜单中，选择代码分析。

   您会看到贷款计算更新条目。

借助新的分析规则，我们可以在表达式、语句和变量中识别出与搜索模式 *PAYMENT*、*LOAN* 和 *RATE* 相匹配的 COBOL 程序和代码行。这将有助于浏览代码并确定所需的代码更改。

1. 从 BANKDEMO 项目上下文菜单中，选择代码分析/贷款计算更新。

   该操作将运行搜索规则，并在名为代码分析的新选项卡中列出结果。当右下角的绿色进度条消失时，即表示分析运行完成。

   代码分析选项卡应显示 BBANK20P.CBL、BBANK70P.CBL 和 SBANK70P.CBL 的扩展列表，每个列表都列出了与搜索模式匹配的语句、表达式和变量。

   从 BBANK20P.CBL 的结果来看，只移动了与搜索模式匹配的文字。因此，可以忽略此程序。

2. 在选项卡菜单栏中，选择 - 图标，可全部折叠。

3. 双击，按任意顺序展开 SBANK70P.CBL 并选择任意行，查看如何打开源代码并突出显示源代码中选定的行。您还将看到，所有已识别的源行都已标记。

首先，我们更改 BMS 映射 MBANK70.BMS、屏幕处理程序 SBANK70P.CBL 和 copybook CBANKDAT.CPY，以便显示新字段。为避免在本练习中进行不必要的编码，D:\PhotonUser\My Files\Home Folder\BANKDEMO-exercise\Exercise01 文件夹中提供了修改后的源模块。通常，开发人员会使用代码分析结果来浏览和修改源代码。如果您有时间并想手动进行更改，请使用 *MBANK70.BMS 和 SBANK70P.CBL 中的手动更改（可选）* 中提供的信息进行手动更改。

要进行快速更改，请复制以下文件：

1. ..\BANKDEMO-exercise\Exercis01\screens\MBANK70.BMS 到 D:\PhotonUser\workspace\bankdemo\source\screens。

2. .\BANKDEMO-exercise\Exercis01\cobol\SBANK70P.CBL 到 D:\PhotonUser\workspace\bankdemo\source\cobol。

3. ..\BANKDEMO-exercise\Exercis01\copybook\CBANKDAT.CPY 到 D:\PhotonUser\workspace\bankdemo\source\copybook。

4. 为确保受更改影响的所有程序都进行编译，请选择 项目/清理.../清理所有项目。

要手动更改 MBANK70.BMS 和 SBANK70P.CBL，请完成以下步骤：

• 要手动更改 BMS MBANK70.BMS 源，请在 PAYMENT 字段后面添加：

  • TXT09（具有与 TXT08 相同的属性，INITIAL 值为“贷款总额”）

  • TOTAL（与 PAYMENT 具有相同属性）

测试更改

要测试这些更改，请重复以下各节中的步骤：

1. 从 Enterprise Developer 启动 BANKDEMO 服务器

2. 启动 Rumba 3270 终端

3. 运行 BankDemo交易

   此外，您此时还应该看到文本 Total Loan Amount.....................:。

4. 从 Enterprise Developer 停止 BANKDEMO 服务器

在第二步中，我们更改 BBANK70P.CBL 并添加贷款总额的计算。D:\PhotonUser\My Files\Home Folder\BANKDEMO-exercise\Exercise01 文件夹中提供经过必要更改的可用源。如果您有时间并想进行手动更改，请使用*BBANK70P .CBL 中的手动更改（可选）* 中提供的信息进行手动更改。

要进行快速更改，请复制以下文件：

• ..\BANKDEMO-exercise\Exercis01\source\cobol\BBANK70P.CBL 到 D:\PhotonUser\workspace\bankdemo\source\cobol。

要手动更改 BBANK70P.CBL，请完成以下步骤：

• 使用代码分析结果来确定所需的更改。

测试更改

要测试这些更改，请重复以下各节中的步骤：

1. 从 Enterprise Developer 启动 BANKDEMO 服务器

2. 启动 Rumba 3270 终端

3. 运行 BankDemo交易

   此外，您此时还应该看到文本 Total Loan Amount.....................: $10230.60。

4. 从 Enterprise Developer 停止 BANKDEMO 服务器

将更改提交到中央 CodeCommit 存储库并触发 CI/CD 管道以构建、测试和部署更改。

1. 从 BANKDEMO 项目的上下文菜单中，选择团队/提交。

2. 在 Git 暂存选项卡中，输入以下提交消息：Added Total Amount Calculation。

3. 选择提交并推送...。

4. 打开 CodePipeline 控制台并检查管道执行的状态。

   注意

   如果您在使用 Enterprise Developer 或团队功能“提交”或“推送”时遇到任何问题，请使用 Git Bash 命令行界面。

首先，我们将贷款计算例程提取到 COBOL部分中。需要执行此步骤才能在下一步骤中将代码提取到独立的 COBOL 程序中。

1. 在 COBOL 编辑器中打开 BBANK70P.CBL。

2. 在编辑器中，从上下文菜单中选择代码分析/贷款计算更新。这只会扫描当前来源中是否存在分析规则中定义的模式。

3. 在代码分析选项卡的结果中，找到第一条算术语句 DIVIDE WS-LOAN-INTEREST BY 12。

4. 双击该语句可在编辑器中导航到源代码行。这是贷款计算例程的第一个语句。

5. 标记贷款计算例程的以下代码块，以便将提取到某个部分。

   DIVIDE WS-LOAN-INTEREST BY 12
                GIVING WS-LOAN-INTEREST ROUNDED.
              COMPUTE WS-LOAN-MONTHLY-PAYMENT ROUNDED =
                ((WS-LOAN-INTEREST * ((1 + WS-LOAN-INTEREST)
                    ** WS-LOAN-TERM)) /
                (((1 + WS-LOAN-INTEREST) * WS-LOAN-TERM) - 1 ))
                    * WS-LOAN-PRINCIPAL.
   EXER01     COMPUTE WS-LOAN-TOTAL-PAYMENT =
   EXER01             (WS-LOAN-MONTHLY-PAYMENT * WS-LOAN-TERM). 

6. 从编辑器的上下文菜单中，选择重构/提取到部分...。

7. 输入新部分名称：LOAN-CALCULATION。

8. 选择“确定”。

   标记的代码块现已提取到新的 LOAN-CALCULATION 部分，并且该代码块已替换为 PERFROM LOAN-CALCULATION 语句。

测试更改

要测试这些更改，请重复以下各节中所述的步骤：

1. 从 Enterprise Developer 启动 BANKDEMO 服务器

2. 启动 Rumba 3270 终端

3. 运行 BankDemo交易

   此外，您此时还应该看到文本 Total Loan Amount.....................: $10230.60。

4. 从 Enterprise Developer 停止 BANKDEMO 服务器

   注意

   如果要避免上述步骤将代码块提取到某个部分，则可以将步骤 1 中的已修改源从 ..\BANKDEMO-exercise\Exercis02\Step1\cobol\BBANK70P.CBL 复制到 D:\PhotonUser\workspace\bankdemo\source\cobol。

在步骤 2 中，LOAN-CALCULATION 部分中的代码块将被提取到独立程序中，原始代码将替换为用于调用新子程序的代码。

1. 在编辑器中打开 BBANK70P.CBL，找到在步骤 1 中创建的新 PERFORM LOAN-CALCULATION 语句。

2. 将光标置于部分名称内。它将被标记为灰色。

3. 从上下文菜单中，选择重构->提取部分/段落到程序...。

4. 在提取部分/段落到程序中，输入新文件名：LOANCALC.CBL。

5. 选择 确定。

   新的 LOANCALC.CBL 程序将在编辑器中打开。

6. 向下滚动并查看正在为调用接口提取和生成的代码。

7. 在编辑器中选择 BBANK70P.CBL，然后转至 LOAN-CALCULATION SECTION。查看正在生成的用于调用新子程序 LOANCALC.CBL 的代码。

   注意

   CALL 语句正在使用 DFHEIBLK 和 DFHCOMMAREA 调用带 CICS 控制块的 LOANCALC。由于我们希望将新的 LOANCALC.CBL 子程序作为非 CICS 程序调用，因此必须通过注释或删除从调用中移除 DFHEIBLK 和 DFHCOMMAREA。

测试更改

要测试这些更改，请重复以下各节中所述的步骤：

1. 从 Enterprise Developer 启动 BANKDEMO 服务器

2. 启动 Rumba 3270 终端

3. 运行 BankDemo交易

   此外，您此时还应该看到文本 Total Loan Amount.....................: $10230.60。

4. 从 Enterprise Developer 停止 BANKDEMO 服务器

   注意

   如果要避免上述步骤将代码块提取到某个部分，则可以将步骤 1 中的已修改源从 ..\BANKDEMO-exercise\Exercis02\Step2\cobol\BBANK70P.CBL 和 LOANCALC.CBL 复制到 D:\PhotonUser\workspace\bankdemo\source\cobol。

将更改提交到中央存储库， CodeCommit 然后触发 CI/CD Pipeline 来构建、测试和部署更改。

1. 从 BANKDEMO 项目的上下文菜单中，选择团队/提交。

2. 在 Git 暂存选项卡中

   • 在未暂存的阶段 LOANCALC.CBL 和 LOANCALC.CBL.mfdirset 中，添加内容。

   • 输入提交消息：Added Total Amount Calculation。

3. 选择提交并推送...。

4. 打开 CodePipeline 控制台并检查管道执行的状态。

   注意

   如果您在使用 Enterprise Developer 或团队功能“提交”或“推送”时遇到任何问题，请使用 Git Bash 命令行界面。