Обзор развертывания Jenkins Marketplace App на сервере¶

Предварительные требования¶

Для корректной работы приложения требуются следующие параметры и компоненты:

• Операционная система: Ubuntu.

• Среда выполнения: Java (OpenJDK 21 JRE).

• Доступные порты:

• Внутренний порт: 8080 (для локального взаимодействия с сервисом).

• Внешний порт: 443 (через прокси-сервер для HTTPS доступа).

FDQN итоговой панели на домене hostkey.in¶

Для доступа к приложению используется следующий шаблон доменного имени:

Процесс установки приложения¶

Процесс развертывания включает в себя установку системных пакетов и настройку веб-прокси:

1. Подготовка системы: Обновление индекса пакетов через apt.

2. Установка Java: Установка пакетов fontconfig и openjdk-21-jre-headless. Настройка переменной окружения JAVA_HOME в файле /etc/default/jenkins на основе пути к установленному исполняемому файлу Java.

3. Установка Jenkins:

4. Добавление GPG-ключа репозитория Jenkins (LTS версия).

5. Добавление официального репозитория deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/ в список источников.

6. Установка пакета jenkins.

7. Настройка веб-прокси:

8. Создание директории /root/nginx.

9. Развертывание контейнера Nginx с поддержкой SSL (Certbot).

10. Настройка конфигурации проксирования, которая перенаправляет трафик с порта 443 на локальный порт приложения 8080.

Контейнеры Docker и их запуск¶

Для обеспечения работы HTTPS используется следующий контейнер:

Инструкция по обновлению приложения¶

Для обновления основного приложения необходимо выполнить следующие действия:

• Обновить пакеты системы через менеджер пакетов:

  apt update && apt upgrade jenkins
  

• Перезапустить сервис для применения изменений:

  systemctl restart jenkins
  

Расположение конфигурационных файлов и данных¶

В системе используются следующие пути для хранения данных и настроек:

• /etc/default/jenkins — конфигурация параметров запуска Java.

• /root/nginx/compose.yml — файл конфигурации Docker Compose для прокси-сервера.

• /data/nginx/user_conf.d/ — директория с конфигурационными файлами веб-сервера Nginx.

• /data/nginx/nginx-certbot.env — файл переменных окружения для контейнера Certbot.

Доступные порты для подключения¶