mix.exs 28 KB

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