Перейти к содержанию

Обновление до новой мажорной версии

Для работы новой мажорной версии GitFlic требуется Java 17 или выше.

Перед обновлением необходимо определить способ установки GitFlic:

  • базовая установка на Linux;
  • установка на Astra Linux;
  • запуск с помощью Docker Compose.

При использовании базовой установки или Astra Linux перед обновлением необходимо проверить версию Java в системе. При использовании Docker Compose необходимая версия Java уже включена в образ GitFlic.

Перед переходом на новую версию рекомендуется создать резервную копию базы данных и файлов GitFlic.

Базовая установка на Linux

Перед обновлением требуется проверить версию Java:

java --version

Для запуска новой версии GitFlic должна использоваться Java 17 или выше.

Если GitFlic запускается как служба systemd, дополнительно требуется проверить версию Java по пути, указанному в ExecStart:

/usr/bin/java --version

Для проверки Java от имени системного пользователя GitFlic требуется выполнить:

sudo -u gitflic /usr/bin/java --version

Во всех случаях должна отображаться Java 17 или более новая версия.

Обновление Java

Если используется версия ниже Java 17, необходимо установить OpenJDK 17.

Для систем на основе Debian пример установки выглядит следующим образом:

sudo apt update
sudo apt install openjdk-17-jdk

Если в системе одновременно установлено несколько версий Java, проверить доступные варианты можно командой:

sudo update-alternatives --config java

В списке необходимо выбрать Java 17 или более новую версию.

После изменения повторно проверить версию:

java --version
sudo -u gitflic /usr/bin/java --version

После подготовки Java можно выполнить стандартное обновление GitFlic.

Для установки, работающей через systemd, требуется:

  1. Остановить GitFlic:

    sudo systemctl stop gitflic-server

  2. Заменить gitflic.jar на файл из комплекта поставки новой версии:

    sudo cp gitflic.jar /opt/gitflic/bin/gitflic.jar

  3. Запустить GitFlic:

    sudo systemctl start gitflic-server

  4. Проверить состояние службы:

    sudo systemctl status gitflic-server

Обновление на Astra Linux

Для новой мажорной версии GitFlic требуется Java 17 или выше.

Перед изменением конфигурации репозиториев необходимо определить используемую версию Astra Linux и проверить наличие openjdk-17-jdk в официальных репозиториях.

Наличие пакета для конкретной версии операционной системы можно проверить в навигаторе по репозиториям Astra Linux.

Для поиска требуется указать пакет:

openjdk-17-jdk

В результатах поиска необходимо проверить:

  • релиз Astra Linux;
  • репозиторий, содержащий пакет;
  • доступную версию пакета.

Если openjdk-17-jdk отсутствует для используемой версии Astra Linux, перед обновлением GitFlic необходимо подготовить окружение с доступной Java 17 или выше.

Подключение репозиториев

Для установки пакетов из расширенного репозитория Astra Linux должны быть подключены основной и расширенный репозитории, соответствующие используемой версии операционной системы.

Проверить текущую конфигурацию можно командой:

cat /etc/apt/sources.list

Если в файле присутствует источник установки с диска вида:

deb cdrom:

его необходимо закомментировать.

Для Astra Linux 1.8 пример конфигурации выглядит следующим образом:

deb https://download.astralinux.ru/astra/stable/1.8_x86-64/repository-main/ 1.8_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.8_x86-64/repository-extended/ 1.8_x86-64 main contrib non-free

Конфигурация репозиториев должна соответствовать установленной и поддерживаемой версии Astra Linux.

После изменения списка репозиториев требуется обновить сведения о пакетах:

sudo apt update

Проверить доступность OpenJDK 17 в подключённых репозиториях:

apt policy openjdk-17-jdk

Если пакет доступен, установить Java 17:

sudo apt install openjdk-17-jdk

После установки проверить версию:

java --version

Если в системе установлено несколько версий Java, выбрать необходимую:

sudo update-alternatives --config java

После выбора повторно проверить Java, используемую GitFlic:

java --version
sudo -u gitflic /usr/bin/java --version

Версия должна быть Java 17 или выше.

После подготовки Java обновление GitFlic выполняется стандартным способом:

sudo systemctl stop gitflic-server
sudo cp gitflic.jar /opt/gitflic/bin/gitflic.jar
sudo systemctl start gitflic-server

После запуска проверить состояние службы:

sudo systemctl status gitflic-server

Обновление при использовании Docker Compose

При запуске GitFlic с помощью Docker Compose устанавливать или обновлять Java на хостовой системе не требуется.

Необходимая версия Java уже включена в Docker-образ GitFlic. Для перехода на новую мажорную версию необходимо обновить используемый образ приложения.

Обновление образа из реестра

Если образ GitFlic загружается из реестра, требуется перейти в каталог с docker-compose.yaml и получить новую версию образа:

docker compose pull

После загрузки образа перезапустить сервисы:

docker compose down
docker compose up -d

Обновление Enterprise-образа из файла

Если Docker-образ входит в комплект поставки Enterprise, необходимо загрузить новый образ в Docker:

docker load -i gitflic-server-ee.tar

В файле .env указать образ новой версии:

GITFLIC_IMAGE=gitflic-server-ee:<актуальный тег>

После изменения запустить сервисы:

docker compose down
docker compose up -d

При обновлении Docker-образа отдельно изменять версию Java внутри контейнера не требуется.

Проверка после обновления

После обновления необходимо проверить запуск GitFlic.

Для установки на операционной системе:

sudo systemctl status gitflic-server

Для установки с помощью Docker Compose:

docker compose ps

После успешного запуска необходимо открыть веб-интерфейс GitFlic и проверить доступность приложения.

При возникновении ошибки запуска необходимо проверить журнал приложения.

Для стандартной установки:

tail -f /opt/gitflic/logs/server.log

Для Docker Compose:

docker compose logs