The post belongs to NectarCommerce and Extension Framework Awareness Series
- NectarCommerce Vision
- Extension Framework Game Plan
- Introduction to Metaprogramming
- Ecto Model Schema Extension
- Ecto Model Support Functions Extension
- Phoenix Router Extension
- Phoenix View Extension
- Running Multiple Elixir Apps Together
- Extension Approach Explained
- Learning from failures: First Experiment at NectarCommerce Extension Approach
- Developing NectarCommerce Extensions
- Building an exrm release including NectarCommerce
What will be NectarCommerce
Off-the-shelf Opensource E-commerce application for building an online store.
Provides an Extension Framework to support features not included in core as extensions.
Strives for unobtrusive parallel development of NectarCommerce and Extensions
NectarCommerce is committed to providing a ready-to-use e-commerce solution but the definition of 100% is different under different business domains. It aims to solve common use-cases as part of the project and relying on extension framework to tap the rest.
Elixir Umbrella Project
Elixir Umbrella Project is a convenience to help you organize and manage your applications. Applications inside the apps directory are still decoupled from each other. Dependencies between them must be explicitly listed. This allows them to be developed together but compiled, tested and deployed independently if required.
As NectarCommerce extensions are envisioned to be used with Nectar and would be dependent on Nectar directly or indirectly, we chose umbrella project to have Nectar, extensions_manager, user_app, and extensions apps as part of it.
We plan to use
phoenix app for extensions where web-component is needed and which would be part of the umbrella project.
user_app would be a resting ground where Nectar and extensions are evaluated for compile time requirements and prepared to be used together.
As of now,
user_app has following responsibilities:
- defining nectar as umbrella dependency
- defining available extensions as umbrella dependencies
- acting as a pass-through for all the outbound requests
Running Multiple Phoenix Applications together in an umbrella
In the end, a Phoenix application is just another OTP application with a few modifications and configuration tweaks we can expect a couple of them to run together in the same umbrella project. We just need to ensure the following :
They share the same configuration for database. While not mandatory if all the applications are utilizing the same databases, keeping the configuration in one place is a good practice. We can create a
shared_config.exsat root of umbrella with some code like this:
config :shared, :db_config, username: "shared_username", pool_size: 200
And, then in each individual application at the end of file, use:
shared_db_config = Mix.Config.read!("../../shared_config.exs")[:shared][:db_config] config :app, App.Repo, shared_db_config
Obviously this is use case dependent, some applications may not share a database and only rely on each other for method calls.
Starting the phoenix server. If we look closely at the application file for our phoenix app, we can see a supervisor for endpoint, this starts the phoenix server and binds it to the port.
We can either start the application on different ports and use an external server like nginx to dispatch on appropriate port based on business requirements.
We can also use forwards at the end of route files, using the
forward "/", App.router. from one of the application and start the server from there.
If we go with the latter approach we need to make sure that only the endpoint supervisor of current application is in supervision tree, else we will get an
address already in useerror.
Sharing static assets, we can config brunch to watch the static folder of other applications as well.
Ensure that if using the single server approach, all other applications are listed in the dependency of the main/master application. This will ensure they are compiled beforehand and can be freely used throughout the main application.
Phoenix Framework commands aware of Umbrella project
- Forwarding Requests to other Phoenix.Router
forward "/", Nectar.Router
- All paths that match the forwarded prefix will be sent to the forwarded plug.This is useful to share router between applications or even break a big router into smaller ones.
- DB Migration, mention the Ecto Repo
mix ecto.migrate -r Nectar.Repo
mix ecto.migrate -r ExtensionApp.Repo
- Listing Routes, mention the Phoenix Router
mix phoenix.routes Nectar.Router
mix phoenix.routes ExtensionApp.Router
- Using View Layout of Nectar from extensions
defdelegate render(template, assigns), to: Nectar.LayoutView
- Using Routes of Nectar in extensions
alias Nectar.Router.Helpers, as: NectarRoutes
aliasare resolved at runtime, so routes can be used but compile-time checks canâ€™t be used 🙁
Our aim with these posts is to start a dialog with the Elixir community on validity and technical soundness of our approach. We would really appreciate your feedback and reviews, and any ideas/suggestions/pull requests for improvements to our current implementation or entirely different and better way to do things to achieve the goals we have set out for NectarCommerce.
Enjoy the Elixir potion !!