soul從入門到放棄1--項(xiàng)目搭建

零、概述

用于工作、學(xué)習(xí)的需要開始學(xué)習(xí)soul,希望能堅(jiān)持下去,不像專欄的名字一樣 ------ soul從入門到放棄

本篇導(dǎo)讀:網(wǎng)關(guān)的基本概念、soul主要架構(gòu)、環(huán)境的基本搭建

一、基本概念

什么是api網(wǎng)關(guān)(服務(wù)網(wǎng)關(guān))?

服務(wù)網(wǎng)關(guān) = 路由轉(zhuǎn)發(fā) + 過濾器

  • 路由轉(zhuǎn)發(fā):接收所有外界請(qǐng)求,根據(jù)路由配置,轉(zhuǎn)發(fā)到微服務(wù)上
  • 過濾器:可以完成一系列的橫切功能,如:限流、監(jiān)控、權(quán)限校驗(yàn)等

以上這些功能本質(zhì)上都是通過過濾器實(shí)現(xiàn)的

什么是soul?

一個(gè)基于WeuFlux實(shí)現(xiàn)的響應(yīng)式API網(wǎng)關(guān),具有異步的,高性能的,跨語言的等特點(diǎn)。

soul的主要功能

  • 支持各種語言(http協(xié)議),支持 dubbo,springcloud協(xié)議。
  • 插件化設(shè)計(jì)思想,插件熱插拔,易擴(kuò)展。

插件的熱插拔,規(guī)則的動(dòng)態(tài)配置。
舉個(gè)列子,比如一個(gè)接口你限流是1秒50次,但是你想調(diào)小點(diǎn),像Springcloud-gateway 或者zuul 是不是還得改動(dòng)配置 然后重啟。 soul則不需要,直接在soul-admin找到對(duì)應(yīng)的接口修改即可.</pre>

  • 靈活的流量篩選,能滿足各種流量控制。
  • 內(nèi)置豐富的插件支持,鑒權(quán),限流,熔斷,防火墻等等。
  • 流量配置動(dòng)態(tài)化,性能極高,網(wǎng)關(guān)消耗在 1~2ms。
  • 支持集群部署,支持 A/B Test, 藍(lán)綠發(fā)布。

架構(gòu)圖

image
image

此圖綠色部分為客戶端,按照網(wǎng)關(guān)要求的數(shù)據(jù)格式來請(qǐng)求網(wǎng)關(guān)服務(wù)。

soul的底層是webflux,如果soul是集群部署的話,可以開啟nginx,來反向代理網(wǎng)關(guān)服務(wù)。

Soul-admin

是soul的控制臺(tái),負(fù)責(zé)管理插件插拔,選擇器的配置,規(guī)則的配置。將數(shù)據(jù)寫入mysql中,同時(shí)基于SPI(HTTP、Zookeeper、Websocket三種之一),實(shí)現(xiàn)數(shù)據(jù)同步機(jī)制(后續(xù)篇章會(huì)詳解)。

Soul Cluster

soul啟動(dòng)后,會(huì)根據(jù)數(shù)據(jù)同步機(jī)制,拉去遠(yuǎn)端相關(guān)配置信息至本地,寫入本地JVM,然后開啟監(jiān)聽,來動(dòng)態(tài)更新JVM中的數(shù)據(jù),

Plugins--Handler

基于插件責(zé)任鏈模式的執(zhí)行流程,每個(gè)插件各司其職。插件是根據(jù)用戶在soul-admin配置網(wǎng)關(guān)請(qǐng)求數(shù)據(jù),規(guī)則,來執(zhí)行具體邏輯。

二、環(huán)境搭建

依賴工具:樸實(shí)無華的工具,降低網(wǎng)關(guān)引入門檻

JDK 1.8+

Maven 3.2.x

Git

mysql 5.x :溫馨提醒,輕易不要嘗試mysql 8

克隆代碼

giee:git clone https://gitee.com/shuaiqiyu/soul.git --depth=1

github:git clone https://gitee.com/shuaiqiyu/soul.git --depth=1

關(guān)于: depth

  • 用 git clone --depth=1 的好處是限制 clone 的深度,不會(huì)下載 Git 協(xié)作的歷史記錄,這樣可以大大加快克隆的速度
  • depth用于指定克隆深度,為1即表示只克隆最近一次commit
  • 適合用 git clone --depth=1 的場(chǎng)景:你只是想clone最新版本來使用或?qū)W習(xí),而不是參與整個(gè)項(xiàng)目的開發(fā)工作

maven編譯

可以skip一些,提升運(yùn)行效率

mvn clean package install -Dmaven.test.skip=true -Dmaven.javadoc.skip=true -Drat.skip=true -Dcheckstyle.skip=true

修改配置及啟動(dòng)

soul-admin

soul-admin/src/main/resources/application.yml

image

修改mysql的配置項(xiàng)目,之后 啟動(dòng)項(xiàng)目即可。

項(xiàng)目啟動(dòng)會(huì)類LocalDataSourceLoader,會(huì)執(zhí)行schema.sql腳本,自動(dòng)創(chuàng)建庫、表、相關(guān)初始化數(shù)據(jù)。

訪問地址:http://localhost:9095/

用戶名:admin 密碼:123456


image.png

各種插件

soul-bootstrap

基本不需要修改,只要注意與后臺(tái)連接地址一致即可

image

訪問地址:http://localhost:9195/

三、心得總結(jié)

環(huán)境搭建的過程,復(fù)習(xí)很多maven與git上的使用小技巧

本篇幅講了soul的大致架構(gòu),對(duì)分布式系統(tǒng)的交互有了新的理解,下一篇將擼起胳膊開始最簡單的http接口測(cè)試

靡不有初,鮮克有終。希望自己能堅(jiān)持寫完這個(gè)系列

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,106評(píng)論 6 542
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,441評(píng)論 3 429
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,211評(píng)論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,736評(píng)論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,475評(píng)論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,834評(píng)論 1 328
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,829評(píng)論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 43,009評(píng)論 0 290
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,559評(píng)論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,306評(píng)論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,516評(píng)論 1 374
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,038評(píng)論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,728評(píng)論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,132評(píng)論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,443評(píng)論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 52,249評(píng)論 3 399
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,484評(píng)論 2 379

推薦閱讀更多精彩內(nèi)容