Инструкция по обновлению

Обновление платформы с версии =<1.13.0 на версию =>1.14.0

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

примечание

Вставьте полное имя хоста в поле ingress.rules.gateway.host. Например, platform.example.com.

Точка в имени поля отражает вложенность структуры yaml или json.

Исходный файл	Поле	Новый файл	Поле
./setup/settings.env	MASTER_NODE_IP_ADDRESS	./cfg/smc.settings.cfg	apiserver_advertise_address, external_ip_address
	POSTGRES_USER	./cfg/platform.secrets.json	postgres-root-credentials.user
	POSTGRES_PASSWORD		postgres-root-credentials.password
	SERVICE_KEY		platform-service-key.service_key
	LIC_SERVER_IP_ADDRESS		license-secret.server_url
	LIC_KEY		license-secret.key
	PLATFORM_ADMIN_EMAIL		platform-user-secret.admin_email
	PLATFORM_ADMIN_PASSWORD		platform-user-secret.admin_password
	PLATFORM_DEFAULT_EMAIL		platform-user-secret.default_email
	PLATFORM_DEFAULT_PASSWORD		platform-user-secret.default_password
	EMAIL_HOST		platform-email-secret.email_host
	EMAIL_HOST_USER		platform-email-secret.email_host_user
	EMAIL_HOST_PASSWORD		platform-email-secret.email_host_password
	EMAIL_FROM		platform-email-secret.email_from
	EMAIL_USE_SSL		platform-email-secret.email_use_ssl
	QUERY_LIMIT	./cfg/platform.values.yaml	backend.query_limit
	INDEX_UPDATE_PERIOD		backend.index_update_period
	USE_CUDA		processing.use_cuda
	DOMAIN		ingress.rules.gateway.host
./setup/settings.env	LIC_KEY	./cfg/license-server.settings.cfg	license-secret.key
	LIC_SERVER_IP_ADDRESS		license-secret.server_url
./deploy/services_db_config.json	storage-engine-db.credentials.POSTGRES_USER	./cfg/platform.secrets.json	storage-engine-postgres.user
	storage-engine-db.credentials.POSTGRES_PASSWORD		storage-engine-postgres.password
	storage-engine-db.credentials.POSTGRES_DB		storage-engine-postgres.db
	event-service-db.credentials.POSTGRES_USER		event-service-postgres.user
	event-service-db.credentials.POSTGRES_PASSWORD		event-service-postgres.password
	event-service-db.credentials.POSTGRES_DB		event-service-postgres.db

Обновление платформы с версии 1.14.* до более поздних версий

Перед обновлением платформы для сохранения доступа к базе данных и основной конфигурации перенесите существующие значения полей в файлы новой версии.

ВНИМАНИЕ

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

После переноса всех полей перейдите в папку с новой платформой и выполните команду:

./cli.sh platform install-secrets

Это действие обязательно к выполнению, в противном случае сервисы не получат необходимый набор полей и не смогут запуститься.

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

Удаление предыдущей версии платформы

1. Перейдите в папку <distribution_folder>/setup развернутой версии платформы и остановите платформу:

   ./cli.sh platform uninstall
   ./cli.sh image-api uninstall

2. Убедитесь, что все контейнеры сервисов остановлены:

   watch 'kubectl get pods'

   Статус сервисов из состояния "Running" должен перейти в состояние "Terminating". В результате, все сервисы должны пропасть из отображаемой таблицы.

3. Удалите развернутый Kubernetes-кластер:

   ./cli.sh smc uninstall

4. Удалите вспомогательные файлы Kubernetes-кластера:

   sudo rm -rf ~/.kube/

5. Выполните сброс таблиц IPVS вашей системы:

   sudo ipvsadm --clear

примечание

При удалении платформы вся база данных сохраняется в директории /kv/pgdata. Для дальнейшего использования базы в процессе установки новой версии платформы укажите те же авторизационные данные и имя базы данных. В противном случае, выполните команду:

./cli.sh platform db-reset