ONOS 实战分享(一):项目建立、调试到热部署

以上是ONOS的架构图,相信大家已经熟记于心了

本文将在Distributed Core Tier,以开发一个控制器内的模块为例,带领大家从项目的建立,导入IDE,编译构建,热部署,在线调试,最后到热迭代,走过一个项目的开发流程。

对于实现模块具体功能的介绍内容,请阅读我的后续文章。本文尽量不介绍Maven及其pom、OSGI、Karaf的内容,这些不是ONOS特有的,但需要朋友们对它们是什么、有什么作用,有个大致的了解,所以请大家Google之。

文中将会随时插入一些我在实践中遇到的棘手问题,和实践中需要注意的points。

希望本文能够给ONOS的入门开发者朋友们一些启发。

(0)Hello, ONOS!

我参考官方Wiki搭建了ONOS环境,在此附几张图,让大家快速了解一下本文介绍的系统环境基础。

本文采用官方Git中的master分支,1.4.0-SNAPSHOT版本,2015.11.04下载,1.3.0以及更新的临近版本应该都不会有问题。

官方Wiki:Installing and Running ONOS

按照官方一步步做,我印象中就不会遇到什么卡壳的问题,除了Download一些Maven 库的时候,是比较拼网络的,如果出问题,也可以考虑改用一些国内的Maven镜像站,祝大家顺利。

Karaf、Maven:

ONOS: 为了Eclipse工程方便,目前放在workspace下,仅作为后文介绍的“路径”前提。

ONOS主目录:(target目录在编译后才有)

ONOS apps目录:运作在Distributed Core Tier的模块,多数都在这,我们将要一起开发的模块也在此。(target目录在编译后才有)

(1)项目建立

应该是从ONOS 1.3版本开始,官方提供了一个脚本,用于项目建立的便利,我先带大家一起来使用,文末再给大家看看内容。

就是这个脚本,让我们开始!

在某个不含pom.xml文件的目录下,执行onos-create-app,要等一段时间,才会出现命令行里的最后那一句:

这里我们输入试验使用的信息,依次如下:

这里有个我尚未理解的现象: 如果groupId不是以“org.onosproject”为前缀的;Version如果跟ONOS的版本1.4.0-SNAPSHOT不一样的。后续的编译完的部署会不太一样,后续“热部署”章节会告诉大家如何解决。

如果groupId不是以“org.onosproject”为前缀,解决后但仍不太理想,特别是当模块往复杂里做的时候。如果没有特殊需要的话,推荐大家按照这个前缀来。

That’s good!

我们刚刚构建了一个这样的目录结构:

生成了三个文件: pom.xml – Maven项目文件 AppComponent.java – 模块文件 AppComponentTest.java – Maven构建模块时,用于测试模块的文件

自动生成的AppComponent.java可以删除,换成我们自己的文件就好,本文暂且使用它。AppComponentTest.java可以在构建模块时,通过参数 –DskipTests 跳过测试,我暂时还没有掌握怎么改写它,暂不改动,大家也可以予以删除。不过如果大家要开发作为正式使用的模块,还是要学习一下如何编写它比较好。

推荐大家此时,把整个SDNLAB-Demo移动到onos/apps/目录下,最外层的SDNLAB-Demo文件夹删除,最后如下:

接下来,我们需要修改pom.xml文件: 如图,解除注释,输入我们想要的信息,如下:

红箭头No.1,模块的基本信息 红箭头No.2,模块的描述信息 红箭头No.3,应用名和开发者组织名称

然后打开apps目录下其他任意一个模块的pom.xml文件,从中复制段的信息,贴到我们的pom里面来:

最后,打开apps目录下的pom,加入我们模块的信息,这样前后的从属关系就建立好了:

项目建立到此完成,感兴趣的朋友可以去瞧一瞧实现功能的AppComponent.java哦!

(2)导入IDE

JAVA开发需要导入一大堆的包,虽说我们应该记住一些常用的包名,但实际工程中还是让IDE来帮我们做这些繁琐的工作吧,Let’s Go!(我们以Eclipse为例,IDEA请稍候)

注:需要首先把整个ONOS源代码导入进Eclipse中,在此也不赘述了,参照官网Wiki:Development Environment Setup 如果遇到问题,可以Google、Wiki或到ONOS群里交流哈,比如:454644351

好的,不急着做,我们先来看看成功导入ONOS之后,大致是个什么样:

感觉跟IDEA比起来,项目聚合得不是很好,让我们开始导入吧:

咱们的模块已经导入成功,右侧就是最简单的一个模块代码哦!如何开发模块的功能,可翻看我后续的文章,初步的了解可参考SDNLAB文章:ONOS编程系列(一)之简单应用开发

(3)编译构建项目

在这给大家介绍两种方式,Terminal方式、IDE方式,我推荐大家用Terminal方式,编译完直接就可以敲命令部署进ONOS。

1.Terminal方式:

在模块主目录下,执行:

mvn clean install -DskipTests

Clean,清除旧的构建结果; Install,构建新的模块; -DskipTests,跳过构建完成后的测试步骤,debug阶段暂且跳过吧:

2.IDE方式:

构建完成!我们刚才构建完以后,发生了哪些变化呢:

1)模块目录下多了target文件夹,.oar文件就是我们的ONOS应用模块文件:

oar文件可单独、直接用于模块的远程热部署

2)项目被安装到本地Maven仓库,信息同时加入仓库的repository.xml文件:

(4)ONOS模块热部署

onos-karaf 启动ONOS,可以看到模块已经装载进ONOS了,但是没有启动。

By the way,我们模块名称是SDNLAB-Demo

这里有个疑问尚未解决,如果version设置得跟当前ONOS的不一样,即不是1.4.0-SNAPSHOT,那么这里将不会默认将模块从本地Maven库中装载进来,可能是因为在Karaf的配置文件中,onosproject只是写了1.4.0***的部分吧?

我跟踪了Karaf的启动过程,多次尝试改动,摸索了一段时间,还是没能弄清楚缘由,还请了解的朋友们指教,非常感谢!如下:

而且在项目构建的时候,如果使用的是其他version,会额外下载相应版本的依赖文件,虽然下载不成功只是warning,模块也能工作,但不知道会有什么副作用。

如果写好的模块要“热部署”到远端,或者是模块没有被默认装载,则命令没有任何回显,如下:

进入oar文件所在目录,一条命令onos-app,完成远程安装模块:

可以看到,我们应用的全名是“org.onosproject.Mao.SDNLAB-Demo”,我们后续更新迭代、启动/停止模块都需要用到它。

第二条命令,完成远程启动模块:

再次查看,可以发现我们的模块已经成功装载,并且启动!

(5)ONOS在线调试

这是让我觉得很有趣的地方,原以为这样的大框架系统只能通过日志或命令行print来调试呢,这真是太棒了!

用 onos-karaf debug 来启动ONOS,会开启5005远程调试端口:

启动 Eclipse或IDEA,看资料感觉IDEA在调ONOS上有更多便利,正考虑转移,现以Eclipse为例,IDEA类似但是会方便点。

配置远程调试,一张图搞定:

我们在模块加载入口函数中设定断点,开始调试,ONOS的线程池也是美美的

由于模块已经是active,为了触发这个断点,我们将它关了再开一次。看,ONOS已经卡住了:

看!Karaf console控制台线程正在执行我们的模块加载函数,我们唯一的内部变量已显示,断点卡在了即将写日志的地方。

小伙伴们,可以愉快地调试了哦!

(6)ONOS模块热迭代

假设我们已经修改了模块的代码,现在准备上线调试或运行,为了展示方便和标识版本,首先,修改pom文件中的、重新编译构建:

模块已经存在,这时候是不能install的:

这时候需要用上我们的应用名,用reinstall参数:

That’s Good!

(7)思考 & 展示

1)我的疑惑: 整个开发过程似乎都不需对onos/feature/feature.xml文件进行修改,反而onos/apps里面的模块构建以后是存档在本地Maven仓库里的(~/.m2/repository),而且他们的装载也不依赖于onos源代码文件夹了。

于是我想找到Karaf是如何找到我们的模块的,我从onos-karaf入口开始,到onos-setup-karaf,再到karaf/bin/karaf,有点眼晕,没有找到什么线索。

另外只知道karaf/etc/org.apache.karaf.features.cfg有大仓库的位置信息,可是里头跟onos/feature/feature.xml是一样的,里头没有任何onos/apps中模块的信息。而且我尝试着在Maven库的~/.m2/repository.xml中删去模块信息,也没有用,Karaf照样能载入那个模块。

同时,编译后onos/feature/feature.xml文件也都被放到Maven仓库中了,整个onos似乎都被搬到Maven库中了,运行似乎都跟源码文件夹没有什么关系?(除了入口脚本onos-karaf是被指定在源码文件夹中)

对于需要groupId以“org.onosproject”为前缀、Version如果跟ONOS的版本1.4.0-SNAPSHOT一样的情况,也是挺疑惑的,估计也跟Karaf寻找仓库、模块的方法有关。

但是如果version设置得不一样,会导致构建过程中下载其他版本的pom文件或库,可能存在问题的隐患,但如果不能灵活改变的话,版本号的意义何在呢,待探索

2)说好的各种脚本秀 脚本位置:

onos-create-app,本质是使用了mvn的项目原型框架:

onos-app,本质是使用了REST API北向接口,这接口是不是很强大

onos-karaf,ONOS启动脚本:先配置好karaf环境,再启动karaf本体:

onos-setup-karaf,配置环境,将默认装载的模块全部准备好,舞场后台Staging就位,只给大家展示熟悉的部分好啦:

Karaf,大家感兴趣就去瞄两眼吧

(8)结语 & 感悟

ONOS和ODL,两个BOSS级的控制器/系统。原本我是从ODL入手的,可是对于ODL控制器内部的开发教程实在太少,或者应该说是难以寻到。

原本以为官方的Wiki应该是一扇不错的大门,后面应该有一条路灯明亮的小径,哪怕它再曲折幽深,我也无惧。

可惜ODL的Wiki给我的感觉是一个知识的大仓库,仓库入口附近还没有仓储名录,面对着找不到目录的wiki主页,我茫然了。虽然看完了 地球-某某 老师的一百多页的开发案例讲解PDF,但还是觉得头脑中的实践路线不清晰。直到那天看 明明姐@陈明明-北邮,在群里说wiki上已经有一些tutorial,我就马上去搜,发现了两三条对于开发入门不错的文章标题,于是火速将所有tutorial放进我的收藏夹 ^_^ 谢谢明明姐,美美哒!

最近实验室项目的关系,我投入到ONOS的学习中。ONOS让我有点惊喜,wiki左侧目录右侧内容,关键区域还有YouTube视频指点迷津。

ONOS对于开发入门的朋友还有三四篇经典的tutorial wiki文章,源代码也是分块清晰,代码结构更是简洁明了,各层之间的关系,层之间、模块之间如何交换信息都能清楚地在代码层面轻松寻到。一切都看起来规规矩矩,有章可循,很赞! 在这里也要感谢一下 北京石头 这位朋友,您在SDNLAB中的四篇入门分享文,是我的引路之石。

希望大家看完我的这篇文章,能对大家入门ONOS有一些帮助,如果确实如此,那将是我莫大的快乐,希望能与大家共同进步!

原文发布于微信公众号 - SDNLAB(SDNLAB)

原文发表时间:2015-12-07

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏风火数据

高级Java研发师在解决大数据问题上的一些技巧

众所周知, Java 在处理数据量比较大的时候,加载到内存必然会导致内存溢出,而在一些数据处理中我们不得不去处理海量数据,在做数据处理中,我们常见的手段是分解,...

1182
来自专栏智能大石头

Oracle免客户端For .Net(增加分析Devart和DataDirect)

    我只是一名普通的.Net开发人员,常用SqlServer,偶尔用其它数据库,属于能连上然后select/execute就行的那种。但就是我这么小的愿望,...

21010
来自专栏北京马哥教育

让“懒惰” Linux 运维工程师事半功倍的 10 个关键技巧!

好的Linux运维工程师区分在效率上。如果一位高效的Linux运维工程师能在 10 分钟内完成一件他人需要 2 个小时才能完成的任务,那么他应该受到奖励(得到更...

4006
来自专栏程序员的知识天地

众多Python Web框架比较,哪个适合你,你就用哪个!

Python程序员有很多很好的选择来创建Web应用程序和API;Django,Weppy,Bottle和Flask引领潮流。

2372
来自专栏架构师之路

缓存,你真的用对了么?

缓存,是互联网分层架构中,非常重要的一个部分,通常用它来降低数据库压力,提升系统整体性能,缩短访问时间。

2032
来自专栏ThoughtWorks

DocBook 让文档版本化

image.png #ThoughtWorkers好声音# 第十六期(图片:网络) 你们都知道ThoughtWorks曾经是扛敏捷的大旗的,你们也都知道敏捷是...

3246
来自专栏恰童鞋骚年

NoSQL初探之人人都爱Redis:(1)Redis简介与简单安装

  随着互联网Web2.0网站的兴起,传统的关系数据库在应付Web2.0网站,特别是超大规模和高并发的SNS类型的Web2.0纯动态网站已经显得力不从心,暴露了...

1152
来自专栏腾讯移动品质中心TMQ的专栏

iOS 静态代码扫描之工具调研

为了进一步加强测试质量,同时探索测试左移在同步中的实践,iOS同步助手尝试接入静态代码扫描工具。希望通过不同的途径提前发现日常测试中难发现的问题。

1.4K1
来自专栏IT大咖说

送给前端的你:可视化快速生成模拟数据服务——Easy Mock

? 内容来源:2017年11月18日,大搜车前端工程师高攀在“2017中国开源年会”进行《Easy Mock 接口数据模拟服务》演讲分享。IT 大咖说(微信i...

4796
来自专栏应用案例

性能测试之gatling详解

大家接触过形形色色的压力测试工具,例如lr,jmeter各有各的优点,那么最近在做接口测试中涉及到压力测试,小弟就看到一个好用的工具俗称“加特林”英文Gatli...

3726

扫码关注云+社区

领取腾讯云代金券