bvobart

bvobart

How do I exit the BEAM VM with exit code 0 on top-level supervisor auto-shutdown?

Hi Elixir community :blush:

I’m having some trouble getting the BEAM VM to exit with exit code 0 upon auto-shutdown of the top-level supervisor.

For context, I’m writing an application that runs a cron job in cloud environment in a Docker container. So periodically, the cloud environment starts the container, which starts up my application, which runs a function to do some stuff. After that function exits (without raising), I want my application to exit and subsequently, I want the container to exit with exit code 0, so that the cloud environment knows that the run was successful.

Here’s my application module:

defmodule OpiniLead.Scrape.Application do
  @moduledoc """
  The application module for `OpiniLead.Scrape`.
  """
  use Task, significant: true
  use Application

  def start_link(_) do
    scrapers = Application.fetch_env!(:opinilead, :scrapers)
    Task.start_link(OpiniLead.Scrape, :run, [scrapers])
  end

  def start(_type, _args) do
    Supervisor.start_link([__MODULE__],
      strategy: :one_for_one,
      auto_shutdown: :all_significant,
      name: OpiniLead.Scrape.Supervisor
    )
  end
end

When I start this application, the task runs successfully and the supervisor exits with reason :shutdown, as expected. However, the BEAM VM seems to interpret this as a crash and exits with error code 1:

{"message":"Application opinilead exited: shutdown","@timestamp":"2025-03-03T10:56:46.693Z","ecs.version":"8.11.0","log.level":"notice","log.logger":"application_controller","log.origin":{"function":"info_exited/3","file.line":2125,"file.name":"application_controller.erl"}}
Kernel pid terminated (application_controller) ("{application_terminated,opinilead,shutdown}")

Crash dump is being written to: erl_crash.dump...done

How do I let the BEAM VM interpret :shutdown as a normal / successful exit reason so it exits without a crash (and with exit code 0)? Or should I use an entirely different approach to release a Docker image that just runs a function until completion and then exits?

Note: I’m currently using mix releases to build my application into an executable for the Docker image, which is then started with bin/opinilead start. I also have a few tests which call Application.start(:opinilead) and then verify that the supervisor starts, runs and exits, which prevents me from straight-up calling System.stop(0) in the application’s stop/1 callback.

Marked As Solved

bvobart

bvobart

Hmmmm okay yeah I was afraid of that. It still feels wrong to use System.stop in an application, it might be a good indication that applications are not the right abstraction for releasing a Docker image that runs such one-off tasks.

I found a different solution though, one that might be a bit cleaner. Simply put: use eval instead of start.

My application module now looks as follows:

defmodule OpiniLead.Scrape.Application do
  @moduledoc """
  A pseudo-application module for `OpiniLead.Scrape`.
  Usually, an Application's `start/2` callback would start a supervisor that manages a permanently
  running system. However, in this case, we want to start a one-off task, so we define a `run` function
  that can be 'eval'ed to run the scraping as a one-off task,
  e.g. `mix run -e 'OpiniLead.Scrape.Application.run()'`.
  """

  def run do
    Application.ensure_all_started(:opinilead)
    Application.fetch_env!(:opinilead, :scrapers) |> OpiniLead.Scrape.run()
  end
end

I’ve also removed the mod key from the application callback in my mix.exs file.

I can then use mix run -e 'OpiniLead.Scrape.Application.run()' to run my one-off task in development mode. For the released Docker image, I set the command to bin/opinilead eval 'OpiniLead.Scrape.Application.run()'

With that, my app runs properly, exits with exit code 0 on success and crashes neatly when fatal errors are raised.

Also Liked

benwilson512

benwilson512

Author of Craft GraphQL APIs in Elixir with Absinthe

I would use the System.stop function to shut down the node on completion.

LostKobrakai

LostKobrakai

Yeah, even a normal shutdown for a top level supervisor is an abnormal behaviour as a permanent application is not meant to have its top level supervisor exit. Even a :transient application only allows for :normal exit reason, not :shutdown.

LostKobrakai

LostKobrakai

Application.ensure_all_started(:opinilead) should do all fo that for you.

Last Post!

bvobart

bvobart

Ahhh yes that works indeed and is much simpler, thanks! I’ve updated my solution accordingly :slight_smile:

Where Next?

Popular in Questions Top

hariharasudhan94
I would like to know what is the best IDE for elixir development?
New
Darmani72
If I have a post route which an argument: post /my_post_route/:my_param1, MyController.my_post_handler How would get the post params ...
New
greenz1
I have a phoenix application from which a user can download multiple(5-6) files of size 1MB. I couldn’t find anything related to sending ...
New
siddhant3030
Hi, I have to write a raw query for one of my project. But till now I have used ecto queries and don’t have much experience writing raw ...
New
fayddelight
I tried installing elixir 1.11.2 erlang 23.3.4 via asdf in my zsh shell. Enabled the versions locally and globally. When I list them ...
New
JorisKok
I have a server on AWS, and was running a load test using artillery. When looking at the Phoenix dashboard I see the Ports going to 100% ...
New
senggen
Erlang/OTP 25 [erts-13.2.2] [source] [64-bit] [smp:8:8] [ds:8:8:10] [async-threads:1] 15:22:35.803 [error] gen_event {lager_file_backend...
New

Other popular topics Top

Qqwy
Update: How to use the Blogs & Podcasts section You can post links to your blog posts or podcasts either in one of the Official Blog...
3271 130286 1222
New
JeremM34
Hello, how can I check the Phoenix version ? Thanks !
New
jononomo
For some reason my phoenix channels are working for me in my local dev environment, but as soon as I deploy via Docker, I get a 403 error...
New
dokuzbir
I want to highlight html closing tags when i click a html tag. That works in .html files but doesnt work for html.eex templates. How can...
New
Patoshizzle
After calling mix ecto.create I get this error: 17:00:32.162 [error] GenServer #PID<0.412.0> terminating ** (Postgrex.Error) FATAL...
New
jason.o
In the code below, if the create action is not set to accept “extra_key” as an input, it errors out with a message shown above. Is there ...
New

We're in Beta

About us Mission Statement