今天，我们有许多在IBM®Cloud™上运行的云应用程序，其中存储了参与系统（SOE）数据。 另一方面，传统的关键任务数据（例如财务数据）与我们的业务活动和现实世界息息相关。 驻留在公司后端系统（例如IBM i或IBMz®）中的此类数据称为记录系统（SOR）数据。 从云应用程序的角度来看，SOR和SOE之间的数据集成是未来业务成功的关键。 展望未来，已经在互联网上讨论并实现了许多技术要素。
IBM i具有处理业务交易的强大功能，许多开发了这种系统的客户仍在生产环境中运行它。 此外，IBM i还提供了许多Web访问功能，例如通过报告程序生成器（RPG）程序调用标记语言（PCML）调用进行Web服务调用。 您可以轻松地在IBM i上部署自己的Web服务。
在本文中，我们重点介绍从IBM Cloud应用程序调用ILE RPG的代表性状态转移（REST）服务。 这些技术元素的组合为IBM i的未来打开了一扇门。
我们可以使用IBM Cloud等云基础架构快速开发和部署Web或移动本机应用程序。 在IBM Cloud上，中间件应用程序已被部署并可以使用。 在本文中，我们选择了Node-RED作为Web应用程序构建工具。 您可能知道，Node-RED是IBM贡献的开源。 您可以使用带有绘图工具的图形用户界面（GUI）来构建Web应用程序，并最大程度地减少应用程序代码的编写。 它对于当今业务中的快速周期开发和部署非常有效。
服务器端应用程序方法是使用IBM i Web服务和RPG PCML调用的REST服务调用。 IBM i上的集成Web服务服务器可以处理此功能。 要使用此功能，您需要开发可由PCML调用的RPG程序。 无需编写Web服务接口和REST接口代码。 集成的Web服务服务器将自动为您生成代码和定义。 Node-RED本身可以直接在其中调用后端Web服务。 IBM Cloud上的Node-RED应用程序请求REST服务调用，并调用在本地服务器上运行的IBM i RPG程序。 IBM Cloud与本地IBM i服务器之间的连接由IBM Secure Gateway完成，IBM Secure Gateway也由IBM Cloud提供。 在本文中，您可以查看IBM i的真实云示例，并学习可以立即完成的云和IBM i事务集成的设计模式。
如本文前面所述，集成的Web服务服务器具有使用SOAP或REST将ILE程序和服务程序部署为Web服务的功能。 ILE编程语言（例如RPG和COBOL）已在企业应用程序中使用了很多年。 通过使用集成的Web服务服务器，您仍然可以使用熟悉的ILE程序访问企业数据，并同时从5250应用程序和Web应用程序进行访问。 此外，通过将其部署为REST Web服务，您可以更轻松地与IBM Cloud或SOE应用程序交换数据。
在这里，我们将使用学生注册应用程序作为示例，该学生注册应用程序是在使用IBM i的集成Web服务服务器构建REST服务的第3部分中引入的，并指导您将其与IBM Cloud上的Node-RED应用程序连接。
图1显示了示例环境设置的图像。
在指导您执行这些步骤之前，您需要在本地IBM i服务器上运行用ILE RPG编写的学生 信息 应用程序 。
我们将将此应用程序部署为集成的Web服务REST服务。 要从IBM Cloud访问在本地服务器上运行的REST Web服务，您需要配置Secure Gateway。
让我们假设您需要将示例学生 搜索 应用程序部署到IBM Cloud上的Node-RED。 该学生搜索应用程序将使用HTTPS在IBM i上调用基于REST的Web服务。 该应用程序实现对企业数据的REST调用，并具有用于获取输入的用户界面。
以下各节指导您如何：
在集成的Web服务服务器上配置REST Web服务 设置安全网关 从Node-RED应用程序调用集成的Web服务REST应用程序编程接口（API）如前所述，我们将使用ILE RPG程序，该程序在为IBM i第3部分使用集成Web服务服务器构建REST服务中进行了说明。 通过遵循该文章中的步骤，您将能够在IBM i上配置基于REST的Web服务。 在该配置中，我们将添加一些步骤来启用HTTPS调用。 在配置集成Web服务以使用HTTPS之前，您需要使用数字证书管理器（DCM）设置本地证书颁发机构和* SYSTEM证书存储。 要配置，请参见以下参考：
如何在DCM中创建本地证书颁发机构（CA）存储 如何在DCM中创建* SYSTEM存储要将集成的Web服务服务器配置为使用HTTPS连接，请参阅：
如何为安全套接字层（SSL）/传输层安全性（TLS）启用IBM Integrated Web Services（IWS）服务器
在本参考中，建议在配置SSL端口时禁用非SSL端口。 但是在我们的场景中，我们将同时侦听HTTP和HTTPS以验证访问权限。 因此，选择否，是否在禁用非 SSL端口下仍配置SSL端口的同时启用 非SSL端口？ 而不是向导中的是 。
为集成Web服务服务器配置SSL端口后，可以从Web管理for i（也称为HTTPAdmin）的左侧导航视图中“ 工具”部分的“ 显示配置文件”中检查配置。 您可以看到SSL设置将被添加到您的配置文件中，如图2所示。
在下一步中，我们将配置安全网关以连接来自IBM Cloud的本地IBM i服务器。 要启用HTTPS连接，首先需要将在步骤如何为安全套接字层（SSL）/传输层安全性（TLS）启用IBM Integrated Web Services（IWS）服务器中创建的证书导入到Secure Gateway中。
导入证书之前，必须从浏览器下载证书。 在我们的方案中，我们将Mozilla Firefox用于Web浏览器，但是步骤和结果可能会因所使用的Web浏览器而异。
从浏览器中，访问URL https：// < your-iws-system >：< your-iws-https-port > / web / services / students，看到您可以检索JSON格式的学生信息。 右键单击页面，然后单击“ 查看页面信息” 。 在页面信息窗口中，单击安全性选项卡。 在“ 网站身份”下，单击“ 查看 证书” 。 单击“ 证书查看器”窗口的“ 详细信息”选项卡上的“ 导出”按钮。 选择X.509证书（PEM）（* .crt; *。pem）作为文件类型，然后将证书下载到PC。 现在，您可以使用已下载的证书连接HTTPS。现在，我们将在IBM Cloud上设置Secure Gateway。 Secure Gateway是IBM Cloud上的一项服务，它将在IBM Cloud和本地系统之间创建安全的 （作为其服务名称）隧道。 要使用此服务，您还需要将Secure Gateway Client下载到本地系统。
在我们的方案中，我们将在可访问您的本地IBM i服务器的本地PC上配置Secure Gateway Client。 请按照以下步骤设置安全网关。
使用Web浏览器访问IBM Cloud门户。 如果您已经有一个帐户，请单击“ 登录”并使用您的IBM ID登录。 如果这是您第一次使用IBM Cloud，则可以通过单击注册来注册 30天试用版。 登录到IBM Cloud之后，您将看到仪表板打开。 设置安全网关，点击顶部的横幅目录 ，然后点击目录页上的整合类别下的安全网关 。 在“安全网关”页面的底部，单击“ 创建”以创建您自己的服务。 您将从此处设置网关。 在页面的中间， 点击 DD网关 ，你会看到添加网关提示。 输入您的网关服务名称，然后单击添加网关 。 将创建您的网关，并显示Secure Gateway的仪表板。 要设置Secure Gateway Client，请向下滚动至信息中心的底部，单击Clients选项卡，然后单击Connect Client 。 向导会询问您如何连接此新网关。 因为我们使用本地Windows PC作为本地网关客户端，所以选择IBM Installer ，然后在Software Installers列表中单击Windows旁边的下载链接，然后将安装程序包保存在您的工作站中。 通过运行已下载的EXE文件来安装Secure Gateway Client。 在向导中，您可以选择是否要将Secure Gateway Client作为Windows服务运行。 如果您打算将Windows服务器用作Secure Gateway客户端，则建议将其作为Windows服务运行（因为在这种情况下，我们将其安装到本地PC上，并且如果需要Secure Gateway ， 请清除“ 请检查此选项”。客户端作为服务运行并自动重新启动复选框）。 在此向导的下一页上输入您的网关ID和安全令牌。 您可以在下载安装程序的网页上找到此信息。 您可以从该网页复制值并将其粘贴到向导中，如图3所示。在此示例中，访问控制列表（ACL）和日志级别字段保留为空白。 单击下一步 。现在，我们已经成功连接了IBM Cloud上的Secure Gateway服务器和运行在本地PC上的Secure Gateway Client。
最后，我们需要通过Secure Gateway从驻留在IBM Cloud上的Node-RED应用程序访问在本地IBM i平台上运行的集成Web服务API。
执行以下步骤在IBM Cloud上配置Node-RED：
在IBM Cloud仪表板中，单击Catalog 。 在搜索字段中，输入Node-RED。 单击Boilerplates下的Node-RED Starter 。 向下滚动“ 创建Cloud Foundry应用程序”页面，输入您的应用程序名称，并保留其他条目的默认值。 您输入的应用名称将是要访问的默认主机名。 您可以根据需要更改主机名。 然后，点击创建 。 由于应用程序名称在IBM Cloud环境中需要唯一，因此您可能会收到一条错误消息。 如果是这样，请输入其他应用名称，然后再次单击创建 。 创建应用程序后，将配置并启动新的Node-RED应用程序。 等待一会儿或按F5键，直到看到应用程序状态更改为正在运行 。Node-RED有一个称为“流编辑器”的工具，您可以使用该工具将节点从调色板拖到画布上并将它们连接在一起。 在此示例中，我们将使用Node-RED流编辑器创建一个示例应用程序。
单击“ Node-RED应用程序”页面上状态“正在运行”旁边的“ 访问应用程序URL” 。 在网页上的“ Node-RED”上单击“ 转到您的Node-RED流编辑器 ”。 Flow Editor将在您的Web浏览器中启动。 您可以导入和导出以JSON格式编写的Node-RED流。 您可以下载包含示例应用程序流的附件node-red-dw-sample-yohichin-flow.json文件并将其导入。 在Flow Editor的右上角，单击Import- > Clipboard （如图11所示）。请注意，导入的流包括两个大流。 一种是通过访问https：// <your-node-red-app-host-name> .mybluemix.net / welcome显示初始网页。 另一个方法是从初始页面检索学生ID，并将数据通过Secure Gateway传递到IBM i上基于REST的Web服务。 REST Web服务通过使用接收到的ID作为关键字来查询学生信息，并将结果返回到Web页面。
现在您可以访问您的应用程序了。
您需要执行以下步骤来运行示例应用程序：
在Web浏览器中，访问以下内容，并显示在Node-RED中配置的初始页面。https：// < your-node-red-app-host-name > .mybluemix.net / welcome
将<your-node-red-app-host-name>替换为您的应用程序名称或创建Node-RED时指定的主机名。
输入学生ID，例如在这种情况下为826M660CF ，然后单击Submit （如图16所示）。 提交后，使用安全网关将在初始页上输入的学生ID传递到在本地服务器上运行的IBM i上基于REST的Web服务上配置的getByID API。本文介绍了使用集成的Web服务从IBM Cloud应用程序访问ILE RPG的便捷性。 当然，IBM Cloud上的Node-RED应用程序已部署在Internet世界中。 通过使用Secure Gateway，您可以从这些应用程序中轻松检索关键任务，本地IBM i系统数据。 针对这一优势，您应该考虑如何维护数据的安全性。 在本文中，我们使用安全网关和HTTPS协议在本地环境上安全地访问ILE RPG REST Web服务。 HTTPS可以在连接路由中维护数据的机密性。 从安全角度来看，您还应该考虑谁可以使用部署到本地集成Web服务服务器上的ILE RPG REST Web服务并实施访问控制。 要对您的REST Web服务实现此考虑，可以使用IBM API Connect™。 通过使用API Connect，您可以设置安全设置，例如对REST Web服务的身份验证。 与Node-RED应用程序类似，API Connect服务在IBM Cloud上也可用。 您可以通过注册ILE RPG REST Web服务的REST API来使用API Connect。 要将API注册到API Connect，我们通常使用Swagger文件。 Swagger文件是定义API配置的JSON文件。 幸运的是，通过为i 7.1应用HTTP PTF组级别44，对i 7.2应用级别18和对i 7.3或更高版本应用级别5，可以使用为ILE RPG REST Web服务生成Swagger文件的功能。 这是API Connect的一项重大增强，可以使用ILE RPG REST Web服务，因为您可以使用自动生成的Swagger文件将ILE RPG REST Web服务导入API Connect。
本文介绍了Web或移动本机应用程序部署的IBM i和IBM Cloud功能。 我们向您展示了如何设计与Node-RED的流程集成，以及IBM i RPG如何将其功能扩展到云。 IBM i和IBM Cloud继续向这个云时代迈进。
翻译自: https://www.ibm.com/developerworks/ibmi/library/i-ile-rpg-cloud-integration/index.html
相关资源：ILE RPG程序员手册