manager.go 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911
  1. // Copyright 2021-2022 EMQ Technologies Co., Ltd.
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. // Manage the loading of both native and portable plugins
  15. package native
  16. import (
  17. "archive/zip"
  18. "bytes"
  19. "encoding/json"
  20. "fmt"
  21. "os"
  22. "os/exec"
  23. "path"
  24. "path/filepath"
  25. "plugin"
  26. "regexp"
  27. "strings"
  28. "sync"
  29. "time"
  30. "unicode"
  31. "github.com/lf-edge/ekuiper/internal/conf"
  32. "github.com/lf-edge/ekuiper/internal/meta"
  33. "github.com/lf-edge/ekuiper/internal/pkg/filex"
  34. "github.com/lf-edge/ekuiper/internal/pkg/httpx"
  35. "github.com/lf-edge/ekuiper/internal/pkg/store"
  36. plugin2 "github.com/lf-edge/ekuiper/internal/plugin"
  37. "github.com/lf-edge/ekuiper/pkg/api"
  38. "github.com/lf-edge/ekuiper/pkg/cast"
  39. "github.com/lf-edge/ekuiper/pkg/errorx"
  40. "github.com/lf-edge/ekuiper/pkg/kv"
  41. )
  42. // Manager Initialized in the binder
  43. var manager *Manager
  44. const DELETED = "$deleted"
  45. // Manager is append only because plugin cannot delete or reload. To delete a plugin, restart the server to reindex
  46. type Manager struct {
  47. sync.RWMutex
  48. // 3 maps for source/sink/function. In each map, key is the plugin name, value is the version
  49. plugins []map[string]string
  50. // A map from function name to its plugin file name. It is constructed during initialization by reading kv info. All functions must have at least an entry, even the function resizes in a one function plugin.
  51. symbols map[string]string
  52. // loaded symbols in current runtime
  53. runtime map[string]*plugin.Plugin
  54. // dirs
  55. pluginDir string
  56. pluginConfDir string
  57. // the access to func symbols db
  58. funcSymbolsDb kv.KeyValue
  59. // the access to plugin install script db
  60. plgInstallDb kv.KeyValue
  61. // the access to plugin install status db
  62. plgStatusDb kv.KeyValue
  63. }
  64. // InitManager must only be called once
  65. func InitManager() (*Manager, error) {
  66. pluginDir, err := conf.GetPluginsLoc()
  67. if err != nil {
  68. return nil, fmt.Errorf("cannot find plugins folder: %s", err)
  69. }
  70. dataDir, err := conf.GetDataLoc()
  71. if err != nil {
  72. return nil, fmt.Errorf("cannot find data folder: %s", err)
  73. }
  74. func_db, err := store.GetKV("pluginFuncs")
  75. if err != nil {
  76. return nil, fmt.Errorf("error when opening funcSymbolsdb: %v", err)
  77. }
  78. plg_db, err := store.GetKV("nativePlugin")
  79. if err != nil {
  80. return nil, fmt.Errorf("error when opening nativePlugin: %v", err)
  81. }
  82. plg_status_db, err := store.GetKV("nativePluginStatus")
  83. if err != nil {
  84. return nil, fmt.Errorf("error when opening nativePluginStatus: %v", err)
  85. }
  86. registry := &Manager{symbols: make(map[string]string), funcSymbolsDb: func_db, plgInstallDb: plg_db, plgStatusDb: plg_status_db, pluginDir: pluginDir, pluginConfDir: dataDir, runtime: make(map[string]*plugin.Plugin)}
  87. manager = registry
  88. plugins := make([]map[string]string, 3)
  89. for i := range plugins {
  90. names, err := findAll(plugin2.PluginType(i), pluginDir)
  91. if err != nil {
  92. return nil, fmt.Errorf("fail to find existing plugins: %s", err)
  93. }
  94. plugins[i] = names
  95. }
  96. registry.plugins = plugins
  97. for pf := range plugins[plugin2.FUNCTION] {
  98. l := make([]string, 0)
  99. if ok, err := func_db.Get(pf, &l); ok {
  100. registry.storeSymbols(pf, l)
  101. } else if err != nil {
  102. return nil, fmt.Errorf("error when querying kv: %s", err)
  103. } else {
  104. registry.storeSymbols(pf, []string{pf})
  105. }
  106. }
  107. if manager.hasInstallFlag() {
  108. manager.pluginInstallWhenReboot()
  109. manager.clearInstallFlag()
  110. }
  111. return registry, nil
  112. }
  113. func findAll(t plugin2.PluginType, pluginDir string) (result map[string]string, err error) {
  114. result = make(map[string]string)
  115. dir := path.Join(pluginDir, plugin2.PluginTypes[t])
  116. files, err := os.ReadDir(dir)
  117. if err != nil {
  118. return
  119. }
  120. for _, file := range files {
  121. baseName := filepath.Base(file.Name())
  122. if strings.HasSuffix(baseName, ".so") {
  123. n, v := parseName(baseName)
  124. // load the plugins when ekuiper set up
  125. if !conf.IsTesting {
  126. if _, err := manager.loadRuntime(t, n, path.Join(dir, baseName), ""); err != nil {
  127. continue
  128. }
  129. }
  130. result[n] = v
  131. }
  132. }
  133. return
  134. }
  135. func GetManager() *Manager {
  136. return manager
  137. }
  138. func (rr *Manager) get(t plugin2.PluginType, name string) (string, bool) {
  139. rr.RLock()
  140. result := rr.plugins[t]
  141. rr.RUnlock()
  142. r, ok := result[name]
  143. return r, ok
  144. }
  145. func (rr *Manager) store(t plugin2.PluginType, name string, version string) {
  146. rr.Lock()
  147. rr.plugins[t][name] = version
  148. rr.Unlock()
  149. }
  150. func (rr *Manager) storeSymbols(name string, symbols []string) error {
  151. rr.Lock()
  152. defer rr.Unlock()
  153. for _, s := range symbols {
  154. if _, ok := rr.symbols[s]; ok {
  155. return fmt.Errorf("function name %s already exists", s)
  156. } else {
  157. rr.symbols[s] = name
  158. }
  159. }
  160. return nil
  161. }
  162. func (rr *Manager) removeSymbols(symbols []string) {
  163. rr.Lock()
  164. for _, s := range symbols {
  165. delete(rr.symbols, s)
  166. }
  167. rr.Unlock()
  168. }
  169. // API for management
  170. func (rr *Manager) List(t plugin2.PluginType) []string {
  171. rr.RLock()
  172. result := rr.plugins[t]
  173. rr.RUnlock()
  174. keys := make([]string, 0, len(result))
  175. for k := range result {
  176. keys = append(keys, k)
  177. }
  178. return keys
  179. }
  180. func (rr *Manager) ListSymbols() []string {
  181. rr.RLock()
  182. result := rr.symbols
  183. rr.RUnlock()
  184. keys := make([]string, 0, len(result))
  185. for k := range result {
  186. keys = append(keys, k)
  187. }
  188. return keys
  189. }
  190. func (rr *Manager) GetPluginVersionBySymbol(t plugin2.PluginType, symbolName string) (string, bool) {
  191. switch t {
  192. case plugin2.FUNCTION:
  193. rr.RLock()
  194. result := rr.plugins[t]
  195. name, ok := rr.symbols[symbolName]
  196. rr.RUnlock()
  197. if ok {
  198. r, nok := result[name]
  199. return r, nok
  200. } else {
  201. return "", false
  202. }
  203. default:
  204. return rr.get(t, symbolName)
  205. }
  206. }
  207. func (rr *Manager) GetPluginBySymbol(t plugin2.PluginType, symbolName string) (string, bool) {
  208. switch t {
  209. case plugin2.FUNCTION:
  210. rr.RLock()
  211. defer rr.RUnlock()
  212. name, ok := rr.symbols[symbolName]
  213. return name, ok
  214. default:
  215. return symbolName, true
  216. }
  217. }
  218. func (rr *Manager) storePluginInstallScript(name string, t plugin2.PluginType, j plugin2.Plugin) {
  219. key := plugin2.PluginTypes[t] + "_" + name
  220. val := string(j.GetInstallScripts())
  221. _ = rr.plgInstallDb.Set(key, val)
  222. }
  223. func (rr *Manager) removePluginInstallScript(name string, t plugin2.PluginType) {
  224. key := plugin2.PluginTypes[t] + "_" + name
  225. _ = rr.plgInstallDb.Delete(key)
  226. }
  227. func (rr *Manager) Register(t plugin2.PluginType, j plugin2.Plugin) error {
  228. name, uri, shellParas := j.GetName(), j.GetFile(), j.GetShellParas()
  229. // Validation
  230. name = strings.Trim(name, " ")
  231. if name == "" {
  232. return fmt.Errorf("invalid name %s: should not be empty", name)
  233. }
  234. if !httpx.IsValidUrl(uri) || !strings.HasSuffix(uri, ".zip") {
  235. return fmt.Errorf("invalid uri %s", uri)
  236. }
  237. if v, ok := rr.get(t, name); ok {
  238. if v == DELETED {
  239. return fmt.Errorf("invalid name %s: the plugin is marked as deleted but Kuiper is not restarted for the change to take effect yet", name)
  240. } else {
  241. return fmt.Errorf("invalid name %s: duplicate", name)
  242. }
  243. }
  244. var err error
  245. zipPath := path.Join(rr.pluginDir, name+".zip")
  246. // clean up: delete zip file and unzip files in error
  247. defer os.Remove(zipPath)
  248. // download
  249. err = httpx.DownloadFile(zipPath, uri)
  250. if err != nil {
  251. return fmt.Errorf("fail to download file %s: %s", uri, err)
  252. }
  253. if t == plugin2.FUNCTION {
  254. if len(j.GetSymbols()) > 0 {
  255. err = rr.funcSymbolsDb.Set(name, j.GetSymbols())
  256. if err != nil {
  257. return err
  258. }
  259. err = rr.storeSymbols(name, j.GetSymbols())
  260. } else {
  261. err = rr.storeSymbols(name, []string{name})
  262. }
  263. }
  264. if err != nil {
  265. return err
  266. }
  267. // unzip and copy to destination
  268. version, err := rr.install(t, name, zipPath, shellParas)
  269. if err == nil && len(j.GetSymbols()) > 0 {
  270. err = rr.funcSymbolsDb.Set(name, j.GetSymbols())
  271. }
  272. if err != nil { // Revert for any errors
  273. if len(j.GetSymbols()) > 0 {
  274. rr.removeSymbols(j.GetSymbols())
  275. } else {
  276. rr.removeSymbols([]string{name})
  277. }
  278. return fmt.Errorf("fail to install plugin: %s", err)
  279. }
  280. rr.store(t, name, version)
  281. rr.storePluginInstallScript(name, t, j)
  282. switch t {
  283. case plugin2.SINK:
  284. if err := meta.ReadSinkMetaFile(path.Join(rr.pluginConfDir, plugin2.PluginTypes[t], name+`.json`), true); nil != err {
  285. conf.Log.Errorf("readSinkFile:%v", err)
  286. }
  287. case plugin2.SOURCE:
  288. isScan := true
  289. isLookup := true
  290. _, err := rr.Source(name)
  291. if err != nil {
  292. isScan = false
  293. }
  294. _, err = rr.LookupSource(name)
  295. if err != nil {
  296. isLookup = false
  297. }
  298. if err := meta.ReadSourceMetaFile(path.Join(rr.pluginConfDir, plugin2.PluginTypes[t], name+`.json`), isScan, isLookup); nil != err {
  299. conf.Log.Errorf("readSourceFile:%v", err)
  300. }
  301. }
  302. return nil
  303. }
  304. // RegisterFuncs prerequisite:function plugin of name exists
  305. func (rr *Manager) RegisterFuncs(name string, functions []string) error {
  306. if len(functions) == 0 {
  307. return fmt.Errorf("property 'functions' must not be empty")
  308. }
  309. old := make([]string, 0)
  310. if ok, err := rr.funcSymbolsDb.Get(name, &old); err != nil {
  311. return err
  312. } else if ok {
  313. rr.removeSymbols(old)
  314. } else if !ok {
  315. rr.removeSymbols([]string{name})
  316. }
  317. err := rr.funcSymbolsDb.Set(name, functions)
  318. if err != nil {
  319. return err
  320. }
  321. return rr.storeSymbols(name, functions)
  322. }
  323. func (rr *Manager) Delete(t plugin2.PluginType, name string, stop bool) error {
  324. name = strings.Trim(name, " ")
  325. if name == "" {
  326. return fmt.Errorf("invalid name %s: should not be empty", name)
  327. }
  328. soPath, err := rr.getSoFilePath(t, name, true)
  329. if err != nil {
  330. return err
  331. }
  332. var results []string
  333. paths := []string{
  334. soPath,
  335. }
  336. // Find etc folder
  337. etcPath := path.Join(rr.pluginConfDir, plugin2.PluginTypes[t], name)
  338. if fi, err := os.Stat(etcPath); err == nil {
  339. if fi.Mode().IsDir() {
  340. paths = append(paths, etcPath)
  341. }
  342. }
  343. switch t {
  344. case plugin2.SOURCE:
  345. yamlPaths := path.Join(rr.pluginConfDir, plugin2.PluginTypes[plugin2.SOURCE], name+".yaml")
  346. _ = os.Remove(yamlPaths)
  347. srcJsonPath := path.Join(rr.pluginConfDir, plugin2.PluginTypes[plugin2.SOURCE], name+".json")
  348. _ = os.Remove(srcJsonPath)
  349. meta.UninstallSource(name)
  350. case plugin2.SINK:
  351. yamlPaths := path.Join(rr.pluginConfDir, plugin2.PluginTypes[plugin2.SINK], name+".yaml")
  352. _ = os.Remove(yamlPaths)
  353. sinkJsonPaths := path.Join(rr.pluginConfDir, plugin2.PluginTypes[plugin2.SINK], name+".json")
  354. _ = os.Remove(sinkJsonPaths)
  355. meta.UninstallSink(name)
  356. case plugin2.FUNCTION:
  357. funcJsonPath := path.Join(rr.pluginConfDir, plugin2.PluginTypes[plugin2.FUNCTION], name+".json")
  358. _ = os.Remove(funcJsonPath)
  359. old := make([]string, 0)
  360. if ok, err := rr.funcSymbolsDb.Get(name, &old); err != nil {
  361. return err
  362. } else if ok {
  363. rr.removeSymbols(old)
  364. err := rr.funcSymbolsDb.Delete(name)
  365. if err != nil {
  366. return err
  367. }
  368. } else if !ok {
  369. rr.removeSymbols([]string{name})
  370. }
  371. }
  372. for _, p := range paths {
  373. _, err := os.Stat(p)
  374. if err == nil {
  375. err = os.RemoveAll(p)
  376. if err != nil {
  377. results = append(results, err.Error())
  378. }
  379. } else {
  380. results = append(results, fmt.Sprintf("can't find %s", p))
  381. }
  382. }
  383. rr.removePluginInstallScript(name, t)
  384. if len(results) > 0 {
  385. return fmt.Errorf(strings.Join(results, "\n"))
  386. } else {
  387. rr.store(t, name, DELETED)
  388. if stop {
  389. go func() {
  390. time.Sleep(1 * time.Second)
  391. os.Exit(100)
  392. }()
  393. }
  394. return nil
  395. }
  396. }
  397. func (rr *Manager) GetPluginInfo(t plugin2.PluginType, name string) (map[string]interface{}, bool) {
  398. v, ok := rr.get(t, name)
  399. if strings.HasPrefix(v, "v") {
  400. v = v[1:]
  401. }
  402. if ok {
  403. r := map[string]interface{}{
  404. "name": name,
  405. "version": v,
  406. }
  407. if t == plugin2.FUNCTION {
  408. l := make([]string, 0)
  409. if ok, _ := rr.funcSymbolsDb.Get(name, &l); ok {
  410. r["functions"] = l
  411. }
  412. // ignore the error
  413. }
  414. return r, ok
  415. }
  416. return nil, false
  417. }
  418. func (rr *Manager) install(t plugin2.PluginType, name, src string, shellParas []string) (string, error) {
  419. var filenames []string
  420. tempPath := path.Join(rr.pluginDir, "temp", plugin2.PluginTypes[t], name)
  421. defer os.RemoveAll(tempPath)
  422. r, err := zip.OpenReader(src)
  423. if err != nil {
  424. return "", err
  425. }
  426. defer r.Close()
  427. haveInstallFile := false
  428. for _, file := range r.File {
  429. fileName := file.Name
  430. if fileName == "install.sh" {
  431. haveInstallFile = true
  432. }
  433. }
  434. if len(shellParas) != 0 && !haveInstallFile {
  435. return "", fmt.Errorf("have shell parameters : %s but no install.sh file", shellParas)
  436. }
  437. soPrefix := regexp.MustCompile(fmt.Sprintf(`^((%s)|(%s))(@.*)?\.so$`, name, ucFirst(name)))
  438. var soPath string
  439. var yamlFile, yamlPath, version, soName string
  440. expFiles := 1
  441. if t == plugin2.SOURCE {
  442. yamlFile = name + ".yaml"
  443. yamlPath = path.Join(rr.pluginConfDir, plugin2.PluginTypes[t], yamlFile)
  444. expFiles = 2
  445. }
  446. var revokeFiles []string
  447. defer func() {
  448. if err != nil {
  449. for _, f := range revokeFiles {
  450. os.RemoveAll(f)
  451. }
  452. }
  453. }()
  454. for _, file := range r.File {
  455. fileName := file.Name
  456. if yamlFile == fileName {
  457. err = filex.UnzipTo(file, yamlPath)
  458. if err != nil {
  459. return version, err
  460. }
  461. revokeFiles = append(revokeFiles, yamlPath)
  462. filenames = append(filenames, yamlPath)
  463. } else if fileName == name+".json" {
  464. jsonPath := path.Join(rr.pluginConfDir, plugin2.PluginTypes[t], fileName)
  465. if err := filex.UnzipTo(file, jsonPath); nil != err {
  466. conf.Log.Errorf("Failed to decompress the metadata %s file", fileName)
  467. } else {
  468. revokeFiles = append(revokeFiles, jsonPath)
  469. }
  470. } else if soPrefix.Match([]byte(fileName)) {
  471. soPath = path.Join(rr.pluginDir, plugin2.PluginTypes[t], fileName)
  472. err = filex.UnzipTo(file, soPath)
  473. if err != nil {
  474. return version, err
  475. }
  476. filenames = append(filenames, soPath)
  477. revokeFiles = append(revokeFiles, soPath)
  478. soName, version = parseName(fileName)
  479. } else if strings.HasPrefix(fileName, "etc/") {
  480. err = filex.UnzipTo(file, path.Join(rr.pluginConfDir, plugin2.PluginTypes[t], strings.Replace(fileName, "etc", name, 1)))
  481. if err != nil {
  482. return version, err
  483. }
  484. } else { // unzip other files
  485. err = filex.UnzipTo(file, path.Join(tempPath, fileName))
  486. if err != nil {
  487. return version, err
  488. }
  489. }
  490. }
  491. if len(filenames) != expFiles {
  492. err = fmt.Errorf("invalid zip file: so file or conf file is missing")
  493. return version, err
  494. } else if haveInstallFile {
  495. // run install script if there is
  496. shell := make([]string, len(shellParas))
  497. copy(shell, shellParas)
  498. spath := path.Join(tempPath, "install.sh")
  499. shell = append(shell, spath)
  500. if 1 != len(shell) {
  501. copy(shell[1:], shell[0:])
  502. shell[0] = spath
  503. }
  504. conf.Log.Infof("run install script %s", strings.Join(shell, " "))
  505. cmd := exec.Command("/bin/sh", shell...)
  506. var outb, errb bytes.Buffer
  507. cmd.Stdout = &outb
  508. cmd.Stderr = &errb
  509. err := cmd.Run()
  510. if err != nil {
  511. conf.Log.Infof(`err:%v stdout:%s stderr:%s`, err, outb.String(), errb.String())
  512. return version, err
  513. }
  514. conf.Log.Infof(`run install script:%s`, outb.String())
  515. }
  516. if !conf.IsTesting {
  517. // load the runtime first
  518. _, err = manager.loadRuntime(t, soName, soPath, "")
  519. if err != nil {
  520. return version, err
  521. }
  522. }
  523. conf.Log.Infof("install %s plugin %s", plugin2.PluginTypes[t], name)
  524. return version, nil
  525. }
  526. // binder factory implementations
  527. func (rr *Manager) Source(name string) (api.Source, error) {
  528. nf, err := rr.loadRuntime(plugin2.SOURCE, name, "", "")
  529. if err != nil {
  530. return nil, err
  531. }
  532. if nf == nil {
  533. return nil, nil
  534. }
  535. switch t := nf.(type) {
  536. case api.Source:
  537. return t, nil
  538. case func() api.Source:
  539. return t(), nil
  540. default:
  541. return nil, fmt.Errorf("exported symbol %s is not type of api.Source or function that return api.Source", t)
  542. }
  543. }
  544. func (rr *Manager) SourcePluginInfo(name string) (plugin2.EXTENSION_TYPE, string, string) {
  545. _, ok := rr.GetPluginVersionBySymbol(plugin2.SOURCE, name)
  546. if ok {
  547. pluginName, _ := rr.GetPluginBySymbol(plugin2.SOURCE, name)
  548. installScript := ""
  549. pluginKey := plugin2.PluginTypes[plugin2.SOURCE] + "_" + pluginName
  550. rr.plgInstallDb.Get(pluginKey, &installScript)
  551. return plugin2.NATIVE_EXTENSION, pluginKey, installScript
  552. } else {
  553. return plugin2.NONE_EXTENSION, "", ""
  554. }
  555. }
  556. func (rr *Manager) LookupSource(name string) (api.LookupSource, error) {
  557. nf, err := rr.loadRuntime(plugin2.SOURCE, name, "", ucFirst(name)+"Lookup")
  558. if err != nil {
  559. return nil, err
  560. }
  561. if nf == nil {
  562. return nil, nil
  563. }
  564. switch t := nf.(type) {
  565. case api.LookupSource:
  566. return t, nil
  567. case func() api.LookupSource:
  568. return t(), nil
  569. default:
  570. return nil, fmt.Errorf("exported symbol %s is not type of api.LookupSource or function that return api.LookupSource", t)
  571. }
  572. }
  573. func (rr *Manager) Sink(name string) (api.Sink, error) {
  574. nf, err := rr.loadRuntime(plugin2.SINK, name, "", "")
  575. if err != nil {
  576. return nil, err
  577. }
  578. if nf == nil {
  579. return nil, nil
  580. }
  581. var s api.Sink
  582. switch t := nf.(type) {
  583. case api.Sink:
  584. s = t
  585. case func() api.Sink:
  586. s = t()
  587. default:
  588. return nil, fmt.Errorf("exported symbol %s is not type of api.Sink or function that return api.Sink", t)
  589. }
  590. return s, nil
  591. }
  592. func (rr *Manager) SinkPluginInfo(name string) (plugin2.EXTENSION_TYPE, string, string) {
  593. _, ok := rr.GetPluginVersionBySymbol(plugin2.SINK, name)
  594. if ok {
  595. pluginName, _ := rr.GetPluginBySymbol(plugin2.SINK, name)
  596. installScript := ""
  597. pluginKey := plugin2.PluginTypes[plugin2.SINK] + "_" + pluginName
  598. rr.plgInstallDb.Get(pluginKey, &installScript)
  599. return plugin2.NATIVE_EXTENSION, pluginKey, installScript
  600. } else {
  601. return plugin2.NONE_EXTENSION, "", ""
  602. }
  603. }
  604. func (rr *Manager) Function(name string) (api.Function, error) {
  605. nf, err := rr.loadRuntime(plugin2.FUNCTION, name, "", "")
  606. if err != nil {
  607. return nil, err
  608. }
  609. if nf == nil {
  610. return nil, nil
  611. }
  612. var s api.Function
  613. switch t := nf.(type) {
  614. case api.Function:
  615. s = t
  616. case func() api.Function:
  617. s = t()
  618. default:
  619. return nil, fmt.Errorf("exported symbol %s is not type of api.Function or function that return api.Function", t)
  620. }
  621. return s, nil
  622. }
  623. func (rr *Manager) HasFunctionSet(name string) bool {
  624. _, ok := rr.get(plugin2.FUNCTION, name)
  625. return ok
  626. }
  627. func (rr *Manager) FunctionPluginInfo(funcName string) (plugin2.EXTENSION_TYPE, string, string) {
  628. pluginName, ok := rr.GetPluginBySymbol(plugin2.FUNCTION, funcName)
  629. if ok {
  630. installScript := ""
  631. pluginKey := plugin2.PluginTypes[plugin2.FUNCTION] + "_" + pluginName
  632. rr.plgInstallDb.Get(pluginKey, &installScript)
  633. return plugin2.NATIVE_EXTENSION, pluginKey, installScript
  634. } else {
  635. return plugin2.NONE_EXTENSION, "", ""
  636. }
  637. }
  638. func (rr *Manager) ConvName(name string) (string, bool) {
  639. _, ok := rr.GetPluginBySymbol(plugin2.FUNCTION, name)
  640. if ok {
  641. return name, true
  642. }
  643. return name, false
  644. }
  645. // If not found, return nil,nil; Other errors return nil, err
  646. func (rr *Manager) loadRuntime(t plugin2.PluginType, soName, soFilepath, symbolName string) (plugin.Symbol, error) {
  647. ptype := plugin2.PluginTypes[t]
  648. key := ptype + "/" + soName
  649. var (
  650. plug *plugin.Plugin
  651. ok bool
  652. err error
  653. )
  654. rr.RLock()
  655. plug, ok = rr.runtime[key]
  656. rr.RUnlock()
  657. if !ok {
  658. var soPath string
  659. if soFilepath != "" {
  660. soPath = soFilepath
  661. } else {
  662. mod, err := rr.getSoFilePath(t, soName, false)
  663. if err != nil {
  664. conf.Log.Debugf(fmt.Sprintf("cannot find the native plugin %s in path: %v", soName, err))
  665. return nil, nil
  666. }
  667. soPath = mod
  668. }
  669. conf.Log.Debugf("Opening plugin %s", soPath)
  670. plug, err = plugin.Open(soPath)
  671. if err != nil {
  672. conf.Log.Errorf(fmt.Sprintf("plugin %s open error: %v", soName, err))
  673. return nil, fmt.Errorf("cannot open %s: %v", soPath, err)
  674. }
  675. rr.Lock()
  676. rr.runtime[key] = plug
  677. rr.Unlock()
  678. conf.Log.Debugf("Successfully open plugin %s", soPath)
  679. }
  680. if symbolName == "" {
  681. symbolName = ucFirst(soName)
  682. }
  683. conf.Log.Debugf("Loading symbol %s", symbolName)
  684. nf, err := plug.Lookup(symbolName)
  685. if err != nil {
  686. conf.Log.Warnf(fmt.Sprintf("cannot find symbol %s, please check if it is exported: %v", symbolName, err))
  687. return nil, nil
  688. }
  689. conf.Log.Debugf("Successfully look-up plugin %s", symbolName)
  690. return nf, nil
  691. }
  692. // Return the lowercase version of so name. It may be upper case in path.
  693. func (rr *Manager) getSoFilePath(t plugin2.PluginType, name string, isSoName bool) (string, error) {
  694. var (
  695. v string
  696. soname string
  697. ok bool
  698. )
  699. // We must identify plugin or symbol when deleting function plugin
  700. if isSoName {
  701. soname = name
  702. } else {
  703. soname, ok = rr.GetPluginBySymbol(t, name)
  704. if !ok {
  705. return "", errorx.NewWithCode(errorx.NOT_FOUND, fmt.Sprintf("invalid symbol name %s: not exist", name))
  706. }
  707. }
  708. v, ok = rr.get(t, soname)
  709. if !ok {
  710. return "", errorx.NewWithCode(errorx.NOT_FOUND, fmt.Sprintf("invalid name %s: not exist", soname))
  711. }
  712. soFile := soname + ".so"
  713. if v != "" {
  714. soFile = fmt.Sprintf("%s@%s.so", soname, v)
  715. }
  716. p := path.Join(rr.pluginDir, plugin2.PluginTypes[t], soFile)
  717. if _, err := os.Stat(p); err != nil {
  718. p = path.Join(rr.pluginDir, plugin2.PluginTypes[t], ucFirst(soFile))
  719. }
  720. if _, err := os.Stat(p); err != nil {
  721. return "", errorx.NewWithCode(errorx.NOT_FOUND, fmt.Sprintf("cannot find .so file for plugin %s", soname))
  722. }
  723. return p, nil
  724. }
  725. func parseName(n string) (string, string) {
  726. result := strings.Split(n, ".so")
  727. result = strings.Split(result[0], "@")
  728. name := lcFirst(result[0])
  729. if len(result) > 1 {
  730. return name, result[1]
  731. }
  732. return name, ""
  733. }
  734. func ucFirst(str string) string {
  735. for i, v := range str {
  736. return string(unicode.ToUpper(v)) + str[i+1:]
  737. }
  738. return ""
  739. }
  740. func lcFirst(str string) string {
  741. for i, v := range str {
  742. return string(unicode.ToLower(v)) + str[i+1:]
  743. }
  744. return ""
  745. }
  746. func (rr *Manager) UninstallAllPlugins() {
  747. keys, err := rr.plgInstallDb.Keys()
  748. if err != nil {
  749. return
  750. }
  751. for _, v := range keys {
  752. plgType := plugin2.PluginTypeMap[strings.Split(v, "_")[0]]
  753. plgName := strings.Split(v, "_")[1]
  754. _ = rr.Delete(plgType, plgName, false)
  755. }
  756. }
  757. func (rr *Manager) GetAllPlugins() map[string]string {
  758. allPlgs, err := rr.plgInstallDb.All()
  759. if err != nil {
  760. return nil
  761. }
  762. delete(allPlgs, BOOT_INSTALL)
  763. return allPlgs
  764. }
  765. func (rr *Manager) GetAllPluginsStatus() map[string]string {
  766. allPlgs, err := rr.plgStatusDb.All()
  767. if err != nil {
  768. return nil
  769. }
  770. return allPlgs
  771. }
  772. const BOOT_INSTALL = "$boot_install"
  773. // PluginImport save the plugin install information and wait for restart
  774. func (rr *Manager) PluginImport(plugins map[string]string) error {
  775. if len(plugins) == 0 {
  776. return nil
  777. }
  778. for k, v := range plugins {
  779. err := rr.plgInstallDb.Set(k, v)
  780. if err != nil {
  781. return err
  782. }
  783. }
  784. // set the flag to install the plugins when eKuiper reboot
  785. err := rr.plgInstallDb.Set(BOOT_INSTALL, BOOT_INSTALL)
  786. if err != nil {
  787. return err
  788. }
  789. return nil
  790. }
  791. // PluginPartialImport compare the plugin to be installed and the one in database
  792. // if not exist in database, install;
  793. // if exist, ignore
  794. func (rr *Manager) PluginPartialImport(plugins map[string]string) map[string]string {
  795. errMap := map[string]string{}
  796. for k, v := range plugins {
  797. plugInScript := ""
  798. found, _ := rr.plgInstallDb.Get(k, &plugInScript)
  799. if !found {
  800. err := rr.pluginRegisterForImport(k, v)
  801. if err != nil {
  802. errMap[k] = err.Error()
  803. }
  804. }
  805. }
  806. return errMap
  807. }
  808. func (rr *Manager) hasInstallFlag() bool {
  809. val := ""
  810. found, _ := rr.plgInstallDb.Get(BOOT_INSTALL, &val)
  811. return found
  812. }
  813. func (rr *Manager) clearInstallFlag() {
  814. _ = rr.plgInstallDb.Delete(BOOT_INSTALL)
  815. }
  816. func (rr *Manager) pluginRegisterForImport(key, script string) error {
  817. plgType := plugin2.PluginTypeMap[strings.Split(key, "_")[0]]
  818. sd := plugin2.NewPluginByType(plgType)
  819. err := json.Unmarshal(cast.StringToBytes(script), &sd)
  820. if err != nil {
  821. return err
  822. }
  823. err = rr.Register(plgType, sd)
  824. if err != nil {
  825. conf.Log.Errorf(`install native plugin %s error: %v`, key, err)
  826. return err
  827. }
  828. return nil
  829. }
  830. func (rr *Manager) pluginInstallWhenReboot() {
  831. allPlgs, err := rr.plgInstallDb.All()
  832. if err != nil {
  833. return
  834. }
  835. delete(allPlgs, BOOT_INSTALL)
  836. _ = rr.plgStatusDb.Clean()
  837. for k, v := range allPlgs {
  838. err := rr.pluginRegisterForImport(k, v)
  839. _ = rr.plgStatusDb.Set(k, err.Error())
  840. }
  841. }