Как скачать и установить Jenkins on Windows

Jenkins может быть установлен на любом из них. Windows или платформах Unix, но в этом пошаговом руководстве основное внимание уделяется... Windows Только установка. Windows Реестры установщика MSI Jenkins как Windows сервис и выбирает 64-битную версию Java Это среда выполнения, что делает её самым быстрым способом создания работающего сервера автоматизации. Перед запуском установщика убедитесь, что ваша машина соответствует требованиям, перечисленным в следующем разделе.

Jenkins Предпосылки и системные требования

Jenkins В состоянии покоя система имеет небольшой размер, но быстро разрастается по мере накопления истории сборок, рабочих пространств и плагинов. Правильный расчет размера системы на начальном этапе позволяет избежать болезненной миграции в дальнейшем.

Аппаратные требования:

Требования к программному обеспечению:

• Jenkins работает на Java, поэтому поддерживается Java Комплект разработки (JDK) или Java Необходимо наличие среды выполнения (JRE). Текущая версия. Jenkins для выпуска требуются Java 21 или более поздняя версия; Java 8, 11 и 17 больше не поддерживаются в рамках новейшей линейки долгосрочной поддержки.
• Для доступа к сайту необходим современный веб-браузер. Jenkins панель приборов.
• Учетная запись с правами администратора на Windows Для регистрации необходима машина. Jenkins услуги.

Подтвердите установку Java Перед продолжением введите версию из командной строки. Если команда завершится с ошибкой или сообщит о версии ниже 21, сначала установите поддерживаемую версию JDK.

:: Check the Java version available on the machine
java -version

:: Expected output resembles the following
openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)

Типы релизов

Jenkins Выпускаются две версии программного обеспечения, и выбор влияет на частоту обновлений.

В этом пошаговом руководстве используется версия LTS, хотя процесс установки идентичен для еженедельной версии. После установки необходимых компонентов можно начинать загрузку.

Как загрузить Jenkins?

Выполните следующие шаги, чтобы получить Windows и завершите успешную установку:

Шаг 1) Перейдите на https://www.jenkins.io/download/ и выберите платформу. В нашем случае, Windows.

Шаг 2) Перейдите в папку с загруженными файлами на вашем локальном компьютере и распакуйте загруженный пакет. Double-нажмите на распакованный файл Дженкинс.msi . Jenkins Также можно запускать приложения из WAR-файла (архива веб-приложения), но этот способ не рекомендуется. Windows потому что это пропускает регистрацию службы, выполняемую установщиком.

Примечание: Windows SmartScreen может сообщить о том, что он предотвратил запуск неопознанного приложения. Выберите Подробнее, то Запуск в любом случае, чтобы продолжить подписанное Jenkins Установщик.

Шаг 3) В Jenkins Экран настроек, нажмите Следующая.

Шаг 4) Выберите место, где Jenkins Необходимо установить экземпляр. В текущих 64-битных установщиках по умолчанию используется следующее местоположение: C: \ Program Files \JenkinsЗапомните этот путь, поскольку в нём хранится первоначальный пароль администратора. Щёлкните Следующая.

Шаг 5) Затем установщик запрашивает учетные данные для входа в службу и номер порта. Укажите выделенную локальную или доменную учетную запись и нажмите кнопку. Тестовые учетные данныезатем укажите порт и нажмите Тестовый порт, порт 8080 Это значение по умолчанию. Запуск. Jenkins Использование именованной учетной записи службы безопаснее, чем вариант LocalSystem, который предоставляет Jenkins полный доступ к машине.

Шаг 6) Подтвердите Java Найдите домашний каталог, который обнаружит установщик, просмотрите параметры пользовательской установки и нажмите кнопку. Установите кнопка. После завершения установки нажмите Завершить.

Шаг 7) В процессе установки может появиться информационная панель, сообщающая о необходимости перезагрузки по завершении текущей установки. Нажмите на кнопку. OK Кнопка появляется при появлении информационной панели.

Файлы теперь находятся на диске, и сервис зарегистрирован. На следующем этапе открывается веб-интерфейс.

Как разблокировать Jenkins?

После завершения Jenkins На этапе установки контроллер блокируется до тех пор, пока вы не укажете автоматически сгенерированный пароль. Ниже описаны шаги по разблокировке. Jenkins Приложение:

Шаг 1) После завершения процесса установки откроется вкладка в браузере, в которой будет запрошен первоначальный пароль администратора. Чтобы получить доступ к... JenkinsДля этого перейдите по следующему пути в вашем веб-браузере.
http://localhost:8080

Если указанный выше адрес загружается, значит установка прошла успешно и служба запущена.

Шаг 2) Первоначальный пароль администратора хранится в... Jenkins Путь установки, который вы указали на шаге 4 установки. Для расположения по умолчанию. C: \ Program Files \Jenkinsфайл под названием начальный пароль администратора находится под C: \ Program Files \JenkinsсекретыЕсли был выбран пользовательский путь, проверьте это местоположение. То же значение также записывается в jenkins.err.log подать в Jenkins домашний каталог.

Шаг 3) Откройте выделенный файл и скопируйте его содержимое. начальный пароль администратора .

Шаг 4) Вставьте пароль в Пароль администратора поле в разделе «Разблокировка» Jenkins откройте страницу в браузере и нажмите Продолжить .

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

Настроить Jenkins

Вы также можете настроить свой Jenkins Создайте среду, выполнив следующие шаги:

Шаг 1) Нажмите Установить предлагаемые плагины кнопка, чтобы Jenkins Получает и устанавливает необходимые плагины.

Jenkins Начинается загрузка и установка всех необходимых плагинов для создания новых объектов. Jenkins рабочие места.

Примечание: Вы можете выбрать этот вариант. Выберите плагины для установки и выберите только нужные вам плагины. Плагины можно будет добавлять или удалять позже. Управление Jenkins > ПлагиныТаким образом, этот выбор не является окончательным.

Шаг 2) После установки всех предложенных плагинов, Создать первого администратора. Появится панель. Заполните все поля необходимыми данными учетной записи и нажмите кнопку. Сохранить и закончить .

Шаг 3) Jenkins наконец спрашивает о URL где будет осуществлен доступ к экземпляру. Оставьте значение по умолчанию, чтобы избежать путаницы в дальнейшем. Если другое приложение уже использует порт 8080, укажите здесь другой порт, а затем нажмите кнопку. Сохранить и продолжить .

Поздравляем! Новый Jenkins Сервер установлен. Нажмите кнопку. Начните использовать Jenkins .

Jenkins Экземпляр запущен и готов к выполнению вашей первой задачи. Краткое описание: Jenkins учебник для начинающих объясняет, как создать эту вакансию.

Как проверить Jenkins Установка и управление сервисом

Панель управления, которая загружается один раз, не является доказательством корректной работы установки. Потому что установщик MSI регистрируется... Jenkins как Windows Служба должна сохранять работоспособность после перезагрузки и корректно перезапускаться по запросу. Сразу после закрытия мастера установки выполните следующие проверки.

1. Подтвердите существование сервиса. Штамповочный пресс Win + R, напишите services.mscи нажмите Enter. Найдите запись с именем Jenkins и подтвердить, что статус соответствует Бег а тип запуска выглядит следующим образом: Автоматический.
2. Проверьте используемую учетную запись. Откройте свойства файла Jenkins обслуживание и проверка Вход в систему Вкладка. Для всего, что выходит за рамки локальных экспериментов, предпочтительнее использовать выделенную учетную запись службы, а не учетную запись LocalSystem.
3. Проверьте порт прослушивания. Run netstat -ano | findstr :8080 из командной строки. Запись LISTENING подтверждает, что Jenkins удерживает порт.
4. Ознакомьтесь с баннером версии. Войдите в http://localhost:8080 и прочтите номер версии в правом нижнем углу панели управления. Сравните его с номером загруженной вами версии.
5. Перезагрузите один раз. Restart Windows и снова перейти на панель управления, не запуская ничего вручную. Если страница загружается, значит, служба действительно работает в автоматическом режиме.

Сервисом также можно управлять из командной строки с правами администратора, что быстрее, чем графическая консоль, и хорошо работает внутри скриптов развертывания:

:: Stop, start, and query the Jenkins Windows service
net stop "Jenkins"
net start "Jenkins"
sc query "Jenkins"

:: Install Jenkins silently on a fleet of machines
msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^
  INSTALLDIR="D:\Jenkins" ^
  PORT=8080 ^
  /L*v "C:\logs\jenkins-install.txt"

💡 Совет: Программа автоматической установки принимает INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME и SERVICE_PASSWORD В качестве переопределения свойств. Все, что вы не передадите, будет возвращено к значению по умолчанию, а в тихом режиме служба будет работать от имени LocalSystem, если не указана учетная запись службы.

Если какая-либо из этих проверок не пройдена, причины обычно предсказуемы, как показано в следующем разделе.

Общие Jenkins Ошибки установки на Windows и как их исправить

Большинство неудачных Windows в линии tracвернуться к небольшому набору причин: неподтвержденная причина Java Проблема может проявляться в процессе выполнения программы, в занятом порту или в учетной записи службы, не имеющей прав для входа в систему в качестве службы. Каждая из этих причин вызывает свои специфические симптомы, поэтому обычно ее можно быстро устранить, если внимательно прочитать сообщение.

• Неверные учетные данные для входа в систему: Установщик отклоняет учетную запись во время Тестовые учетные данные шаг. Открыть. secpol.msc, развернуть Локальная политика > Назначение прав пользователя, откройте Войти как сервиси добавьте учетную запись. Затем повторите проверку учетных данных.
• Порт 8080 уже используется: Тестовый порт Кнопка становится красной, потому что другое приложение, часто локальный Tomcat или сервер разработки, уже занимает этот порт. Выберите свободный порт, например 8081, или остановите конфликтующий процесс, указанный в сообщении об ошибке. netstat -ano.
• Неподдерживаемый или отсутствующий Java: Установщик не может предварительно заполнить Java домашний каталог, иначе служба запустится и сразу же остановится. Установите 64-битную версию JDK 21 или более позднюю, затем укажите установщику ее домашний каталог.
• SmartScreen блокирует установщик: Windows Сообщает о неопознанном приложении. Выберите Подробнее, то Запуск в любом случае, после подтверждения того, что файл поступил с официального сайта. Jenkins загрузите страницу.
• Файл initialAdminPassword не найден: Выбран пользовательский каталог установки. Загляните внутрь. secrets папку этого каталога или считать пароль из jenkins.err.log в Jenkins домашний каталог.

Как только Jenkins Работает надежно, естественным следующим шагом будет подключение к репозиторию исходного кода и конвейеру сборки. Пошаговые инструкции приведены на сайте. Jenkins Интеграция с GitHub и Конвейер CI / CD Объясните, как осуществляется непрерывная интеграция вокруг этой установки.

Часто задаваемые вопросы (FAQ)