mix.exs 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968
  1. defmodule EMQXUmbrella.MixProject do
  2. use Mix.Project
  3. @moduledoc """
  4. The purpose of this file is to configure the release of EMQX under
  5. Mix. Since EMQX uses its own configuration conventions and startup
  6. procedures, one cannot simply use `iex -S mix`. Instead, it's
  7. recommendd to build and use the release.
  8. ## Profiles
  9. To control the profile and edition to build, we case split on the
  10. MIX_ENV value.
  11. The following profiles are valid:
  12. * `emqx`
  13. * `emqx-enterprise`
  14. * `emqx-pkg`
  15. * `emqx-enterprise-pkg`
  16. * `dev` -> same as `emqx`, for convenience
  17. ## Release Environment Variables
  18. The release build is controlled by a few environment variables.
  19. * `ELIXIR_MAKE_TAR` - If set to `yes`, will produce a `.tar.gz`
  20. tarball along with the release.
  21. """
  22. def project() do
  23. profile_info = check_profile!()
  24. version = pkg_vsn()
  25. [
  26. app: :emqx_mix,
  27. version: version,
  28. deps: deps(profile_info, version),
  29. releases: releases()
  30. ]
  31. end
  32. defp deps(profile_info, version) do
  33. # we need several overrides here because dependencies specify
  34. # other exact versions, and not ranges.
  35. [
  36. {:lc, github: "emqx/lc", tag: "0.3.2", override: true},
  37. {:redbug, "2.0.8"},
  38. {:covertool, github: "zmstone/covertool", tag: "2.0.4.1", override: true},
  39. {:typerefl, github: "ieQu1/typerefl", tag: "0.9.1", override: true},
  40. {:ehttpc, github: "emqx/ehttpc", tag: "0.4.8", override: true},
  41. {:gproc, github: "uwiger/gproc", tag: "0.8.0", override: true},
  42. {:jiffy, github: "emqx/jiffy", tag: "1.0.5", override: true},
  43. {:cowboy, github: "emqx/cowboy", tag: "2.9.0", override: true},
  44. {:esockd, github: "emqx/esockd", tag: "5.9.6", override: true},
  45. {:rocksdb, github: "emqx/erlang-rocksdb", tag: "1.7.2-emqx-9", override: true},
  46. {:ekka, github: "emqx/ekka", tag: "0.15.1", override: true},
  47. {:gen_rpc, github: "emqx/gen_rpc", tag: "2.8.1", override: true},
  48. {:grpc, github: "emqx/grpc-erl", tag: "0.6.7", override: true},
  49. {:minirest, github: "emqx/minirest", tag: "1.3.8", override: true},
  50. {:ecpool, github: "emqx/ecpool", tag: "0.5.3", override: true},
  51. {:replayq, github: "emqx/replayq", tag: "0.3.7", override: true},
  52. {:pbkdf2, github: "emqx/erlang-pbkdf2", tag: "2.0.4", override: true},
  53. # maybe forbid to fetch quicer
  54. {:emqtt,
  55. github: "emqx/emqtt", tag: "1.8.5", override: true, system_env: maybe_no_quic_env()},
  56. {:rulesql, github: "emqx/rulesql", tag: "0.1.5"},
  57. {:observer_cli, "1.7.1"},
  58. {:system_monitor, github: "ieQu1/system_monitor", tag: "3.0.3"},
  59. {:telemetry, "1.1.0"},
  60. # in conflict by emqtt and hocon
  61. {:getopt, "1.0.2", override: true},
  62. {:snabbkaffe, github: "kafka4beam/snabbkaffe", tag: "1.0.8", override: true},
  63. {:hocon, github: "emqx/hocon", tag: "0.39.4", override: true},
  64. {:emqx_http_lib, github: "emqx/emqx_http_lib", tag: "0.5.2", override: true},
  65. {:esasl, github: "emqx/esasl", tag: "0.2.0"},
  66. {:jose, github: "potatosalad/erlang-jose", tag: "1.11.2"},
  67. # in conflict by ehttpc and emqtt
  68. {:gun, github: "emqx/gun", tag: "1.3.9", override: true},
  69. # in conflict by emqx_connector and system_monitor
  70. {:epgsql, github: "emqx/epgsql", tag: "4.7.0.1", override: true},
  71. # in conflict by emqx and observer_cli
  72. {:recon, github: "ferd/recon", tag: "2.5.1", override: true},
  73. {:jsx, github: "talentdeficit/jsx", tag: "v3.1.0", override: true},
  74. # in conflict by erlavro and rocketmq
  75. {:jsone, github: "emqx/jsone", tag: "1.7.1", override: true},
  76. # dependencies of dependencies; we choose specific refs to match
  77. # what rebar3 chooses.
  78. # in conflict by gun and emqtt
  79. {:cowlib,
  80. github: "ninenines/cowlib", ref: "c6553f8308a2ca5dcd69d845f0a7d098c40c3363", override: true},
  81. # in conflict by cowboy_swagger and cowboy
  82. {:ranch,
  83. github: "ninenines/ranch", ref: "a692f44567034dacf5efcaa24a24183788594eb7", override: true},
  84. # in conflict by grpc and eetcd
  85. {:gpb, "4.19.7", override: true, runtime: false},
  86. {:hackney, github: "emqx/hackney", tag: "1.18.1-1", override: true}
  87. ] ++
  88. emqx_apps(profile_info, version) ++
  89. enterprise_deps(profile_info) ++ bcrypt_dep() ++ jq_dep() ++ quicer_dep()
  90. end
  91. defp emqx_apps(profile_info, version) do
  92. apps = umbrella_apps() ++ enterprise_apps(profile_info)
  93. set_emqx_app_system_env(apps, profile_info, version)
  94. end
  95. defp umbrella_apps() do
  96. enterprise_apps = enterprise_umbrella_apps()
  97. "apps/*"
  98. |> Path.wildcard()
  99. |> Enum.map(fn path ->
  100. app =
  101. path
  102. |> Path.basename()
  103. |> String.to_atom()
  104. {app, path: path, manager: :rebar3, override: true}
  105. end)
  106. |> Enum.reject(fn dep_spec ->
  107. dep_spec
  108. |> elem(0)
  109. |> then(&MapSet.member?(enterprise_apps, &1))
  110. end)
  111. end
  112. defp enterprise_apps(_profile_info = %{edition_type: :enterprise}) do
  113. umbrella_apps =
  114. Enum.map(enterprise_umbrella_apps(), fn app_name ->
  115. path = "apps/#{app_name}"
  116. {app_name, path: path, manager: :rebar3, override: true}
  117. end)
  118. "lib-ee/*"
  119. |> Path.wildcard()
  120. |> Enum.filter(&File.dir?/1)
  121. |> Enum.map(fn path ->
  122. app =
  123. path
  124. |> Path.basename()
  125. |> String.to_atom()
  126. {app, path: path, manager: :rebar3, override: true}
  127. end)
  128. |> Enum.concat(umbrella_apps)
  129. end
  130. defp enterprise_apps(_profile_info) do
  131. []
  132. end
  133. # need to remove those when listing `/apps/`...
  134. defp enterprise_umbrella_apps() do
  135. MapSet.new([
  136. :emqx_bridge_kafka,
  137. :emqx_bridge_gcp_pubsub,
  138. :emqx_bridge_cassandra,
  139. :emqx_bridge_opents,
  140. :emqx_bridge_clickhouse,
  141. :emqx_bridge_dynamo,
  142. :emqx_bridge_hstreamdb,
  143. :emqx_bridge_influxdb,
  144. :emqx_bridge_iotdb,
  145. :emqx_bridge_matrix,
  146. :emqx_bridge_mongodb,
  147. :emqx_bridge_mysql,
  148. :emqx_bridge_pgsql,
  149. :emqx_bridge_redis,
  150. :emqx_bridge_rocketmq,
  151. :emqx_bridge_tdengine,
  152. :emqx_bridge_timescale,
  153. :emqx_bridge_sqlserver,
  154. :emqx_bridge_pulsar,
  155. :emqx_oracle,
  156. :emqx_bridge_oracle,
  157. :emqx_bridge_rabbitmq
  158. ])
  159. end
  160. defp enterprise_deps(_profile_info = %{edition_type: :enterprise}) do
  161. [
  162. {:hstreamdb_erl, github: "hstreamdb/hstreamdb_erl", tag: "0.2.5"},
  163. {:influxdb, github: "emqx/influxdb-client-erl", tag: "1.1.9", override: true},
  164. {:wolff, github: "kafka4beam/wolff", tag: "1.7.5"},
  165. {:kafka_protocol, github: "kafka4beam/kafka_protocol", tag: "4.1.2", override: true},
  166. {:brod_gssapi, github: "kafka4beam/brod_gssapi", tag: "v0.1.0"},
  167. {:brod, github: "kafka4beam/brod", tag: "3.16.8"},
  168. {:snappyer, "1.2.8", override: true},
  169. {:crc32cer, "0.1.8", override: true},
  170. {:supervisor3, "1.1.12", override: true},
  171. {:erlcloud, github: "emqx/erlcloud", tag: "3.5.16-emqx-1", override: true},
  172. # erlcloud's rebar.config requires rebar3 and does not support Mix,
  173. # so it tries to fetch deps from git. We need to override this.
  174. {:lhttpc, tag: "1.6.2", override: true},
  175. {:eini, "1.2.9", override: true},
  176. {:base16, "1.0.0", override: true},
  177. # end of erlcloud's deps
  178. {:opentsdb, github: "emqx/opentsdb-client-erl", tag: "v0.5.1", override: true},
  179. # The following two are dependencies of rabbit_common. They are needed here to
  180. # make mix not complain about conflicting versions
  181. {:thoas, github: "emqx/thoas", tag: "v1.0.0", override: true},
  182. {:credentials_obfuscation,
  183. github: "emqx/credentials-obfuscation", tag: "v3.2.0", override: true},
  184. {:rabbit_common,
  185. github: "emqx/rabbitmq-server",
  186. tag: "v3.11.13-emqx",
  187. sparse: "deps/rabbit_common",
  188. override: true},
  189. {:amqp_client,
  190. github: "emqx/rabbitmq-server",
  191. tag: "v3.11.13-emqx",
  192. sparse: "deps/amqp_client",
  193. override: true}
  194. ]
  195. end
  196. defp enterprise_deps(_profile_info) do
  197. []
  198. end
  199. defp set_emqx_app_system_env(apps, profile_info, version) do
  200. system_env = emqx_app_system_env(profile_info, version) ++ maybe_no_quic_env()
  201. Enum.map(
  202. apps,
  203. fn {app, opts} ->
  204. {app,
  205. Keyword.update(
  206. opts,
  207. :system_env,
  208. system_env,
  209. &Keyword.merge(&1, system_env)
  210. )}
  211. end
  212. )
  213. end
  214. def emqx_app_system_env(profile_info, version) do
  215. erlc_options(profile_info, version)
  216. |> dump_as_erl()
  217. |> then(&[{"ERL_COMPILER_OPTIONS", &1}])
  218. end
  219. defp erlc_options(%{edition_type: edition_type}, version) do
  220. [
  221. :debug_info,
  222. {:compile_info, [{:emqx_vsn, String.to_charlist(version)}]},
  223. {:d, :EMQX_RELEASE_EDITION, erlang_edition(edition_type)},
  224. {:d, :snk_kind, :msg}
  225. ]
  226. end
  227. def maybe_no_quic_env() do
  228. if not enable_quicer?() do
  229. [{"BUILD_WITHOUT_QUIC", "true"}]
  230. else
  231. []
  232. end
  233. end
  234. defp releases() do
  235. [
  236. emqx: fn ->
  237. %{
  238. release_type: release_type,
  239. package_type: package_type,
  240. edition_type: edition_type
  241. } = check_profile!()
  242. base_steps = [
  243. &make_docs(&1),
  244. :assemble,
  245. &create_RELEASES/1,
  246. &copy_files(&1, release_type, package_type, edition_type),
  247. &copy_escript(&1, "nodetool"),
  248. &copy_escript(&1, "install_upgrade.escript")
  249. ]
  250. steps =
  251. if System.get_env("ELIXIR_MAKE_TAR") == "yes" do
  252. base_steps ++ [&prepare_tar_overlays/1, :tar]
  253. else
  254. base_steps
  255. end
  256. [
  257. applications: applications(edition_type),
  258. skip_mode_validation_for: [
  259. :emqx_gateway,
  260. :emqx_gateway_stomp,
  261. :emqx_gateway_mqttsn,
  262. :emqx_gateway_coap,
  263. :emqx_gateway_lwm2m,
  264. :emqx_gateway_exproto,
  265. :emqx_dashboard,
  266. :emqx_resource,
  267. :emqx_connector,
  268. :emqx_exhook,
  269. :emqx_bridge,
  270. :emqx_modules,
  271. :emqx_management,
  272. :emqx_statsd,
  273. :emqx_retainer,
  274. :emqx_prometheus,
  275. :emqx_auto_subscribe,
  276. :emqx_slow_subs,
  277. :emqx_plugins
  278. ],
  279. steps: steps,
  280. strip_beams: false
  281. ]
  282. end
  283. ]
  284. end
  285. def applications(edition_type) do
  286. [
  287. crypto: :permanent,
  288. public_key: :permanent,
  289. asn1: :permanent,
  290. syntax_tools: :permanent,
  291. ssl: :permanent,
  292. os_mon: :permanent,
  293. inets: :permanent,
  294. compiler: :permanent,
  295. runtime_tools: :permanent,
  296. redbug: :permanent,
  297. xmerl: :permanent,
  298. hocon: :load,
  299. telemetry: :permanent,
  300. emqx: :load,
  301. emqx_conf: :load,
  302. emqx_machine: :permanent
  303. ] ++
  304. if(enable_rocksdb?(),
  305. do: [mnesia_rocksdb: :load],
  306. else: []
  307. ) ++
  308. [
  309. mnesia: :load,
  310. ekka: :load,
  311. emqx_plugin_libs: :load,
  312. esasl: :load,
  313. observer_cli: :permanent,
  314. tools: :permanent,
  315. covertool: :load,
  316. system_monitor: :load,
  317. emqx_utils: :load,
  318. emqx_http_lib: :permanent,
  319. emqx_resource: :permanent,
  320. emqx_connector: :permanent,
  321. emqx_authn: :permanent,
  322. emqx_authz: :permanent,
  323. emqx_auto_subscribe: :permanent,
  324. emqx_gateway: :permanent,
  325. emqx_gateway_stomp: :permanent,
  326. emqx_gateway_mqttsn: :permanent,
  327. emqx_gateway_coap: :permanent,
  328. emqx_gateway_lwm2m: :permanent,
  329. emqx_gateway_exproto: :permanent,
  330. emqx_exhook: :permanent,
  331. emqx_bridge: :permanent,
  332. emqx_rule_engine: :permanent,
  333. emqx_modules: :permanent,
  334. emqx_management: :permanent,
  335. emqx_dashboard: :permanent,
  336. emqx_retainer: :permanent,
  337. emqx_statsd: :permanent,
  338. emqx_prometheus: :permanent,
  339. emqx_psk: :permanent,
  340. emqx_slow_subs: :permanent,
  341. emqx_plugins: :permanent,
  342. emqx_mix: :none
  343. ] ++
  344. if(enable_quicer?(), do: [quicer: :permanent], else: []) ++
  345. if(enable_bcrypt?(), do: [bcrypt: :permanent], else: []) ++
  346. if(enable_jq?(), do: [jq: :load], else: []) ++
  347. if(is_app(:observer),
  348. do: [observer: :load],
  349. else: []
  350. ) ++
  351. if(edition_type == :enterprise,
  352. do: [
  353. emqx_license: :permanent,
  354. emqx_ee_conf: :load,
  355. emqx_ee_connector: :permanent,
  356. emqx_ee_bridge: :permanent,
  357. emqx_bridge_kafka: :permanent,
  358. emqx_bridge_pulsar: :permanent,
  359. emqx_bridge_gcp_pubsub: :permanent,
  360. emqx_bridge_cassandra: :permanent,
  361. emqx_bridge_opents: :permanent,
  362. emqx_bridge_clickhouse: :permanent,
  363. emqx_bridge_dynamo: :permanent,
  364. emqx_bridge_hstreamdb: :permanent,
  365. emqx_bridge_influxdb: :permanent,
  366. emqx_bridge_iotdb: :permanent,
  367. emqx_bridge_matrix: :permanent,
  368. emqx_bridge_mongodb: :permanent,
  369. emqx_bridge_mysql: :permanent,
  370. emqx_bridge_pgsql: :permanent,
  371. emqx_bridge_redis: :permanent,
  372. emqx_bridge_rocketmq: :permanent,
  373. emqx_bridge_tdengine: :permanent,
  374. emqx_bridge_timescale: :permanent,
  375. emqx_bridge_sqlserver: :permanent,
  376. emqx_oracle: :permanent,
  377. emqx_bridge_oracle: :permanent,
  378. emqx_bridge_rabbitmq: :permanent,
  379. emqx_ee_schema_registry: :permanent,
  380. emqx_eviction_agent: :permanent,
  381. emqx_node_rebalance: :permanent
  382. ],
  383. else: []
  384. )
  385. end
  386. defp is_app(name) do
  387. case Application.load(name) do
  388. :ok ->
  389. true
  390. {:error, {:already_loaded, _}} ->
  391. true
  392. _ ->
  393. false
  394. end
  395. end
  396. def check_profile!() do
  397. valid_envs = [
  398. :dev,
  399. :emqx,
  400. :"emqx-pkg",
  401. :"emqx-enterprise",
  402. :"emqx-enterprise-pkg"
  403. ]
  404. if Mix.env() not in valid_envs do
  405. formatted_envs =
  406. valid_envs
  407. |> Enum.map(&" * #{&1}")
  408. |> Enum.join("\n")
  409. Mix.raise("""
  410. Invalid env #{Mix.env()}. Valid options are:
  411. #{formatted_envs}
  412. """)
  413. end
  414. {
  415. release_type,
  416. package_type,
  417. edition_type
  418. } =
  419. case Mix.env() do
  420. :dev ->
  421. {:cloud, :bin, :community}
  422. :emqx ->
  423. {:cloud, :bin, :community}
  424. :"emqx-enterprise" ->
  425. {:cloud, :bin, :enterprise}
  426. :"emqx-pkg" ->
  427. {:cloud, :pkg, :community}
  428. :"emqx-enterprise-pkg" ->
  429. {:cloud, :pkg, :enterprise}
  430. end
  431. normalize_env!()
  432. %{
  433. release_type: release_type,
  434. package_type: package_type,
  435. edition_type: edition_type
  436. }
  437. end
  438. #############################################################################
  439. # Custom Steps
  440. #############################################################################
  441. defp make_docs(release) do
  442. profile = System.get_env("MIX_ENV")
  443. os_cmd("build", [profile, "docs"])
  444. release
  445. end
  446. defp copy_files(release, release_type, package_type, edition_type) do
  447. overwrite? = Keyword.get(release.options, :overwrite, false)
  448. bin = Path.join(release.path, "bin")
  449. etc = Path.join(release.path, "etc")
  450. log = Path.join(release.path, "log")
  451. plugins = Path.join(release.path, "plugins")
  452. Mix.Generator.create_directory(bin)
  453. Mix.Generator.create_directory(etc)
  454. Mix.Generator.create_directory(log)
  455. Mix.Generator.create_directory(plugins)
  456. Mix.Generator.create_directory(Path.join(etc, "certs"))
  457. Enum.each(
  458. ["mnesia", "configs", "patches", "scripts"],
  459. fn dir ->
  460. path = Path.join([release.path, "data", dir])
  461. Mix.Generator.create_directory(path)
  462. end
  463. )
  464. Mix.Generator.copy_file(
  465. "apps/emqx_authz/etc/acl.conf",
  466. Path.join(etc, "acl.conf"),
  467. force: overwrite?
  468. )
  469. # required by emqx_authz
  470. File.cp_r!(
  471. "apps/emqx/etc/certs",
  472. Path.join(etc, "certs")
  473. )
  474. profile = System.get_env("MIX_ENV")
  475. Mix.Generator.copy_file(
  476. "_build/docgen/#{profile}/emqx.conf.example",
  477. Path.join(etc, "emqx.conf.example"),
  478. force: overwrite?
  479. )
  480. # this is required by the produced escript / nodetool
  481. Mix.Generator.copy_file(
  482. Path.join(release.version_path, "start_clean.boot"),
  483. Path.join(bin, "no_dot_erlang.boot"),
  484. force: overwrite?
  485. )
  486. assigns = template_vars(release, release_type, package_type, edition_type)
  487. # This is generated by `scripts/merge-config.escript` or `make merge-config`
  488. # So, this should be run before the release.
  489. # TODO: run as a "compiler" step???
  490. render_template(
  491. "apps/emqx_conf/etc/emqx.conf.all",
  492. assigns,
  493. Path.join(etc, "emqx.conf")
  494. )
  495. if edition_type == :enterprise do
  496. render_template(
  497. "apps/emqx_conf/etc/emqx-enterprise.conf.all",
  498. assigns,
  499. Path.join(etc, "emqx-enterprise.conf")
  500. )
  501. end
  502. render_template(
  503. "rel/emqx_vars",
  504. assigns,
  505. Path.join([release.path, "releases", "emqx_vars"])
  506. )
  507. vm_args_template_path =
  508. case release_type do
  509. :cloud ->
  510. "apps/emqx/etc/vm.args.cloud"
  511. end
  512. render_template(
  513. vm_args_template_path,
  514. assigns,
  515. [
  516. Path.join(etc, "vm.args"),
  517. Path.join(release.version_path, "vm.args")
  518. ]
  519. )
  520. for name <- [
  521. "emqx",
  522. "emqx_ctl"
  523. ] do
  524. Mix.Generator.copy_file(
  525. "bin/#{name}",
  526. Path.join(bin, name),
  527. force: overwrite?
  528. )
  529. # Files with the version appended are expected by the release
  530. # upgrade script `install_upgrade.escript`
  531. Mix.Generator.copy_file(
  532. Path.join(bin, name),
  533. Path.join(bin, name <> "-#{release.version}"),
  534. force: overwrite?
  535. )
  536. end
  537. for base_name <- ["emqx", "emqx_ctl"],
  538. suffix <- ["", "-#{release.version}"] do
  539. name = base_name <> suffix
  540. File.chmod!(Path.join(bin, name), 0o755)
  541. end
  542. Mix.Generator.copy_file(
  543. "bin/node_dump",
  544. Path.join(bin, "node_dump"),
  545. force: overwrite?
  546. )
  547. File.chmod!(Path.join(bin, "node_dump"), 0o755)
  548. Mix.Generator.copy_file(
  549. "bin/emqx_cluster_rescue",
  550. Path.join(bin, "emqx_cluster_rescue"),
  551. force: overwrite?
  552. )
  553. File.chmod!(Path.join(bin, "emqx_cluster_rescue"), 0o755)
  554. render_template(
  555. "rel/BUILD_INFO",
  556. assigns,
  557. Path.join(release.version_path, "BUILD_INFO")
  558. )
  559. release
  560. end
  561. defp render_template(template, assigns, target) when is_binary(target) do
  562. render_template(template, assigns, [target])
  563. end
  564. defp render_template(template, assigns, tartgets) when is_list(tartgets) do
  565. rendered =
  566. File.read!(template)
  567. |> from_rebar_to_eex_template()
  568. |> EEx.eval_string(assigns)
  569. for target <- tartgets do
  570. File.write!(target, rendered)
  571. end
  572. end
  573. # needed by nodetool and by release_handler
  574. defp create_RELEASES(release) do
  575. apps =
  576. Enum.map(release.applications, fn {app_name, app_props} ->
  577. app_vsn = Keyword.fetch!(app_props, :vsn)
  578. app_path =
  579. "./lib"
  580. |> Path.join("#{app_name}-#{app_vsn}")
  581. |> to_charlist()
  582. {app_name, app_vsn, app_path}
  583. end)
  584. release_entry = [
  585. {
  586. :release,
  587. to_charlist(release.name),
  588. to_charlist(release.version),
  589. release.erts_version,
  590. apps,
  591. :permanent
  592. }
  593. ]
  594. release.path
  595. |> Path.join("releases")
  596. |> Path.join("RELEASES")
  597. |> File.open!([:write, :utf8], fn handle ->
  598. IO.puts(handle, "%% coding: utf-8")
  599. :io.format(handle, ~c"~tp.~n", [release_entry])
  600. end)
  601. release
  602. end
  603. defp copy_escript(release, escript_name) do
  604. [shebang, rest] =
  605. "bin/#{escript_name}"
  606. |> File.read!()
  607. |> String.split("\n", parts: 2)
  608. # the elixir version of escript + start.boot required the boot_var
  609. # RELEASE_LIB to be defined.
  610. boot_var = "%%!-boot_var RELEASE_LIB $RUNNER_ROOT_DIR/lib"
  611. # Files with the version appended are expected by the release
  612. # upgrade script `install_upgrade.escript`
  613. Enum.each(
  614. [escript_name, escript_name <> "-" <> release.version],
  615. fn name ->
  616. path = Path.join([release.path, "bin", name])
  617. File.write!(path, [shebang, "\n", boot_var, "\n", rest])
  618. end
  619. )
  620. release
  621. end
  622. # The `:tar` built-in step in Mix Release does not currently add the
  623. # `etc` directory into the resulting tarball. The workaround is to
  624. # add those to the `:overlays` key before running `:tar`.
  625. # See: https://hexdocs.pm/mix/1.13.4/Mix.Release.html#__struct__/0
  626. defp prepare_tar_overlays(release) do
  627. Map.update!(
  628. release,
  629. :overlays,
  630. &[
  631. "etc",
  632. "data",
  633. "plugins",
  634. "bin/node_dump"
  635. | &1
  636. ]
  637. )
  638. end
  639. #############################################################################
  640. # Helper functions
  641. #############################################################################
  642. defp template_vars(release, release_type, :bin = _package_type, edition_type) do
  643. [
  644. emqx_default_erlang_cookie: default_cookie(),
  645. platform_data_dir: "data",
  646. platform_etc_dir: "etc",
  647. platform_plugins_dir: "plugins",
  648. runner_bin_dir: "$RUNNER_ROOT_DIR/bin",
  649. emqx_etc_dir: "$RUNNER_ROOT_DIR/etc",
  650. runner_lib_dir: "$RUNNER_ROOT_DIR/lib",
  651. runner_log_dir: "$RUNNER_ROOT_DIR/log",
  652. runner_user: "",
  653. release_version: release.version,
  654. erts_vsn: release.erts_version,
  655. # FIXME: this is empty in `make emqx` ???
  656. erl_opts: "",
  657. emqx_description: emqx_description(release_type, edition_type),
  658. emqx_schema_mod: emqx_schema_mod(edition_type),
  659. is_elixir: "yes",
  660. is_enterprise: if(edition_type == :enterprise, do: "yes", else: "no")
  661. ] ++ build_info()
  662. end
  663. defp template_vars(release, release_type, :pkg = _package_type, edition_type) do
  664. [
  665. emqx_default_erlang_cookie: default_cookie(),
  666. platform_data_dir: "/var/lib/emqx",
  667. platform_etc_dir: "/etc/emqx",
  668. platform_plugins_dir: "/var/lib/emqx/plugins",
  669. runner_bin_dir: "/usr/bin",
  670. emqx_etc_dir: "/etc/emqx",
  671. runner_lib_dir: "$RUNNER_ROOT_DIR/lib",
  672. runner_log_dir: "/var/log/emqx",
  673. runner_user: "emqx",
  674. release_version: release.version,
  675. erts_vsn: release.erts_version,
  676. # FIXME: this is empty in `make emqx` ???
  677. erl_opts: "",
  678. emqx_description: emqx_description(release_type, edition_type),
  679. emqx_schema_mod: emqx_schema_mod(edition_type),
  680. is_elixir: "yes",
  681. is_enterprise: if(edition_type == :enterprise, do: "yes", else: "no")
  682. ] ++ build_info()
  683. end
  684. defp default_cookie() do
  685. "emqx50elixir"
  686. end
  687. defp emqx_description(release_type, edition_type) do
  688. case {release_type, edition_type} do
  689. {:cloud, :enterprise} ->
  690. "EMQX Enterprise"
  691. {:cloud, :community} ->
  692. "EMQX"
  693. end
  694. end
  695. defp emqx_schema_mod(:enterprise), do: :emqx_ee_conf_schema
  696. defp emqx_schema_mod(:community), do: :emqx_conf_schema
  697. defp bcrypt_dep() do
  698. if enable_bcrypt?(),
  699. do: [{:bcrypt, github: "emqx/erlang-bcrypt", tag: "0.6.0", override: true}],
  700. else: []
  701. end
  702. defp jq_dep() do
  703. if enable_jq?(),
  704. do: [{:jq, github: "emqx/jq", tag: "v0.3.9", override: true}],
  705. else: []
  706. end
  707. defp quicer_dep() do
  708. if enable_quicer?(),
  709. # in conflict with emqx and emqtt
  710. do: [{:quicer, github: "emqx/quic", tag: "0.0.114", override: true}],
  711. else: []
  712. end
  713. defp enable_bcrypt?() do
  714. not win32?()
  715. end
  716. defp enable_jq?() do
  717. not Enum.any?([
  718. build_without_jq?(),
  719. win32?()
  720. ]) or "1" == System.get_env("BUILD_WITH_JQ")
  721. end
  722. defp enable_quicer?() do
  723. not Enum.any?([
  724. build_without_quic?(),
  725. win32?(),
  726. centos6?(),
  727. macos?()
  728. ]) or "1" == System.get_env("BUILD_WITH_QUIC")
  729. end
  730. defp enable_rocksdb?() do
  731. not Enum.any?([
  732. build_without_rocksdb?(),
  733. raspbian?()
  734. ]) or "1" == System.get_env("BUILD_WITH_ROCKSDB")
  735. end
  736. defp pkg_vsn() do
  737. %{edition_type: edition_type} = check_profile!()
  738. basedir = Path.dirname(__ENV__.file)
  739. script = Path.join(basedir, "pkg-vsn.sh")
  740. os_cmd(script, [Atom.to_string(edition_type)])
  741. end
  742. defp os_cmd(script, args) do
  743. {str, 0} = System.cmd("bash", [script | args])
  744. String.trim(str)
  745. end
  746. defp win32?(),
  747. do: match?({:win_32, _}, :os.type())
  748. defp centos6?() do
  749. case File.read("/etc/centos-release") do
  750. {:ok, "CentOS release 6" <> _} ->
  751. true
  752. _ ->
  753. false
  754. end
  755. end
  756. defp macos?() do
  757. {:unix, :darwin} == :os.type()
  758. end
  759. defp raspbian?() do
  760. os_cmd("./scripts/get-distro.sh", []) =~ "raspbian"
  761. end
  762. defp build_without_jq?() do
  763. opt = System.get_env("BUILD_WITHOUT_JQ", "false")
  764. String.downcase(opt) != "false"
  765. end
  766. defp build_without_quic?() do
  767. opt = System.get_env("BUILD_WITHOUT_QUIC", "false")
  768. String.downcase(opt) != "false"
  769. end
  770. defp build_without_rocksdb?() do
  771. opt = System.get_env("BUILD_WITHOUT_ROCKSDB", "false")
  772. String.downcase(opt) != "false"
  773. end
  774. defp from_rebar_to_eex_template(str) do
  775. # we must not consider surrounding space in the template var name
  776. # because some help strings contain informative variables that
  777. # should not be interpolated, and those have no spaces.
  778. Regex.replace(
  779. ~r/\{\{ ([a-zA-Z0-9_]+) \}\}/,
  780. str,
  781. "<%= \\g{1} %>"
  782. )
  783. end
  784. defp build_info() do
  785. [
  786. build_info_arch: to_string(:erlang.system_info(:system_architecture)),
  787. build_info_wordsize: wordsize(),
  788. build_info_os: os_cmd("./scripts/get-distro.sh", []),
  789. build_info_erlang: otp_release(),
  790. build_info_elixir: System.version(),
  791. build_info_relform: System.get_env("EMQX_REL_FORM", "tgz")
  792. ]
  793. end
  794. # https://github.com/erlang/rebar3/blob/e3108ac187b88fff01eca6001a856283a3e0ec87/src/rebar_utils.erl#L142
  795. defp wordsize() do
  796. size =
  797. try do
  798. :erlang.system_info({:wordsize, :external})
  799. rescue
  800. ErlangError ->
  801. :erlang.system_info(:wordsize)
  802. end
  803. to_string(8 * size)
  804. end
  805. defp normalize_env!() do
  806. env =
  807. case Mix.env() do
  808. :dev ->
  809. :emqx
  810. env ->
  811. env
  812. end
  813. Mix.env(env)
  814. end
  815. # As from Erlang/OTP 17, the OTP release number corresponds to the
  816. # major OTP version number. No erlang:system_info() argument gives
  817. # the exact OTP version.
  818. # https://www.erlang.org/doc/man/erlang.html#system_info_otp_release
  819. # https://github.com/erlang/rebar3/blob/e3108ac187b88fff01eca6001a856283a3e0ec87/src/rebar_utils.erl#L572-L577
  820. defp otp_release() do
  821. major_version = System.otp_release()
  822. root_dir = to_string(:code.root_dir())
  823. [root_dir, "releases", major_version, "OTP_VERSION"]
  824. |> Path.join()
  825. |> File.read()
  826. |> case do
  827. {:error, _} ->
  828. major_version
  829. {:ok, version} ->
  830. version
  831. |> String.trim()
  832. |> String.split("**")
  833. |> List.first()
  834. end
  835. end
  836. defp dump_as_erl(term) do
  837. term
  838. |> then(&:io_lib.format("~0p", [&1]))
  839. |> :erlang.iolist_to_binary()
  840. end
  841. defp erlang_edition(:community), do: :ce
  842. defp erlang_edition(:enterprise), do: :ee
  843. end