AppCloud搭建“斯瓦格”在线文档管理平台【开发者专属集市】
AppBazzar开发者专属集市
进入AppBazzar开发者专属集市 https://console.huaweicloud.com/appbazaar/home?region=cn-north-4
可以看到，有很多官方的支持一键部署的方案，上下拖动后发现，所有方案右上角标的都是“DIY文档”，唯独“斯瓦格”的右上角标注的是“AppCloud”
本着“猎奇”的心理，下面就让我们进入“斯瓦格”的世界一探究竟。
斯瓦格
产品介绍
“斯瓦格”是一款简单好用的在线接口文档管理工具（Web），支持json,txt,xml,html,js,流和 WebSocket，同时具备了如下多种优点，比如：
- 提供简洁明了的API，同时更便于后期维护；
- 可以以多种形式导出API，以满足不同场景的需求；
- 开放源码，支持任意修改。
“斯瓦格”主要使用Java编写，并通过Maven构建，部署到Tomcat上。本方案使用AppCloud构建斯瓦格应用
产品特性
| 特性 | 说明 |
|---|---|
| 技术选型特点 | 单体架构 |
| 开发语言 | Java(55.4%)、JavaScript（37.2%）、CSS（7.4%） |
| 数据库 | 无 |
| 部署服务器操作系统 | CentOS 7.6 |
| 技术方案 | Maven+Tomcat |
| 构建工具版本 | maven3.5.3-jdk8-open |
| 应用服务器及环境要求 | Tomcat-8.5.38 +openjdk-9.0.4 |
| 制品类型 | war |
购买
构建应用
买家中心 https://console.huaweicloud.com/appbazaar/buyer-center?region=cn-north-4
这里可以看出“斯瓦格”果然与众不同
- “别的产品”都是"查看API文档"
- “斯瓦格”确是"去构建应用
1.创建应用
关联华为云DevCloud：AppCloud的一键上云需要使用华为云DevCloud的相关能力， 您可以选择自动创建华为云DevCloud新项目或是使用已有项目。
- 应用名称（随便填）
福州司马懿的“斯瓦格”在线文档管理平台 - 关联华为云DevCloud
在华为云DevCloud中同步创建新项目 - 应用简介（随便填）
Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。
总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法、参数和模型紧密集成到服务器端的代码，允许 API 来始终保持同步。Swagger 让部署管理和使用功能强大的 API 从未如此简单。 - 选择方案
AppCloud搭建“斯瓦格”在线文档管理平台
下面会提示你开通 DevCloud，我们做实验，因此只要选择个人基础版即可，按下面步骤依次创建
2.基础设置
只要您的软件包可以直接在Linux Tomcat环境下直接运行——无需解压、替换文件，也无需修改Tomcat、JDK等环境配置，AppCloud都可以提供一键部署
下载包
点击下载按钮，下载 siwage-2.1.5.war，地址如下
https://console.huaweicloud.com/appcloud/v1/files?file_path=packages%2Fxiaoyaoji%2Fv1.0%2Fsiwage-2.1.5.war
发布包
然后前往华为云DevCloud“发布”上传“斯瓦格”软件包，点击“立即前往”按钮。这里前往的地方实际上是DevCloud的“构建&制品”——> 制品仓库
点击“上传”，上传我们刚刚下载下来的siwage-2.1.5.war，这个在右下角会显示实时的上传进度
这是上传成功的“制品”
上传包
发布好后，回到我们之前下载siwage-2.1.5.war的AppCloud界面，点击刷新按钮，然后在选择上传的“斯瓦格”软件包下拉框中选择我们刚刚上传的siwage-2.1.5.war
填写主机配置
然后填入你的ECS主机配置，点击开始执行
关于费用： 费用将从您的账户中扣除，请确保账户余额充足
至于费用，可以点击“了解计费详情”
注意：
- ECS不需要你去购买，DevCloud会自动为你购买
- 当前版本下，此方案涉及到的详细云服务器配置及部署参数将固定为模板，暂不可改动
- 上面的主机信息（服务器名、账号、密码）都是我随便写的，但是后面依然能访问斯瓦格官网
开始执行
点击“开始执行”，会弹出一个提示窗，提示：应用部署后，相关云资源的消耗会产生费用（按需付费模式），如需停止，可前往“我的主页”对应用进行“资源释放”。请确认是否开始部署
3.一键部署
点击“开始执行”按钮后，DevCloud会自动部署。它会弹出一个命令行，自动执行脚本操作
部署中。。。
也可以进入全屏模式，查看命令输出
（整个过程，将持续5分钟左右）
部署成功，会显示“执行部署任务成功”的提示，底下也会出现“下一步”的按钮
4.访问应用
应用访问地址：http://120.46.220.6/siwage-2.1.5
温馨提示：当前应用的资源为“按需计费”，如需停止计费，请前往“我的应用”进行资源释放
体验斯瓦格
首先点击“立即使用”进入“斯瓦格”的登录页，由于我们没有账号密码，因此进行注册
这边可以发现，官方的斯瓦格并不支持注册，会报“系统错误”，原因可能有一下两种
- 华为的斯瓦格包的问题
- 我没购买ECS，上面填的主机是随便写的
释放资源
应用部署后，如果不用要及时释放，否则会持续扣费。释放的方式也很简单，点击返回主页按钮，更多操作，释放资源，即可
华为云会自动执行相应命令删除资源
接下来，下面会出现一个“返回我的应用”按钮，点击按钮可以查看到“斯瓦格”又变回“未部署”的状态，说明释放成功
总结
- 使用华为云DevCloud部署“斯瓦格”真的很方便，可以实现DevOps，仅需4步（创建应用、基本设置、一键部署、访问应用），半小时内就能上线
- AppCloud版的“斯瓦格”是一个体验项目，无需够买云服务器ECS，即可 免费体验 华为云DevCloud部署的全流程。
- 没有真实提供云服务器的“斯瓦格”官网可以访问，但无法进行正常注册和使用
附录
华为云DevCloud的操作步骤图，可以在ProcessOn的官网，使用EVC企业价值链图形进行绘制 （免费）。ProcessOn的在线绘制地址为 https://www.processon.com/diagrams
【购物节已开启，个人开发者的专属集市AppBazaar来啦（所有商品购物节期间免费体验）】有奖征文火热进行中：https://bbs.huaweicloud.com/blogs/381337
此外，在(https://bbs.huaweicloud.com/activity/suggestion.html)提出您的宝贵建议，标题以【云驻计划-定向征文】开头，还有机会赢取额外奖励。
- 点赞
- 收藏
- 关注作者
评论（0）