Обновление 3.11.0 до 3.12.0¶
-
Установите SSH-соединение с сервером.
ssh <user-name>@<your-server>
-
Перейдите в директорию, указанную при установке AppSec.Track (рекомендуемая директория — /opt/appsec-track/).
cd /opt/appsec-track
-
Для остановки AppSec.Track выполните команду:
sudo docker-compose down
-
Загрузите образы в Docker. Предусмотрена возможность загрузки образов как из репозитория docker.swordfishsecurity.com, так и из дистрибутива.
-
Авторизуйтесь в репозитории docker.swordfishsecurity.com.
sudo docker login docker.swordfishsecurity.com -u <user-name>
-
Загрузите образы.
sudo docker pull docker.swordfishsecurity.com/appsec-track/track-backend:3.12.0 sudo docker pull docker.swordfishsecurity.com/appsec-track/track-frontend:3.12.0 sudo docker pull docker.swordfishsecurity.com/appsec-track/track-db:1.7.5-13.15 sudo docker pull docker.swordfishsecurity.com/appsec-track/track-redis:1.7.5-7.2.4 sudo docker pull docker.swordfishsecurity.com/appsec-track/track-scanner:1.7.5-0.51.1-2
-
Скопируйте Docker-образы на сервер.
scp home/<user-name>/track-backend-3.12.0.tar root@<your-server>:/home/<user-name> scp home/<user-name>/track-frontend-3.12.0.tar root@<your-server>:/home/<user-name> scp home/<user-name>/track-db-1.7.5-13.15.tar root@<your-server>:/home/<user-name> scp home/<user-name>/track-redis-1.7.5-7.2.4.tar root@<your-server>:/home/<user-name> scp home/<user-name>/track-scanner-1.7.5-0.51.1-2.tar root@<your-server>:/home/<user-name>
-
Загрузите образы.
sudo docker load --input /home/<user-name>/track-backend-3.12.0.tar sudo docker load --input /home/<user-name>/track-frontend-3.12.0.tar sudo docker load --input /home/<user-name>/track-db-1.7.5-13.15.tar sudo docker load --input /home/<user-name>/track-redis-1.7.5-7.2.4.tar sudo docker load --input /home/<user-name>/track-scanner-1.7.5-0.51.1-2.tar
Примечание
<user-name>
— имя пользователя;
<your-server>
— URL или IP сервера. -
-
Для проверки результатов предыдущих шагов выполните следующую команду:
sudo docker images
Необходимо убедиться, что в списке Docker-контейнеров присутствуют track-backend, track-frontend, track-db, track-redis и track-scanner, а также проверить версию каждого контейнера.
REPOSITIRY TAG docker.swordfishsecurity.com/appsec-track/track-backend:3.12.0 docker.swordfishsecurity.com/appsec-track/track-frontend:3.12.0 docker.swordfishsecurity.com/appsec-track/track-db:1.7.5-13.15 docker.swordfishsecurity.com/appsec-track/track-redis:1.7.5-7.2.4 docker.swordfishsecurity.com/appsec-track/track-scanner:1.7.5-0.51.1-2
-
Отредактируйте файл переменных окружения .env, указав в переменных backend_image, frontend_image, db_image, redis_image и scanner_image новые версии образов, полученные на предыдущем шаге, например:
Редактирование файла .env
Для отображения файлов, имена которых начинаются точкой, например .env, рекомендуется использовать команду:
ls -la
Для редактирования можно воспользоваться редактором nano:
sudo nano .env
.env# Images backend_image=docker.swordfishsecurity.com/appsec-track/track-backend:3.12.0 frontend_image=docker.swordfishsecurity.com/appsec-track/track-frontend:3.12.0 db_image=docker.swordfishsecurity.com/appsec-track/track-db:1.7.5-13.15 redis_image=docker.swordfishsecurity.com/appsec-track/track-redis:1.7.5-7.2.4 scanner_image=docker.swordfishsecurity.com/appsec-track/track-scanner:1.7.5-0.51.1-2
Дополните файл .env новыми переменными и их значениями:
.env#Показывать ли анонимно страницу INFO и отчет по SCA #по умолчанию: да, показывать. #Для изменения заменить значения "true" на "false" ANONYMOUS_INFO=true ANONYMOUS_SCA_REPORT=true
-
Приведите блок server в конфигурационном файле .config/application-prod.yml к данном виду (новые строки выделены цветом):
.config/application-prod.ymlserver: ## Раскомментировать для включения TLS на backend # ssl: # key-store: server.jks # key-store-password: ${jks_store_pass} # key-store-type: jks # port: 8443 servlet: encoding: charset: UTF-8 enabled: true force: true force-response: true
Дополните файл двумя новыми переменными (новые строки выделены цветом):
... dockerUrl: ${nexus_url} anonymousInfo: ${ANONYMOUS_INFO} anonymousScaReport: ${ANONYMOUS_SCA_REPORT} springdoc: ...
А также дополните файл новым блоком password:
#Изменение политики паролей password: min-length: 15 min-lowercase: 1 min-uppercase: 1 min-digits: 1 min-symbols: 1 login-max-attempts: 10 failure-timeout: 15m
-
Дополните файл docker-compose.yaml новыми переменными окружения:
... appsec-track-backend: container_name: appsec-track-backend hostname: appsec-track-backend image: ${backend_image} ... environment: - TZ=Europe/Moscow ... - ANONYMOUS_INFO=${ANONYMOUS_INFO} - ANONYMOUS_SCA_REPORT=${ANONYMOUS_SCA_REPORT} ...
-
Запустите контейнеры AppSec.Track.
sudo docker-compose up -d
Система перезагрузится и будет готова к использованию.
-
Перейдите в пользовательский интерфейс AppSec.Track по адресу хоста (например,
http://<AppSec.Track_IP_address>:8070/
). Логин и пароль пользователя после обновления останутся прежними.