Skip to content

COMPILATION.md

Latest commit

 

History

History
87 lines (70 loc) · 3.31 KB

COMPILATION.md

File metadata and controls

87 lines (70 loc) · 3.31 KB

Compilation notes

Modules

You can decide what modules to include in your Ferron installation by copying the ferron-build.yaml file to ferron-build-override.yaml, and editing the file.

The modules are defined in the modules section, which is a list of modules to be included in the build. Below are the supported properties for the modules:

  • builtin (bool)
    • Determines if the module is built-in (in the ferron-modules-builtin crate). Default: false
  • cargo_feature (String)
    • The Cargo feature for ferron-modules-builtin crate to enable for this module. Used with built-in modules. Default: none
  • git (String)
    • The Git repository URL for the module. Default: none
  • branch (String)
    • The Git branch for the module. Used with Git repositories. Default: none
  • path (String)
    • The local path (absolute paths are recommended) to the module. Default: none
  • crate (String)
    • The name of the Rust crate corresponding to the module. Used with modules from Git or local paths. Default: none
  • loader (String)
    • The name of the struct name that will be used to load the module (usually ends with Loader). The struct must have a new method. Default: none

For example, you can specify a module from a Git repository:

modules:
  # ...
  - git: https://git.example.com/ferron-module-example.git
    crate: ferron-module-example
    loader: ExampleLoader

Or a built-in module:

modules:
  # ...
  - builtin: true
    cargo_feature: example
    loader: ExampleLoader

The modules will be executed in the order they are defined in the modules section.

DNS providers

You can also decide what DNS providers to include in your Ferron installation by copying the ferron-build.yaml file to ferron-build-override.yaml, and editing the file.

The providers are defined in the dns section, which is a list of DNS providers to be included in the build. Below are the supported properties for the DNS providers:

  • builtin (bool)
    • Determines if the module is built-in (in the ferron-modules-builtin crate). Default: false
  • id (String)
    • The DNS provider ID, as specified in the provider prop in the auto_tls_challenge directive in KDL configuration. Default: none
  • cargo_feature (String)
    • The Cargo feature for ferron-modules-builtin crate to enable for this module. Used with built-in modules. Default: none
  • git (String)
    • The Git repository URL for the module. Default: none
  • branch (String)
    • The Git branch for the module. Used with Git repositories. Default: none
  • path (String)
    • The local path (absolute paths are recommended) to the module. Default: none
  • crate (String)
    • The name of the Rust crate corresponding to the module. Used with modules from Git or local paths. Default: none
  • provider (String)
    • The name of the struct name that will be used to initialize the DNS provider (usually ends with Provider). The struct must have a with_parameters method. Default: none

For example, you can specify a provider from a Git repository:

dns:
  # ...
  - git: https://git.example.com/ferron-dns-mock.git
    crate: ferron-dns-mock
    provider: MockProvider

Or a built-in provider:

dns:
  # ...
  - builtin: true
    cargo_feature: mock
    provider: MockProvider