【Soul源码阅读】2.单机部署 Soul

上一篇中，我们对 Soul 有了一个简单的认识。

在学习一项新技术时，我们先按照官网上的 Demo 把环境搭建起来。今天先搭建一个单机版测试环境。

1.下载源码

soul 的 github 地址： https://github.com/dromara/soul

这里有2个选择：

1. 如果只是用来阅读 soul 源码，不会改动，不提交 PR的，直接 git clone 的地址。
2. 如果学习源码后，希望参与到 soul 开源项目中，fork 到自己账号下，再 clone 自己账号下的 soul 项目。

这里，我建议大家采用第2种方式，也以第2种方式演示。

git clone https://github.com/hellboy0621/soul.git

为了方便后续拉取最新代码，设置 upstream 远程仓库

git remote add upstream https://github.com/dromara/soul

# 后续拉取最新代码时使用
git checkout master
git pull upstream master

后续如果提交 PR 时，会创建单独的 branch 修改代码后上传，目前我们只是阅读源码，所以创建一个 read 的分支，互不影响。

git checkout -b read

把源码下载好后，导入 IDEA 中。

2.启动 MySQL

soul-admin 模块需要把一些数据持久化到 MySQL中。

3.启动 soul-admin 项目

在 IDEA 里找到 soul-admin 模块，按照各自数据库配置，修改配置文件（我的是3306端口号，用户名root，没有密码）

启动完成后，进入控制页面 http://127.0.0.1:9095/，使用 admin/123456 登录。欢迎页面如下：

在插件列表下，所有页面都是空白的。

4.启动 soul-bootstrap，这就是 Soul 网关服务项目，默认端口号是9195。

5.接入 HTTP 应用。

启动 examples 下的 soul-examples-http。

再次访问管理页面的 devide 插件，有了如下选择器。

在 soul-examples-http 项目下的 controller 层，可以看到这些接口信息，如下图这个接口 /order/findById。

此时可以直接访问这个接口 http://localhost:8188/order/findById?id=95

也可以通过网关来访问这个接口 http://localhost:9195/http/order/findById?id=95

今天就先体验到这里，明天我们继续深入的探索 HTTP 服务是如何接入的。

文章是本人一边学习一边记录的，如有错误，请批评指正，谢谢。