#!/usr/bin/bash

# В конфигурационном файле upgrade.conf.yaml, начиная с релиза 1.8.3, имеется булевый параметр script_auto_chmodx (по умолчанию - true), с помощью которого можно разрешить/запретить автоматическую установку бита исполнения на скрипты.

# Это пример пользовательского скрипта. Если его запустить с аргументом "config" - выполнится только то, что в секции "config". 
# Если скрипт запущен без аргументов - будет выполнено всё, что за пределами case.
case "$1" in
    config)
    # Строки ниже будут выведены и прочтены парсером перед началом обновления. Здесь находится информация, необходимая для определения момента запуска основного тела скрипта.
    # Если синтаксис корректен, всё, что за границами секции case - будет выполнено в настроенных ниже этапах (stage/substage)
    # Если cкрипт не содержит хотя бы одного из параметров, или какой-то из них некорректен, действие не будет запущено.
        echo "id: example_post_script"                                      # Уникальный идентификатора пользовательского скрипта
        echo "description: Example post-script"                             # Краткое описание пользовательского скрипта
        echo "stage: verification,installation,migration,finalizing,abort"  # Список идентификаторов стадий обновления, когда должен быть выполнен пользовательский скрипт
        echo "substage: post"                                               # Порядок выполнения скрипта на стадии. В данном случае, скрипт запускается после выполнения стадий stage 
        echo "async: false"                                                 # Параметр, является ли запуск асинхронным - "true" или "false".
        
        # Завершение всего скрипта, запущенного с аргументом "config", произойдёт благодаря "exit 0". 
        # Если "exit 0" убрать, то, помимо секции выше, будет выполнено остальное тело скрипта.
        exit 0
    ;;
    # Все действия, которые скрипт должен делать в определённый момент обновления, следует указать ниже комментария #TODO
esac

# TODO
# Расположенная ниже часть скрипта будет исполнена на этапе, настроенном в секции case "$1" in config
echo "message: Run /usr/share/astra-upgrade/scripts/example-post-script"
#echo "config: example.conf"
#echo "warning: example warning"
#echo "error: example error"
