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

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

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

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

Для обновления используется тот же установочный узел, с помощью которого происходило первоначальное развертывание платформы. Вместо такого узла можно воспользоваться другим, на котором установлен пакет для развертывания 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 выполняет следующие действия:

Соединяется с репозиторием, из которого был установлен Astra Automation, и считывает из него список доступных версий.
Определяет версию пакета, использованного для установки или обновления Astra Automation в предыдущий раз. Текущая версия хранится в файле /etc/astra_automation.version.
Выполняет обновление при необходимости:
- если последняя версия в репозитории совпадает с версией, установленной на узле, то обновление не производится, 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 – когда необходимо обновить платформу до определенной версии.

Если необходимо обновить платформу до определенной версии <version> (например, 1.1-upd1), воспользуйтесь командой:
```
sudo ./aa-setup --upgrade --product-version <version>
```

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

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

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

Примечание

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

Убедитесь, что в списке репозиториев APT в каталоге /etc/apt/ указана ссылка на репозиторий, содержащий требуемую версию установочного пакета Astra Automation:
```
deb https://dl.astralinux.ru/aa/aa-debs-for-alse-1.7 <version> main
```
Вместо <version> необходимо подставить версию, до которой обновляется платформа, например, 1.1-upd1.

Доступные версии продукта опубликованы в таблице История обновлений.
Обновите индекс пакетов:
```
sudo apt update
```

Обновите пакет astra-automation-setup:

sudo apt install --only-upgrade astra-automation-setup

Запустите процесс обновления таким же образом, как вы изначально развертывали платформу:
```
sudo ./aa-setup
```