Определяет API провайдера, загружающего конфигурацию во время запуска.

Провайдеры конфигурации обычно используются во время релизов для загрузки внешней конфигурации во время запуска системы. Это делается путем запуска виртуальной машины с минимальным количеством запущенных приложений, затем вызова всех провайдеров и перезапуска системы. Это требует изменяемого конфигурационного файла на диске, так как результаты провайдеров записываются в файловую систему. Для получения дополнительной информации о конфигурации во время выполнения см. mix release.

Множественные конфигурационные файлы

Одно из распространенных применений провайдеров конфигурации — указание нескольких конфигурационных файлов в релизе. Elixir поставляется с одним провайдером, называемым Config.Reader, который умеет обрабатывать встроенные конфигурационные файлы Elixir.

Например, представьте, что вы хотите перечислить некоторую основную конфигурацию в встроенном файле config/runtime.exs Mix, но также хотите поддерживать дополнительные конфигурационные файлы. Для этого вы можете добавить это в часть def project вашего mix.exs.

releases: [
  demo: [
    config_providers: [
      {Config.Reader, {:system, "RELEASE_ROOT", "/extra_config.exs"}}
    ]
  ]
]

Вы можете разместить этот extra_config.exs файл в вашем релизе несколькими способами:

1. Если он доступен на хосте при сборке релиза, вы можете поместить его в "rel/overlays/extra_config.exs", и он будет автоматически скопирован в корень релиза

2. Если он доступен на целевой машине во время развертывания, вы можете просто скопировать его в корень релиза как шаг в вашем развертывании

Теперь, после запуска системы, она загрузит как config/runtime.exs, так и extra_config.exs на раннем этапе процесса загрузки. Вы можете узнать больше о других опциях на Config.Reader.

Пользовательский провайдер конфигурации

Вы также можете реализовать пользовательские провайдеры конфигурации, аналогично тому, как работает Config.Reader. Например, представьте, что вам нужно загрузить некоторые параметры конфигурации из JSON-файла и загрузить их в систему. Данный провайдер конфигурации будет выглядеть следующим образом:

defmodule JSONConfigProvider do
  @behaviour Config.Provider

  # Let's pass the path to the JSON file as config
  @impl true
  def init(path) when is_binary(path), do: path

  @impl true
  def load(config, path) do
    # We need to start any app we may depend on.
    {:ok, _} = Application.ensure_all_started(:jason)

    json = path |> File.read!() |> Jason.decode!()

    Config.Reader.merge(
      config,
      my_app: [
        some_value: json["my_app_some_value"],
        another_value: json["my_app_another_value"],
      ]
    )
  end
end

Затем, при указании вашего релиза, вы можете указать провайдер в конфигурации релиза:

releases: [
  demo: [
    config_providers: [
      {JSONConfigProvider, "/etc/config.json"}
    ]
  ]
]