🔄 Пошаговая инструкция по обновлению Docker-версии Confluence
Эта инструкция поможет вам безопасно обновить Atlassian Conflueence в контейнере Docker, минимизируя простой и риск потери данных.
📌 Шаг 1: Подготовка
1.1. Проверьте текущую версию Confluence
Запишите текущую версию, чтобы в случае проблем можно было откатиться.
1.1. Перейдите в каталог Confluence
cd ~/confluence/
1.2. Бэкап файла docker-compose.yml
Если изменяли docker-compose.yml, создайте копию:
cp docker-compose.yml docker-compose-backup.yml
1.3. Бэкап файла Dockerfile
cp Dockerfile Dockerfile-backup
🔄 Шаг 2: Обновление контейнера
2.1. Остановите текущую Confluence
docker-compose down
2.2. Замените версию в файле Dockerfile на нужную:
sudo vim Dockerfile
Dockerfile для определенной версии:
FROM atlassian/confluence:9.3.1
# Указываем рабочую директорию
WORKDIR /opt/atlassian/confluence
# Скачиваем Atlassian Agent
RUN wget -O /opt/atlassian/confluence/atlassian-agent.jar https://github.com/haxqer/jira/releases/download/v1.3.3/atlassian-agent.jar
# Настраиваем автозапуск агента
RUN echo 'CATALINA_OPTS="-javaagent:/opt/atlassian/confluence/atlassian-agent.jar ${CATALINA_OPTS}"' >> bin/setenv.sh
Dockerfile для последней версии:
FROM atlassian/confluence:latest
# Указываем рабочую директорию
WORKDIR /opt/atlassian/confluence
# Скачиваем Atlassian Agent
RUN wget -O /opt/atlassian/confluence/atlassian-agent.jar https://github.com/haxqer/jira/releases/download/v1.3.3/atlassian-agent.jar
# Настраиваем автозапуск агента
RUN echo 'CATALINA_OPTS="-javaagent:/opt/atlassian/confluence/atlassian-agent.jar ${CATALINA_OPTS}"' >> bin/setenv.sh
2.3. Создайте образ Confluence
docker-compose build
2.4. Запустите обновлённый Confluence
docker-compose up -d
Предупреждение на скрине указывает на явно указанную версию Confluence, проблем при этом не возникает. Если устанавливать последнюю версию с параметром "latest" вместо версии, то такая ошибка не возникает. При этом важно соблюдать очередность обновления версий. При обновлении Confluence с очень старой версии до последней, необходимо пройти цепочку обновлений рекомендованных разработчиком иначе можно столкнуться с критическими ошибками. Если у вас одна из последних версий Confluence, то в Dockerfile можно указать вместо версии параметр "latest". В таком случае редактировать версию в Dockerfile при каждом обновлении не потребуется. Обновление сведется к переходу в каталог, остановке docker-compose, сборке образа и запуску контейнеров.
2.5. Проверьте логи
После обновления Jira автоматически выполняет миграцию базы данных. Просмотрите логи:
docker-compose logs -f confluence
Ожидайте сообщение вида:
✅ "JIRA Startup is complete"
📌 Шаг 3: Проверка работы
- Перейдите в браузер и откройте:http://<your-server-ip>:8090
- Убедитесь, что Jira успешно обновилась.
♻ Шаг 4: Очистка старых данных (необязательно)
После успешного обновления можно удалить старый образ Docker:
docker image prune -f
Если у вас несколько версий образов, найдите их:
docker images | grep confluence
Удалите старую версию вручную:
docker rmi atlassian/confluence:<OLD_VERSION>
🔙 Как откатиться на предыдущую версию?
ВАЖНО!!!! Откатиться на более старую версию чем у вас установлена не получится! К примеру если у вас была установлена только версия 9.3.1 и никакой более старой, вы обновились на 9.3.2, то откатиться сможеет только на 9.3.1. При этом с 9.3.1 на 9.3.0 откатиться не выйдет!
Если после обновления Confluence работает некорректно:
Остановите контейнер:
docker-compose down
Измените версию Confluence в Dockerfile на нужную вам:
sudo vim Dockerfile
Соберите новый образ контейнера:
docker-compose build
Запустите контейнер:
docker-compose up -d