Docker
Онлайн-обновление
Проверка прав пользователя и запуск скрипта
Если обновление выполн яется не от имени root — пользователь должен состоять в группе docker.
Проверить нахождение пользователя в группе docker можно следующей командой:
- shell
id $USER | grep docker
Если пользователь не принадлежит группе, добавить его через команду:
- shell
sudo usermod -a -G docker $USER
Скрипт использует curl. Если в сети используется прокси-сервер, необходимо добавить переменные окружения:
export http_proxy=http://proxy.example.com:8080
export https_proxy=http://proxy.example.com:8080
Затем запустить скрипт обновления Пассворка:
- shell
- update
./update.sh
cd /<passwork>/
wget -N https://repos.passwork.ru/repository/passwork_docker/update.sh
chmod +x update.sh
Блок кода разделяет команды:
- shell — запуск скрипта обновления Пассворка
- update — обновление скрипта update.sh
Выполняемые действия
- Проверки наличия утилит
unzip,curlиjq - Импорта переменных из файла
.env - Проверки переменной
$CERT - Получения последней доступной версии Пассворка
- Проверки архива с помощью цифровой подписи
- Создания резервной копии базы данных и конфигурационных файлов
- Загрузки и обновления
- Обработки ошибок
Завершение работы скрипта
Перед обновлением Пассворка, скрипт создает резервную копию базы данных в директории ./backup/mongo-xxxx-xx-xx-xx:xx:xx.dump и копию конфигурационных файлов в корневой директории ./conf-20240201-xxxxxx.tar.gz.
Если после обновления Пассворка при открытии веб-интерфейса отображаются предупреждения:
Офлайн-обновление
Проверка прав пользователя
Если обновление выполняется не от имени root — пользователь должен состоять в группе docker.
Проверить нахождение пользователя в группе docker можно следующей командой:
- shell
id $USER | grep docker
Если пользователь не принадлежит группе, добавить его через команду:
- shell
sudo usermod -a -G docker $USER
Загрузка обновления и запуск скрипта
Перейти на клиентский портал и получить последнюю доступную версию Пассворка с цифровой подписью:
Для проверки цифровой подписи также нужен публичный ключ Пассворка public.key. Получить его можно:
Вручную
- Открыть URL;
- Скопировать всё содержимое;
- Вставить в файл и сохранить содержимое с именем — public.key.
Автоматически (curl или wget)
- curl
- wget
curl -o public.key https://passwork.ru/public-key
wget -O public.key https://passwork.ru/public-key
Переместить полученные файлы на сервер с Пассворком в корневое расположение Docker-сборки:
- shell
/<passwork>/Passwork-xxxxxx.zip
/<passwork>/xxxxxx.sig
/<passwork>/public.key
Запустить скрипт для обновления:
- shell
- update
cd /<passwork>/
./offline_update.sh
cd /<passwork>/
wget -N https://repos.passwork.ru/repository/passwork_docker/offline_update.sh
chmod +x offline_update.sh
Блок кода разделяет команды:
- shell — запуск скрипта обновления Пассворка
- update — обновление скрипта offline_update.sh
По умолчанию скрипт проверяет цифровую подпись архива с помощью предоставленного открытого ключа. Если подпись недействительна или отсутствует, обновление будет прервано.
Если источник архива считается доверенным, проверку подписи можно пропустить:
- shell
./offline_update.sh --skip
Выпол няемые действия
- Импорт переменных из файла .env
- Определение режима обновления:
- Если архив с версией найден, устанавливается режим «zip»
- Если директория с версией найдена, устанавливается режим «directory»
- Создание резервной копии базы данных и конфигурационных файлов
- Проверка наличия утилиты Unzip при обнаружении архива .zip
- Проверка архива с помощью цифровой подписи
- Распаковка содержимого архива, либо копирование содержимого директории в каталог «www»
- Выбор метода обновления и выполнения
- Обработка ошибок
Завершение работы скрипта
Перед обновлением Пассворка, скрипт создаст резервную копию базы данных в директории ./backup/mongo-xxxx-xx-xx-xx:xx:xx.dump и копию конфигурационных файлов в корневой директории ./conf-20240201-xxxxxx.tar.gz
Если после обновления Пассворка при открытии веб-интерфейса отображаются предупреждения: