Инструкция описывает переход с версии 2.2.1 на версию 2.3, а также последующие обновления в рамках ветки 2.3.x до актуальной минорной версии — 2.3.5.
Если вы уже используете любую версию ветки 2.3.x, для обновления в рамках ветки воспользуйтесь разделом Обновление в рамках ветки 2.3.x в конце статьи.
Cоздайте резервную копию Ринго.
Убедитесь, что сервер, где развёрнута система Ринго, имеет доступ в сеть Интернет по портам 80, 443 без ограничений по IP-адресам и доменам.
Проведите диагностику вашей текущей инсталляции:
Убедитесь, что управляемые устройства сохранят доступ к серверу Ринго даже после удаления из MDM. Распространение через MDM критичных настроек доступа (таких как Wi-Fi или корневые сертификаты) может привести к потере связи.
Особенностей в переходе с 2.2.1 на 2.3 нет — обновление выполняется типовым способом: смена тега образа в docker-compose.yml, загрузка образа и пересборка контейнера backend. Дополнительные миграции БД, изменения volume или конфигурации nginx не требуются.
Проверьте, что в /etc/ringo/docker-compose.yml для контейнера roll-deploy-backend указан правильный параметр image:
image: cr.yandex/crpsam2fr3938ne18jd0/ringo:2.3
cd /etc/ringo
docker-compose.yml:docker compose pull
backend, пересобрав его и не трогая зависимости:docker compose up --force-recreate --no-deps --build -d backend
/etc/ringo), если это не было сделано ранееbash getHostInfo.sh
hostInfo.json и docker-compose.yml в контейнер roll-deploy-backend. После копирования перезапустите контейнер, чтобы система прочитала их содержимое:docker cp hostInfo.json roll-deploy-backend:/hostInfo.json
docker cp docker-compose.yml roll-deploy-backend:/docker-compose.yml
docker container restart roll-deploy-backend
client_max_body_size 5m;, если это ещё не было сделано ранее:docker cp ringo-proxy-settings.conf ringo-nginx-proxy-1:/etc/nginx/conf.d/ringo-proxy-settings.conf
docker container restart ringo-nginx-proxy-1
При использовании собственного прокси-сервера не забудьте указать параметр
client_max_body_sizeили скорректировать его значение в соответствии с указанным выше.
Шаги 4–7 выполняются один раз — если вы уже выполняли их при более раннем обновлении (например, при переходе на 2.2), повторно выполнять их не требуется. Если информация о системе не сохраняется, проверьте файл docker-compose.yaml и убедитесь, что для необходимых файлов настроено монтирование томов в файловую систему контейнера. Это позволит сохранить данные при пересоздании контейнера.
Используйте этот раздел, если у вас уже установлена одна из версий ветки 2.3 (2.3, 2.3.1 или 2.3.2), и требуется обновиться до более новой минорной версии, вплоть до актуальной — 2.3.5.
Все обновления внутри ветки 2.3.x — 2.3 → 2.3.1 → 2.3.2 → 2.3.5 — выполняются по единому, типовому сценарию: смена тега образа в docker-compose.yml, загрузка образа из Docker Registry и пересборка контейнера backend. Особенностей (миграций БД, дополнительных volume, изменений конфигурации nginx) в рамках этих обновлений нет.
| Переход | Тег образа |
|---|---|
| 2.3 → 2.3.1 | ringo:2.3.1 |
| 2.3.1 → 2.3.2 | ringo:2.3.2 |
| 2.3.2 → 2.3.5 | ringo:2.3.5 |
Cоздайте резервную копию Ринго.
Откройте /etc/ringo/docker-compose.yml и для контейнера roll-deploy-backend укажите тег версии, до которой выполняется обновление (см. таблицу выше), например:
image: cr.yandex/crpsam2fr3938ne18jd0/ringo:[тег версии]
cd /etc/ringo
docker compose pull
docker compose up --force-recreate --no-deps --build -d backend