Полное удаление XRM Director и связанных с ним Docker-контейнеров из системы
Данная инструкция приводит к полному удалению XRM Director, связанных контейнеров, сетей, образов и рабочих данных с сервера.
Перед выполнением убедитесь, что данные из каталогов приложения, журналы и конфигурационные файлы больше не нужны или предварительно сохранены в резервную копию.
Назначение инструкции
Документ описывает полное удаление развертывания XRM Director с сервера, включая:
остановку и удаление контейнеров;
удаление Docker-сети, связанной с XRM Director;
удаление контейнерных образов XRM Director;
удаление рабочих каталогов и файлов конфигурации на сервере.
Что будет удалено
В типовом сценарии будут удалены:
контейнеры backend и frontend XRM Director;
сеть Docker xrm-network;
контейнерные образы xrmtech/xrm-director-backend:* и xrmtech/xrm-director-frontend:*;
каталог развертывания, например /opt/xrmd.
Если на сервере присутствуют другие проекты Docker, данная инструкция не должна затрагивать их контейнеры и сети. Удаляйте только объекты, относящиеся к XRM Director.
Предварительная проверка
Перед удалением рекомендуется проверить текущее состояние контейнеров:
Если XRM Director развернут через docker compose, также проверьте состав проекта из каталога установки:
Шаг 1. Остановка контейнеров XRM Director
Перейдите в каталог развертывания:
Остановите и удалите контейнеры проекта:
Команда `docker compose down` останавливает контейнеры проекта и удаляет созданные им контейнеры и сеть Compose, если она не используется другими контейнерами.
Шаг 2. Проверка, что контейнеры больше не запущены
Выполните:
Убедитесь, что контейнеры XRM Director отсутствуют или больше не находятся в состоянии Up.
Если контейнеры еще присутствуют, можно удалить их вручную.
Пример удаления контейнеров по имени:
Имена контейнеров могут отличаться в зависимости от имени каталога проекта или параметров `docker compose`.
Шаг 3. Удаление сети XRM Director
Проверьте список Docker-сетей:
Если в системе осталась сеть xrm-network, удалите ее:
Если сеть уже удалена командой docker compose down, Docker вернет сообщение, что такой сети не существует.
Шаг 4. Удаление образов XRM Director
Проверьте наличие образов:
Удалите образы XRM Director:
Если на сервере используются другие теги этих же образов, при необходимости их тоже можно удалить:
Удаляйте только те образы, которые действительно относятся к XRM Director и не используются другими развертываниями.
Шаг 5. Удаление рабочих каталогов и данных
Если конфигурация и данные больше не нужны, удалите каталог развертывания:
В результате будут удалены:
docker-compose.yml;
backend/settings.py;
журналы logs;
рабочие данные plandata;
локальные данные db.
Команда rm -rf удаляет данные без возможности восстановления стандартными средствами. Перед выполнением проверьте путь еще раз.
Шаг 6. Проверка полного удаления
Проверьте, что контейнеры XRM Director больше отсутствуют:
Проверьте, что образы удалены:
Проверьте, что каталог установки удален:
При необходимости убедитесь, что сеть xrm-network больше не существует:
Вариант быстрого удаления
Если требуется удалить типовое развертывание XRM Director целиком, можно использовать следующую последовательность:
После этого выполните проверку:
Если требуется удалить только контейнеры, но сохранить данные
Если необходимо удалить только контейнеры и сеть, но оставить конфигурацию и рабочие данные на сервере, выполните только:
В этом случае каталог /opt/xrmd останется в системе.
Типовые проблемы
Контейнер не удаляется
Попробуйте принудительное удаление:
Образ не удаляется
Причина обычно в том, что он используется существующим контейнером. Сначала удалите контейнеры, затем повторите удаление образа.
Сеть не удаляется
Проверьте, не подключены ли к ней другие контейнеры:
Каталог /opt/xrmd не удаляется
Выполните удаление с правами администратора:
Результат
После выполнения действий XRM Director, связанные с ним Docker-контейнеры, сеть, образы и рабочие файлы будут полностью удалены из системы.