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