Перейти к содержанию

Обновление 3.11.0 до 3.12.0

  1. Установите SSH-соединение с сервером.

    ssh <user-name>@<your-server>
    
  2. Перейдите в директорию, указанную при установке AppSec.Track (рекомендуемая директория — /opt/appsec-track/).

    cd /opt/appsec-track
    
  3. Для остановки AppSec.Track выполните команду:

    sudo docker-compose down
    
  4. Загрузите образы в Docker. Предусмотрена возможность загрузки образов как из репозитория docker.swordfishsecurity.com, так и из дистрибутива.

    1. Авторизуйтесь в репозитории docker.swordfishsecurity.com.

      sudo docker login docker.swordfishsecurity.com -u <user-name>
      
    2. Загрузите образы.

      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
      
    1. Скопируйте 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>
      
    2. Загрузите образы.

      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 сервера.

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

    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
    
  6. Отредактируйте файл переменных окружения .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
    
  7. Приведите блок server в конфигурационном файле .config/application-prod.yml к данном виду (новые строки выделены цветом):

    .config/application-prod.yml
    server:
    ## Раскомментировать для включения 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
    
  8. Дополните файл 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}
    ...
    
  9. Запустите контейнеры AppSec.Track.

    sudo docker-compose up -d
    

    Система перезагрузится и будет готова к использованию.

  10. Перейдите в пользовательский интерфейс AppSec.Track по адресу хоста (например, http://<AppSec.Track_IP_address>:8070/). Логин и пароль пользователя после обновления останутся прежними.