Настройку деплоя сайта можно осуществить двумя способами:

1. в пользовательском интерфейсе при создании сайта
2. путем прописывания необходымих настроек в файле netlify.toml

Заготовка netlify.toml

Настройки сборки

Основной раздел с глобальными параметрами это [build], который сожержит следующие ключи:

• base основной каталог в котором лежат рабочие файлы и папки
• publish каталог (относительно базового) в котором содержатся сгенерированные файлы
• command команда сборки сайта
• environment список переменных окружения

Каждый ключ можно выделить в отдельный раздел, например переменные окружения удобнее указывать в таком виде

[build.environment]
  VARIABLE = "value"

Контекст деплоя

Настройки укзаннные в build являются глобальным контекстом, от которого наследуются другие контексты

• [context.production] настройки при деплое главной ветки, указанной при создании сайта
• [context.deploy-preview] настройки при pull/merge запросах
• [context.deploy-preview] настройки при деплое из ветри не являющейся главной

Также можно указать настройки для каждой отдельной ветки в разделе [context.<название_ветки>]

Файл конфигурации netlify.toml

Для деплоя сайта на Hugo рабочая версия файла конфигурации может выглядеть следующим образом

[build]
  base = "mmikhru/"
  publish = "public/"
  command = "hugo --gc --minify"

[context.production]
  publish = "public/"
  command = "hugo --gc --minify"
 
[context.production.environment]
  HUGO_VERSION = "0.73.0"
  HUGO_ENV = "production"
  HUGO_ENABLEGITINFO = "true"