mix.exs 27 KB

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