本文档目的是帮助您初步了解部署在BTP上应用的基本运维方式,阅读时间约为30分钟。
本练习的使用前提是完成 CAP for Nodejs部署练习 – SAP Community
如果您对BTP感兴趣,BTP个人精选内容目录 | SAP Blogs 可能有更多你需要的内容
本文档为CAP for Nodejs部署练习 | SAP Blogs 的后续,本练习会展示在部署后如何进行运维
本文档包括以下部分:
1.部署完成后平台发生的变化
2.容器事件及应用日志查看
3.应用对应的身份配置
4.如何添加监控措施
1.部署完成后平台发生的变化
完成部署后,首先,在子账户–空间–本次部署的目标空间内的应用程序列表里,会多出三个应用
其中,cpapp-db-deployer应用只会在部署时启动,用于部署CAP程序内的HANA Cloud内容,cpapp-srv是我们的后端服务,approuter是装载了我们前端内容的服务,如果你同时使用了html5repo装载前端代码,则可以在子账户-HTML5应用程序内找到nsrisks2应用
在左侧从应用程序子菜单切换到服务–实例子菜单后,可以看到四个服务实例,其中cpapp-auth代表了身份中心,cpapp-db代表了嵌入到HANA Cloud的hdi-shared容器(详细含义请参考其他资料),
cpapp-destination代表了在本空间内的destination服务,点击该服务实例名称,即可进入服务实例主页,首先默认进入 引用应用 子菜单,可以看到哪些应用可以访问该服务实例;左菜单选择 目标,可以看到5个destination,分别来自mta.yaml 中module approuter properties内的srv-destination,和resources cpapp-destination内定义的cpapp-srv-api和ui5,以及系统自动生成的连接到auth和html5repo的两个destination
回到空间主页,左菜单的 路由,可以看到两个路由,意思就是对应两个应用程序的两个公网URL
左菜单的 空间成员 和子账户权限略有不同,这里的 空间成员 指的是Cloud Foundry内的org-space权限,有这些权限才可以配置/部署应用
2.容器事件及应用日志查看
部署完成后,在子账户-空间-应用主页内,可以查看到应用对应的公网url,还可以看到 +实例 的按钮,这里指的是实际运行应用的容器数,可以通过点击增加数量,新增的每个实例会占用与旧实例一致的内存量
在左菜单的事件选项内,可以看到容器发生事件的日志记录,此处无需配置,对接的是容器底层的运行日志
在左菜单的日志选项内,暂时看不到任何内容,点击左上角的 打开Kibana 仪表盘,也不会有内容,因为logging服务没有被创建,即使被创建过了也需要和该应用绑定,并在应用内写日志到logging服务
3.应用对应的身份配置
在应用主页的 左菜单-安全性下,可以看到 范围和角色模板,其内容都来自xs-security.json内的定义
此时回到 子账户-安全性-角色集合,可以看到RiskManager-dev角色集合,这里的内容是来自mta.yaml resources cpapp-auth内的。
scope即每一个代表最细粒度的身份权限,不能再分
Role template会采用一个或几个scope来确定一个模板
Role就是role template的一个实例,一般默认会根据每一个role template产生一个role
Role collection就是最后直接分配给不同用户的权限模板,可以包含一个或几个role
Scope和Role template是1:n(n>=1)
Role template和Role是1:1(没有attribute时)
Role和Role Collection是n:1(n>=1;通常n>1)
Attributes代表额外的属性,如果Role template没有任何Attributes,则相应的角色与Role template相同
如果Role template具有一个或多个Attributes,则必须基于Role template创建角色并提供Attributes值
这也就是为什么role 和 role template可以不是1:1的关系
4.如何添加监控措施
看过了主要的变化,接下来让我们练习如何添加监控信息
首先需要为子账户启用一个application-logs服务实例,然后要将应用与服务实例相连,可以使用命令行或者cockpit来操作
简单来说,在应用部署好之后,进入子账户-目标空间后,在左菜单的 实例列表页面内点击右上角的创建,
选择application-logs服务,选择lite计划,填入实例名称后即可 点击 下一步-创建
创建完成后还是在空间内的实例列表页面点击新实例来打开右菜单,在右菜单的 绑定的应用程序 处点击创建,选择目标应用后确认创建
最后回到应用程序列表页面,点击目标应用进入应用主页后点击左菜单的日志-打开Kibana仪表盘,即可看到该应用的日志了
但更推荐直接在mta.yaml内定义该服务实例以及绑定:
在resources部分添加:
– name: cf-logging
type: org.cloudfoundry.managed-service
parameters:
service: application-logs
service-plan: lite
然后在需要监控的应用的require部分添加依赖即可,
我这里是在cpapp-srv这个module里的requires添加了一条 – name: cf-logging
然后是在应用内添加监控:
进入srv/risk-service.js
第二行添加:
const generalLOG = cds.log(‘generalLOG’)
然后在srv/risk-service.js内为read risks注册的事件内(或者你想记录日志的地方)添加以下代码
generalLOG.info (‘generalLOG’, test)
最后重新打包部署,进入risks应用页面执行几次Go来查询数据,以触发read risks事件及其内的日志记录动作
然后回到 子账户-空间-应用列表-应用主页-左菜单日志-打开kibana仪表盘 以查看新出现的日志内容
Nodejs请参考:
About | CF Node.js Logging Support
Java请参考:
Home · SAP/cf-java-logging-support Wiki · GitHub
关于本文内容有任何问题或见解,欢迎在评论区留下你的想法,如果需要帮助,也可以直接联系到我 arthuryang1996@foxmail.com,感谢你的时间
本文档目的是帮助您初步了解部署在BTP上应用的基本运维方式,阅读时间约为30分钟。 本练习的使用前提是完成 CAP for Nodejs部署练习 – SAP Community 如果您对BTP感兴趣,BTP个人精选内容目录 | SAP Blogs 可能有更多你需要的内容 本文档为CAP for Nodejs部署练习 | SAP Blogs 的后续,本练习会展示在部署后如何进行运维本文档包括以下部分:1.部署完成后平台发生的变化2.容器事件及应用日志查看3.应用对应的身份配置4.如何添加监控措施 1.部署完成后平台发生的变化完成部署后,首先,在子账户-空间-本次部署的目标空间内的应用程序列表里,会多出三个应用 其中,cpapp-db-deployer应用只会在部署时启动,用于部署CAP程序内的HANA Cloud内容,cpapp-srv是我们的后端服务,approuter是装载了我们前端内容的服务,如果你同时使用了html5repo装载前端代码,则可以在子账户-HTML5应用程序内找到nsrisks2应用 在左侧从应用程序子菜单切换到服务-实例子菜单后,可以看到四个服务实例,其中cpapp-auth代表了身份中心,cpapp-db代表了嵌入到HANA Cloud的hdi-shared容器(详细含义请参考其他资料), cpapp-destination代表了在本空间内的destination服务,点击该服务实例名称,即可进入服务实例主页,首先默认进入 引用应用 子菜单,可以看到哪些应用可以访问该服务实例;左菜单选择 目标,可以看到5个destination,分别来自mta.yaml 中module approuter properties内的srv-destination,和resources cpapp-destination内定义的cpapp-srv-api和ui5,以及系统自动生成的连接到auth和html5repo的两个destination 回到空间主页,左菜单的 路由,可以看到两个路由,意思就是对应两个应用程序的两个公网URL左菜单的 空间成员 和子账户权限略有不同,这里的 空间成员 指的是Cloud Foundry内的org-space权限,有这些权限才可以配置/部署应用 2.容器事件及应用日志查看部署完成后,在子账户-空间-应用主页内,可以查看到应用对应的公网url,还可以看到 +实例 的按钮,这里指的是实际运行应用的容器数,可以通过点击增加数量,新增的每个实例会占用与旧实例一致的内存量在左菜单的事件选项内,可以看到容器发生事件的日志记录,此处无需配置,对接的是容器底层的运行日志在左菜单的日志选项内,暂时看不到任何内容,点击左上角的 打开Kibana 仪表盘,也不会有内容,因为logging服务没有被创建,即使被创建过了也需要和该应用绑定,并在应用内写日志到logging服务 3.应用对应的身份配置在应用主页的 左菜单-安全性下,可以看到 范围和角色模板,其内容都来自xs-security.json内的定义此时回到 子账户-安全性-角色集合,可以看到RiskManager-dev角色集合,这里的内容是来自mta.yaml resources cpapp-auth内的。 scope即每一个代表最细粒度的身份权限,不能再分Role template会采用一个或几个scope来确定一个模板Role就是role template的一个实例,一般默认会根据每一个role template产生一个roleRole collection就是最后直接分配给不同用户的权限模板,可以包含一个或几个role Scope和Role template是1:n(n>=1)Role template和Role是1:1(没有attribute时)Role和Role Collection是n:1(n>=1;通常n>1) Attributes代表额外的属性,如果Role template没有任何Attributes,则相应的角色与Role template相同如果Role template具有一个或多个Attributes,则必须基于Role template创建角色并提供Attributes值这也就是为什么role 和 role template可以不是1:1的关系 4.如何添加监控措施看过了主要的变化,接下来让我们练习如何添加监控信息首先需要为子账户启用一个application-logs服务实例,然后要将应用与服务实例相连,可以使用命令行或者cockpit来操作https://help.sap.com/docs/application-logging-service/sap-application-logging-service/bind-your-application-using-command-line-interface 简单来说,在应用部署好之后,进入子账户-目标空间后,在左菜单的 实例列表页面内点击右上角的创建,选择application-logs服务,选择lite计划,填入实例名称后即可 点击 下一步-创建创建完成后还是在空间内的实例列表页面点击新实例来打开右菜单,在右菜单的 绑定的应用程序 处点击创建,选择目标应用后确认创建最后回到应用程序列表页面,点击目标应用进入应用主页后点击左菜单的日志-打开Kibana仪表盘,即可看到该应用的日志了 但更推荐直接在mta.yaml内定义该服务实例以及绑定:在resources部分添加: – name: cf-logging
type: org.cloudfoundry.managed-service
parameters:
service: application-logs
service-plan: lite 然后在需要监控的应用的require部分添加依赖即可,我这里是在cpapp-srv这个module里的requires添加了一条 – name: cf-logging 然后是在应用内添加监控:进入srv/risk-service.js第二行添加:const generalLOG = cds.log(‘generalLOG’) 然后在srv/risk-service.js内为read risks注册的事件内(或者你想记录日志的地方)添加以下代码generalLOG.info (‘generalLOG’, test) 最后重新打包部署,进入risks应用页面执行几次Go来查询数据,以触发read risks事件及其内的日志记录动作然后回到 子账户-空间-应用列表-应用主页-左菜单日志-打开kibana仪表盘 以查看新出现的日志内容 Nodejs请参考:About | CF Node.js Logging Support Java请参考:Home · SAP/cf-java-logging-support Wiki · GitHub 关于本文内容有任何问题或见解,欢迎在评论区留下你的想法,如果需要帮助,也可以直接联系到我 arthuryang1996@foxmail.com,感谢你的时间 Read More Technology Blogs by SAP articles
#SAPCHANNEL