manager.go 9.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359
  1. // Copyright 2023 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. package wasm
  15. import (
  16. "archive/zip"
  17. "bytes"
  18. "encoding/json"
  19. "fmt"
  20. "io/ioutil"
  21. "os"
  22. "os/exec"
  23. "path"
  24. "path/filepath"
  25. "strings"
  26. "sync"
  27. "github.com/second-state/WasmEdge-go/wasmedge"
  28. "github.com/lf-edge/ekuiper/internal/conf"
  29. "github.com/lf-edge/ekuiper/internal/pkg/filex"
  30. "github.com/lf-edge/ekuiper/internal/pkg/httpx"
  31. "github.com/lf-edge/ekuiper/internal/plugin"
  32. "github.com/lf-edge/ekuiper/internal/plugin/wasm/runtime"
  33. )
  34. var manager *Manager
  35. type Manager struct {
  36. pluginDir string
  37. etcDir string
  38. reg *registry
  39. }
  40. func InitManager() (*Manager, error) {
  41. wasmedge.LoadPluginDefaultPaths()
  42. pluginDir, err := conf.GetPluginsLoc()
  43. if err != nil {
  44. fmt.Println("[internal][wasm] cannot find plugins folder:", err)
  45. return nil, fmt.Errorf("cannot find plugins folder: %s", err)
  46. }
  47. etcDir, err := conf.GetConfLoc()
  48. if err != nil {
  49. fmt.Println("[internal][plugin][wasm] cannot find etc folder: ", err)
  50. return nil, fmt.Errorf("cannot find etc folder: %s", err)
  51. }
  52. // fmt.Println("[internal][plugin][wasm][InitManager] etcDir: ", etcDir)
  53. registry := &registry{
  54. RWMutex: sync.RWMutex{},
  55. plugins: make(map[string]*PluginInfo),
  56. functions: make(map[string]string),
  57. }
  58. // Read plugin info from file system
  59. pluginDir = filepath.Join(pluginDir, "wasm")
  60. fmt.Println("[internal][plugin][wasm][InitManager] pluginDir: ", pluginDir)
  61. m := &Manager{
  62. pluginDir: pluginDir,
  63. etcDir: etcDir,
  64. reg: registry,
  65. }
  66. err = m.syncRegistry()
  67. if err != nil {
  68. // fmt.Println("[internal][plugin][wasm][InitManager] syncRegistry err: ", err)
  69. return nil, err
  70. }
  71. manager = m
  72. return m, nil
  73. }
  74. func MockManager(plugins map[string]*PluginInfo) (*Manager, error) {
  75. wasmedge.LoadPluginDefaultPaths()
  76. registry := &registry{
  77. RWMutex: sync.RWMutex{},
  78. plugins: make(map[string]*PluginInfo),
  79. functions: make(map[string]string),
  80. }
  81. for name, pi := range plugins {
  82. err := pi.Validate(name)
  83. if err != nil {
  84. return nil, err
  85. }
  86. wasmPath := filepath.Join(name + ".wasm")
  87. fmt.Println("wasmPath:", wasmPath)
  88. pi.WasmFile = wasmPath
  89. registry.plugins[name] = pi
  90. for _, s := range pi.Functions {
  91. registry.functions[s] = name
  92. }
  93. }
  94. return &Manager{reg: registry}, nil
  95. }
  96. func (m *Manager) syncRegistry() error {
  97. files, err := ioutil.ReadDir(m.pluginDir)
  98. if err != nil {
  99. return fmt.Errorf("read path '%s' error: %v", m.pluginDir, err)
  100. }
  101. for _, file := range files {
  102. if file.IsDir() { // is a Dir
  103. err := m.parsePlugin(file.Name())
  104. if err != nil {
  105. conf.Log.Warn(err)
  106. }
  107. filename := file.Name()
  108. err = m.parsePlugin(filename)
  109. if err != nil {
  110. conf.Log.Warn(err)
  111. }
  112. } else {
  113. conf.Log.Warnf("find file `%s`, wasm plugin must be a directory", file.Name())
  114. }
  115. }
  116. return nil
  117. }
  118. func (m *Manager) parsePlugin(name string) error {
  119. pi, err := m.parsePluginJson(name)
  120. if err != nil {
  121. return err
  122. }
  123. return m.doRegistry(name, pi, true)
  124. }
  125. func (m *Manager) parsePluginJson(name string) (*PluginInfo, error) {
  126. jsonPath := filepath.Join(m.pluginDir, name, name+".json")
  127. wasmPath := filepath.Join(m.pluginDir, name, name+".wasm")
  128. pi := &PluginInfo{PluginMeta: runtime.PluginMeta{Name: name}}
  129. pi.WasmFile = wasmPath
  130. err := filex.ReadJsonUnmarshal(jsonPath, pi)
  131. if err != nil {
  132. return nil, fmt.Errorf("cannot read json file `%s` when loading wasm plugins: %v", jsonPath, err)
  133. }
  134. if err := pi.Validate(name); err != nil {
  135. return nil, err
  136. }
  137. if result, ok := m.reg.Get(pi.Name); ok {
  138. return nil, fmt.Errorf("wasm plugin %s already exists. result : %s", pi.Name, result)
  139. }
  140. return pi, nil
  141. }
  142. func (m *Manager) Register(p plugin.Plugin) error {
  143. name, uri, shellParas := p.GetName(), p.GetFile(), p.GetShellParas()
  144. name = strings.Trim(name, " ")
  145. if name == " " {
  146. return fmt.Errorf("invalid name %s: should not be empty", name)
  147. }
  148. if !httpx.IsValidUrl(uri) || !strings.HasSuffix(uri, ".zip") {
  149. return fmt.Errorf("invalid uri %s", uri)
  150. }
  151. fmt.Println("name :", name)
  152. if _, ok := m.reg.Get(name); ok {
  153. return fmt.Errorf("invalid name %s: duplicate", name)
  154. }
  155. zipPath := path.Join(m.pluginDir, name+".zip")
  156. // clean up: delete zip file and unzip files in error
  157. defer os.Remove(zipPath)
  158. // download
  159. err := httpx.DownloadFile(zipPath, uri)
  160. if err != nil {
  161. return fmt.Errorf("fail to download file %s: %s", uri, err)
  162. }
  163. // unzip and copy to destination
  164. err = m.install(name, zipPath, shellParas)
  165. if err != nil { // Revert for any errors
  166. return fmt.Errorf("fail to install plugin: %s", err)
  167. }
  168. return nil
  169. }
  170. func (m *Manager) doRegistry(name string, pi *PluginInfo, isInit bool) error {
  171. m.reg.Set(name, pi)
  172. //if !isInit {
  173. // for _, s := range pi.Functions {
  174. // if err := meta.ReadFuncMetaFile(path.Join(m.etcDir, plugin.PluginTypes[plugin.FUNCTION], s+`.json`), true); nil != err {
  175. // conf.Log.Errorf("read function json file:%v", err)
  176. // }
  177. // }
  178. //}
  179. conf.Log.Infof("[doRegistry] Installed wasm plugin %s successfully", name)
  180. return nil
  181. }
  182. func (m *Manager) GetPluginMeta(pt plugin.PluginType, symbolName string) (*runtime.PluginMeta, bool) {
  183. pname, ok := m.reg.GetSymbol(pt, symbolName)
  184. if !ok {
  185. return nil, false
  186. }
  187. pinfo, ok := m.reg.Get(pname)
  188. if !ok {
  189. return nil, false
  190. }
  191. return &pinfo.PluginMeta, true
  192. }
  193. func (m *Manager) GetPluginInfo(pluginName string) (*PluginInfo, bool) {
  194. pinfo, ok := m.reg.Get(pluginName)
  195. if !ok {
  196. return nil, false
  197. }
  198. return pinfo, true
  199. }
  200. // registry install
  201. func (m *Manager) install(name, src string, shellParas []string) (resultErr error) {
  202. var (
  203. jsonName = name + ".json"
  204. // wasmName = name + ".wasm"
  205. pluginTarget = filepath.Join(m.pluginDir, name)
  206. // The map of install files. Used to check if all required files are installed and for reverting
  207. installedMap = make(map[string]string)
  208. requiredFiles = []string{jsonName}
  209. )
  210. defer func() {
  211. // remove all installed files if err happens
  212. if resultErr != nil {
  213. for _, p := range installedMap {
  214. _ = os.Remove(p)
  215. }
  216. _ = os.Remove(pluginTarget)
  217. }
  218. }()
  219. r, err := zip.OpenReader(src)
  220. if err != nil {
  221. return err
  222. }
  223. defer r.Close()
  224. var pi *PluginInfo
  225. // Parse json file
  226. for _, file := range r.File {
  227. if file.Name == jsonName {
  228. jf, err := file.Open()
  229. if err != nil {
  230. err = fmt.Errorf("invalid json file %s: %s", jsonName, err)
  231. return err
  232. }
  233. pi = &PluginInfo{PluginMeta: runtime.PluginMeta{Name: name}}
  234. allBytes, err := ioutil.ReadAll(jf)
  235. if err != nil {
  236. return err
  237. }
  238. err = json.Unmarshal(allBytes, pi)
  239. if err != nil {
  240. return err
  241. }
  242. }
  243. }
  244. //if pi.WasmFile == "" {
  245. // return fmt.Errorf("missing or invalid wasm file %s", pi.WasmFile)
  246. //}
  247. if pi == nil {
  248. return fmt.Errorf("missing or invalid json file %s", jsonName)
  249. }
  250. if err = pi.Validate(name); err != nil {
  251. return err
  252. }
  253. if _, ok := m.reg.Get(pi.Name); ok {
  254. return fmt.Errorf("wasm plugin %s already exists", pi.Name)
  255. }
  256. // file copying
  257. d := filepath.Clean(pluginTarget)
  258. if _, err := os.Stat(d); os.IsNotExist(err) {
  259. err = os.MkdirAll(d, 0o755)
  260. if err != nil {
  261. return err
  262. }
  263. }
  264. needInstall := false
  265. target := ""
  266. for _, file := range r.File {
  267. fileName := file.Name
  268. if strings.HasPrefix(fileName, "sources/") || strings.HasPrefix(fileName, "sinks/") || strings.HasPrefix(fileName, "functions/") {
  269. target = path.Join(m.etcDir, fileName)
  270. } else {
  271. target = path.Join(pluginTarget, fileName)
  272. if fileName == "install.sh" {
  273. needInstall = true
  274. }
  275. }
  276. err = filex.UnzipTo(file, target)
  277. if err != nil {
  278. return err
  279. }
  280. if !file.FileInfo().IsDir() {
  281. installedMap[fileName] = target
  282. }
  283. }
  284. // Check if all files installed
  285. for _, rf := range requiredFiles {
  286. if _, ok := installedMap[rf]; !ok {
  287. return fmt.Errorf("missing %s", rf)
  288. }
  289. }
  290. if needInstall {
  291. // run install script if there is
  292. spath := path.Join(pluginTarget, "install.sh")
  293. shellParas = append(shellParas, spath)
  294. if 1 != len(shellParas) {
  295. copy(shellParas[1:], shellParas[0:])
  296. shellParas[0] = spath
  297. }
  298. cmd := exec.Command("/bin/sh", shellParas...)
  299. conf.Log.Infof("run install script %s", strings.Join(shellParas, " "))
  300. var outb, errb bytes.Buffer
  301. cmd.Stdout = &outb
  302. cmd.Stderr = &errb
  303. cmd.Dir = pluginTarget
  304. err = cmd.Run()
  305. if err != nil {
  306. return fmt.Errorf(`err:%v stdout:%s stderr:%s`, err, outb.String(), errb.String())
  307. } else {
  308. conf.Log.Infof(`install script ouput: %s`, outb.String())
  309. }
  310. }
  311. return m.doRegistry(name, pi, false)
  312. }
  313. // delete
  314. func (m *Manager) Delete(name string) error {
  315. pinfo, ok := m.reg.Get(name)
  316. if !ok {
  317. return fmt.Errorf("wasm plugin %s is not found", name)
  318. }
  319. // unregister the plugin
  320. m.reg.Delete(name)
  321. // delete files and uninstall metas
  322. for _, s := range pinfo.Functions {
  323. p := path.Join(m.etcDir, plugin.PluginTypes[plugin.FUNCTION], s+".json")
  324. os.Remove(p)
  325. }
  326. _ = os.RemoveAll(path.Join(m.pluginDir, name))
  327. return nil
  328. }
  329. func (m *Manager) List() []*PluginInfo {
  330. return m.reg.List()
  331. }