Миграция#

В организациях может возникнуть необходимость мигрировать платформу Astra Automation с одних узлов на другие. При этом часто изменяются доменные имена и IP-адреса узлов платформы.

Чтобы выполнить такую миграцию, следует воспользоваться функциональностью утилиты aa-setup. Здесь рассматривается пример миграции платформы Astra Automation с одной конфигурации на другую.

Важно

Допускается миграция платформы между конфигурациями с разным количеством узлов.

Пусть исходная конфигурация платформы имеет следующие параметры:

Развернут кластер Automation Controller из трех узлов:

Узел	Назначение	FQDN	IP-адрес
`node1`	Управляющий узел	`node1.example.com`	`192.168.56.11`
`node2`	Управляющий узел	`node2.example.com`	`192.168.56.12`
`node3`	Узел СУБД	`node3.example.com`	`192.168.56.13`

Для администрирования узлов используется учетная запись administrator.
Сервер СУБД PostgreSQL развернут средствами платформы.

Далее эта платформа будет называться исходной платформой, а соответствующий ей установочный узел – исходным установочным узлом.

Пусть целевая конфигурация платформы имеет следующие параметры:

Для развертывания платформы подготовлены три узла:

Узел	Назначение	FQDN	IP-адрес
`aac1`	Управляющий узел	`aac1.example.com`	`10.120.0.11`
`aac2`	Управляющий узел	`aac2.example.com`	`10.120.0.12`
`rdbs`	Узел СУБД	`rdbs.example.com`	`10.120.0.101`

Установочный узел и узлы платформы настроены согласно инструкций из документа Подготовка узлов.
Для администрирования узлов платформы используется учетная запись devops.
Сервер СУБД PostgreSQL будет развернут средствами платформы.

Далее эта платформа будет называться целевой платформой, а соответствующий ей установочный узел – целевым установочным узлом.

Совет

В качестве целевого установочного узла можно использовать исходный установочный узел.

Создание резервной копии#

Для создания резервной копии подключитесь к исходному установочному узлу и выполните следующие действия:

Перейдите в каталог /opt/rbta/aa/astra-automation-setup/:
```
cd /opt/rbta/aa/astra-automation-setup/
```
Запустите утилиту aa-setup с аргументом --backup (-b):
```
sudo ./aa-setup --backup
```
Перейдите в каталог /tmp/backups/astra-automation/:
```
cd /tmp/backups/astra-automation/
```
Получите список файлов, упорядоченных по дате создания:
```
ls -l --sort=time
```
Если необходимо использовать другой установочный узел, любым удобным способом скопируйте на него самый новый архив с резервной копией. Например, чтобы чтобы скопировать архив по сети, выполните команду:
```
scp <backup> <user>@<host>:<dir>
```
где:
- <backup> – имя файла резервной копии, например, astra-automation-backup-28-05-2024-114821.tar.gz;
- <user> – название учетной записи пользователя целевого установочного узла;
- <host> – FQDN или IP-адрес установочного узла целевого кластера;
- <dir> – полный путь к каталогу на установочном узле целевого кластера.

Восстановление из резервной копии#

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

Создайте каталог /tmp/backups/astra-automation/:
```
mkdir -p /tmp/backups/astra-automation/
```
Скопируйте файл резервной копии в каталог /tmp/backups/astra-automation/:
```
cp <backup> /tmp/backups/astra-automation/
```
Перейдите в каталог /opt/rbta/aa/astra-automation-setup/:
```
cd /opt/rbta/aa/astra-automation-setup/
```

В файле inventory внесите изменения, соответствующие новой конфигурации платформы. Для описанной выше конфигурации файл inventory необходимо привести к следующему виду:

[automationcontroller]
aac1.example.com   ansible_host=10.120.0.11
aac2.example.com   ansible_host=10.120.0.12

[database]
drbs.example.com   ansible_host=10.120.0.101

[vars:all]
ansible_user=devops
ansible_ssh_private_key_file=/path/to/private/ssh/key
admin_username=admin
admin_email=admin@example.com
awx_install_admin_password=p@ssW0rd!
pg_host=10.120.0.101
pg_port=5432

Запустите развертывание платформы:
```
sudo ./aa-setup
```
В каталоге /tmp/ создайте структуру подкаталогов backups/astra-automation/:
```
mkdir -p /tmp/backups/astra-automation/
```
Скопируйте файл резервной копии в каталог /tmp/backups/astra-automation/ под именем astra-automation-backup-latest.tar.gz, например:
```
cp astra-automation-backup-28-05-2024-114821.tar.gz \
   /tmp/backups/astra-automation/astra-automation-backup-latest.tar.gz
```
Запустите восстановление платформы из резервной копии:
```
sudo ./aa-setup --restore
```
Для проверки корректности восстановления выполните вход в веб-интерфейс контроллера от имени администратора и проверьте содержимое разделов.

Миграция

Содержание

Миграция#

Создание резервной копии#

Восстановление из резервной копии#