Обновление версии#

Обновление версии Astra Automation осуществляется с помощью утилиты aa-setup. Она может обновить Astra Automation до определенной или последней версии.

Примечание

Так как возможность обновления версии с помощью утилиты aa-setup добавлена в версии 1.0-upd1, использовать ее для обновления можно будет начиная с версии 1.0-upd1. Для обновления с версии 1.0 до 1.0-upd1 воспользуйтесь универсальным способом обновления.

Подготовка к обновлению#

Необходимо обеспечить выполнение следующих условий:

  • Для обновления используется тот же установочный узел, с помощью которого происходило первоначальное развертывание платформы. Начиная с версии 1.0-upd2, вместо такого узла можно воспользоваться другим, на котором установлен пакет для развертывания Astra Automation и восстановлены необходимые настройки установочного узла.

  • На этом узле остался в неизменном виде каталог /opt/rbta/aa/astra-automation-setup/, в частности файл инвентаря /opt/rbta/aa/astra-automation-setup/inventory, описывающий состав платформы.

Обновление до последней версии#

Запустите процесс обновления одним из следующих способов:

  • Запуск с использованием привилегий суперпользователя:

    sudo ./aa-setup --upgrade
    
  • Запуск с привилегиями обычного пользователя:

    ./aa-setup --upgrade --log-path=<log_path>
    

    В значении параметра --log-path укажите путь к каталогу для сохранения журнала установки. Этот каталог должен быть доступен активному пользователю для записи.

При запуске с параметром --upgrade утилита aa-setup выполняет следующие действия:

  1. Соединяется с репозиторием, из которого был установлен Astra Automation, и считывает из него список доступных версий.

  2. Определяет версию пакета, использованного для установки или обновления Astra Automation в предыдущий раз:

    • При обновлении с версии 1.0-upd2 и более поздней текущая версия хранится в файле /etc/astra_automation.version.

    • При обновлении с более ранних версий текущая версия хранится в /etc/apt/sources.list.d/astra-automation.list.

  3. Выполняет обновление при необходимости:

    • если последняя версия в репозитории совпадает с версией, установленной на узле, то обновление не производится, aa-setup завершает свою работу;

    • если версия, установленная на узле, ниже самой последней в репозитории, то автоматически производится обновление утилиты aa-setup на самую новую версию, утилита перезапускается и обновляет Astra Automation.

Необходимо дождаться завершения выполнения команды, это может занять некоторое время. По окончании обновления в терминал выводится строка вида:

aac      : ok=233  changed=130  unreachable=0    failed=0    skipped=55    rescued=0    ignored=4

Обновление считается успешным, если в поле failed указано значение 0.

Обновление до определенной версии#

Для обновления Astra Automation до определенной версии используйте параметр --upgrade в сочетании со следующими параметрами:

  • --repo-url – когда необходимо указать репозиторий, отличный от используемого по умолчанию (dl.astralinux.ru).

    Например, для использования репозитория https://example.com/artifactory/automation-debs-for-alse аналогично тому, как тот же репозиторий использовался бы при начальной установке Astra Automation, воспользуйтесь командой:

    sudo ./aa-setup --upgrade --repo-url https://example.com/artifactory/automation-debs-for-alse
    
  • --product-version – когда необходимо обновить платформу до определенной версии.

    Если необходимо обновить платформу до определенной версии, например, 1.0-upd3, воспользуйтесь командой:

    sudo ./aa-setup --upgrade --product-version 1.0-upd3
    

Если необходимо использовать другой репозиторий и указать определенную версию воспользуйтесь командой:

sudo ./aa-setup --upgrade --repo-url https://some.company.ru/artifactory/automation-debs-for-alse --product-version 1.0-upd3

Универсальный способ обновления#

Примечание

Данный способ обновления не является рекомендуемым. Его следует использовать в крайнем случае. Например, когда невозможно удовлетворить требованиям по подготовке.

  1. Убедитесь, что в списке репозиториев APT в каталоге /etc/apt/ указана ссылка на репозиторий, cодержащий требуемую версию установочного пакета Astra Automation:

    deb https://dl.astralinux.ru/aa/aa-debs-for-alse-1.7 1.0-upd1 main
    
  2. Обновите индекс пакетов:

    sudo apt update
    
  3. Обновите пакет astra-automation-setup:

    sudo apt install --only-upgrade astra-automation-setup
    
  4. Запустите процесс обновления таким же образом, как вы изначально развертывали платформу:

    sudo ./aa-setup