Откат#

Перед откатом, необходимо восстановить БД для возможности использования дашбордов предыдущей версии. Откат к предыдущей версии Indicator выполняется через Jenkins. Для отката необходимо выполнить установку предыдущей стабильной версии в соответствии с инструкцией.

При откате с версии 4.0 на 3.0, необходимо очистить конфигурации из платформы приложений-контейнеров.

Начиная с версии 4.1 для отката используются скрипты LiquiBase. Для того чтобы был возможен rollback изменений, необходимо тегировать накаты (например, по релизам) и использовать формат xml скриптов для наката.

Чтобы откатить изменения под тегом version1, необходимо выполнить команду liquibase:

java -jar liquibase-sqlplus-3.5.1.jar --liquibaseSchemaName=schema--username=dbusername --password=dbpassword--url=jdbc:postgresql://dburl:dbport/dbname --defaultSchemaName=schema--classpath=postgresql-9.4.1212.jar --driver=org.postgresql.Driver --changeLogFile=changelog.xml rollback version1

где version1 — это тег версии релиза. Теги можно посмотреть в базе в таблице databasechangelog, в столбце tag.

liquibaseSchemaName — схема, в которой liquibase создает свои 2 таблицы.

defaultSchemaName — схема, в которую необходимо накатывать изменения.

Откат с 5.0 до 4.0.5#

В части БД сохраняется обратная совместимость, то есть Indicator версии 4.0.5, можно поставить на ту же БД куда выполнялась миграция скриптами liquibase 5.0. При этом если откат БД все таки понадобится, то можно восстановить backup, сделанный перед обновлением.

  1. Восстановить backup БД нужной версии. Для этого можно воспользоваться любым из доступных инструментов, для примера ниже описан процесс восстановления БД инструментом pgAdmin:

  • Запустить pgAdmin - подключиться к серверу и кликнуть правой кнопкой мыши по базе, которую хотим восстановить.

  • В контекстном меню выбрать Restore.

  • После нажать на многоточие и выберите файл с backup.

  • Нажать Restore.

  1. Выполнить Deploy версии 4.0.5.

Если при обновлении на этапе MIGRATION_FP_CONF создавалась отдельная ветка для конфигурации 5.0 и сохранились значения и набор параметров 4.0.5, то можно воспользоваться этой же веткой для выполнения deploy Indicator 4.0.5.

Если такая ветка не создавалась, то необходимо:

  • Выполнить MIGRATION_FP_CONF.

  • Откатить версию ОТТ на ту, которая использовалась в версии 4.0.5.

  • Проверить пути к сертификатам, т.к. в версии 5.0 они изменялись для работы с Secman.

Запустить JOB Deploy с обновлениями ingress/egress/indicator.

Откат с версии 5.0 до версии 4.0.5 необходимо выполнить компонентом Deploy tools версии 1.2 (D-01.039.092).

Откат с 5.1 до 5.0#

  1. Подготовить сертификаты и secrets

  2. Запустить PIPELINE_Deploy версии 5.0 с установленным флагом MIGRATION_FP_CONF .

Если при обновлении на этапе MIGRATION_FP_CONF, создавалась отдельная ветка для конфигурации 5.1, и сохранились значения и набор параметров 5.0, то можно воспользоваться этой же веткой для выполнения deploy Indicator 5.0

Если такая ветка не создавалась, то необходимо:

  • Выполнить MIGRATION_FP_CONF.

  • Откатить версию ОТТ на ту которая использовалась в версии 5.0.

  • Проверить пути к сертификатам, т.к. в версии 5.1 они изменялись для работы с Secman.

Откат с версии 5.1 до версии 5.0 необходимо выполнить компонентом Deploy tools версии 1.2 (D-01.039.092).

  1. Внести изменения в файлы конфигурации согласно инструкции установки новой версии.

  2. Заполнить параметры для подключения скриптов Liquibase к БД в common.conf.yml.

  3. Запустить PIPELINE_Deploy с установленным флагом DB_UPDATE.

В случае повторного наката DB_UPDATE необходимо скорректировать параметр INDICATOR_EXPECTED_LIQUIBASE_TAG на значение tag с последним build.

  1. Запустить PIPELINE_Deploy с установленными флагами MIGRATION_FP_CONF, OPENSHIFT_DEPLOY и OPENSHIFT_INGRESS_EGRESS_DEPLOY.