HOWTO: Клонирование USERSIDE

Копия системы для тестирования или исследований

Если вам понадобилось сделать копию системы, чтобы испытать новую версию перед фактическим обновлением, или выполнить еще какие либо действия, то вам необходимо выполнить несколько простых шагов:

• скопируйте файлы приложения

cd /var/www/
sudo cp -r userside userside-new

• настройте web-сервер для работы с копией - скопируйте конфигурационный файл, отредактируйте и перечитайте конфигурацию nginx:

sudo cp /etc/nginx/conf.d/userside.conf /etc/nginx/conf.d/userside-new.conf
sudo sed -i "s@/var/www/userside/userside3@/var/www/userside-new/userside3@" "/etc/nginx/conf.d/userside-new.conf"
sudo sed -i "s@/var/log/nginx/userside@/var/log/nginx/userside-new@" "/etc/nginx/conf.d/userside-new.conf"
sudo sed -i "s@старое.доменное.имя@новое.доменное.имя@" "/etc/nginx/conf.d/userside-new.conf"
sudo systemctl reload nginx

• скопируйте базу данных (или создайте новую базу данных и восстановите ее из резервной копии):

sudo -u postgres createdb -e --encoding="UTF-8" --locale="ru_RU.UTF-8" --owner=userside --template=userside userside_new

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

sudo -u postgres createuser userside -P

• В версии 3.13 и новее перейдите в каталог с новой копией, отредактируйте переменные окружения в файле .env таким образом, чтобы они работали с новой базой данных и с другой (свободной) базой данных redis (в основной инсталляции у вас, скорее всего, используется база данных redis под номером 0; вы можете использовать еще 15, имеющихся по умолчанию). За это отвечают переменные:

US_URL=http://новое.доменное.имя
US_DB_DSN=pgsql:host=localhost;dbname=userside_new;port=5432
US_REDIS_DB=1

• В версии до 3.13 отредактируйте параметры подключения к БД в файле common/config/db.php и URL в файле userside3/main/config/config.php

• В версии 3.16 и новее вам необходимо создать дополнительный vhost для RabbitMQ, а затем указать его в .env файле для переменной US_AMQP_DSN. Сперва выполните команду, создающую vhost, затем добавьте разрешения для пользователей в пределах этого vhost:

sudo rabbitmqctl add_vhost copy
sudo rabbitmqctl set_permissions -p "copy" "admin" ".*" ".*" ".*"
sudo rabbitmqctl set_permissions -p "copy" "userside" ".*" ".*" ".*"
sudo rabbitmqctl set_permissions -p "copy" "userside-stomp" "^userside-stomp:id-.*" "" "^userside-stomp:id-.*"

Теперь измените переменную US_AMQP_DSN файла .env таким образом:

US_AMQP_DSN=amqp://userside:вашпароль@127.0.0.1:5672/copy

• В версии 3.16 и новее вам также придется пересоздать venv для микросервиса поллера:

sudo rm -rf /var/www/userside-new/microservice/poller/venv
cd /var/www/userside-new/microservice/poller
sudo -H python3 -m virtualenv -p /usr/bin/python3 venv
sudo -H ./venv/bin/pip install --upgrade -r requirements.txt

• Также начиная с версии 3.16 нужно будет скопировать конфигурацию супервизора для фоновых процессов ядра и микросервиса поллеров:

sudp cp /etc/supervisor/conf.d/us-core-worker.conf /etc/supervisor/conf.d/us-copy-core-worker.conf
sudo sed -i "s@us-core-worker@us-copy-core-worker@" "/etc/supervisor/conf.d/us-copy-core-worker.conf"
sudo sed -i "s@/var/www/userside/@/var/www/userside-new/@" "/etc/supervisor/conf.d/us-copy-core-worker.conf"

sudo cp /etc/supervisor/conf.d/us-poller-microservice.conf /etc/supervisor/conf.d/us-copy-poller-microservice.conf
sudo sed -i "s@us-poller-microservice@us-copy-poller-microservice@" "/etc/supervisor/conf.d/us-copy-poller-microservice.conf"
sudo sed -i "s@/var/www/userside/@/var/www/userside-new/@" "/etc/supervisor/conf.d/us-copy-poller-microservice.conf"

sudo systemctl restart supervisor

• теперь можно открыть в браузере вашу копию.