mix.exs 27 KB

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