Изучение интерфейса Jenkins

Введение

Добро пожаловать в ваш первый практический опыт работы с Jenkins. Jenkins — это мощный сервер автоматизации с открытым исходным кодом, используемый для сборки, тестирования и развертывания программного обеспечения, что является практикой, известной как непрерывная интеграция и непрерывное развертывание (CI/CD).

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

К концу этой лабораторной работы вы сможете:

• Навигировать по главной панели управления Jenkins.
• Создать новый проект типа Freestyle.
• Запустить задание сборки вручную.
• Просмотреть историю сборок и вывод консоли.

Приступим.

Доступ и изучение панели управления Jenkins

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

Сначала получите доступ к веб-интерфейсу Jenkins. В верхней части экрана LabEx нажмите на вкладку Desktop Interface (Интерфейс рабочего стола). Внутри виртуального рабочего стола откройте веб-браузер Firefox. Браузер автоматически откроется по адресу http://localhost:8080, поэтому вам не нужно вводить URL вручную. Вход в систему не требуется.

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

• Боковая панель навигации (слева): Это ваше основное навигационное меню. Здесь вы найдете важные ссылки, такие как New Item (для создания новых заданий/проектов), Build History (глобальный просмотр всех сборок).
• Основная область контента: Эта область отображает список всех созданных вами заданий. Изначально она будет пустой.

Теперь, когда вы ознакомились с панелью управления, вы готовы создать свой первый проект.

Создание Freestyle-проекта

На этом шаге вы создадите свое первое задание Jenkins с использованием типа "Freestyle project" (Проект в свободном стиле). Проект Freestyle — это очень гибкий и простой в использовании вариант, идеально подходящий для начинающих и широкого спектра задач автоматизации.

1. В веб-интерфейсе Jenkins нажмите New Item (Создать элемент) на левой боковой панели навигации.

2. На следующей странице вам потребуется указать имя для вашего проекта и выбрать его тип.

   • В поле Enter an item name (Введите имя элемента) введите My-First-Job.
   • Выберите Freestyle project из списка опций.
   • Нажмите кнопку OK внизу.

3. Теперь вы окажетесь на странице конфигурации проекта. Здесь вы определяете, что будет делать ваше задание. Для этой лабораторной работы мы добавим один простой шаг сборки. Прокрутите вниз до раздела Build Steps (Шаги сборки).

4. Нажмите на выпадающую кнопку Add build step (Добавить шаг сборки) и выберите Execute shell (Выполнить shell-скрипт). Это позволит вам выполнять команды shell в рамках вашей сборки.

5. Появится поле для команды. В это поле введите следующую команду:

   echo "Hello from my first Jenkins job!"

6. Наконец, прокрутите страницу до самого низа и нажмите кнопку Save (Сохранить).

После сохранения Jenkins перенаправит вас на главную страницу вашего нового проекта, My-First-Job.

Запуск сборочной задачи

На этом шаге вы запустите, или "соберете" (build), созданное вами задание. Запуск задания означает выполнение настроенных для него шагов.

В настоящее время вы должны находиться на странице проекта My-First-Job. Если вы перешли на другую страницу, вы можете вернуться обратно, нажав на его имя на главной панели управления Jenkins.

1. На странице проекта My-First-Job посмотрите на боковую панель навигации слева. Вы увидите опцию под названием Build Now (Собрать сейчас).

2. Нажмите Build Now, чтобы начать процесс сборки.

Как только вы нажмете эту кнопку, будет запланирована новая сборка. Вы увидите ее в разделе Build History (История сборок) в левом нижнем углу. Сборке будет присвоен номер, начиная с #1.

Рядом с номером сборки появится небольшой значок состояния. Мигающий зеленый значок означает, что сборка выполняется (in progress). Сплошной зеленый круг означает, что сборка прошла успешно (successful). Поскольку наше задание очень простое, оно завершится всего за секунду или две.

Теперь вы успешно запустили свою первую сборку.

Просмотр вывода консоли

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

1. На странице проекта My-First-Job посмотрите на раздел Build History (История сборок) в левом нижнем углу. Вы должны увидеть вашу первую сборку с меткой #1 и зеленым кружком, указывающим на успех.

2. Нажмите на номер сборки #1, чтобы перейти на страницу сведений об этой конкретной сборке.

3. На странице сборки вы увидите различные детали о сборке, например, когда она выполнялась. Самая важная ссылка здесь для отладки — Console Output (Вывод консоли). Нажмите на Console Output в левой боковой панели.

4. Страница вывода консоли отображает подробный журнал каждого действия, которое Jenkins выполнил во время сборки. Вы увидите, что Jenkins начал сборку, выполнил вашу shell-команду, а затем отметил сборку как завершенную.

Вывод должен выглядеть примерно так:

Started by user admin
Running as SYSTEM
Building in workspace /var/jenkins_home/workspace/My-First-Job
[My-First-Job] $ /bin/sh -xe /tmp/jenkins12345.sh
+ echo 'Hello from my first Jenkins job!'
Hello from my first Jenkins job!
Finished: SUCCESS

Как видите, журнал включает настроенную нами команду echo и ее вывод: Hello from my first Jenkins job!. Окончательный статус Finished: SUCCESS подтверждает, что задание выполнилось без каких-либо ошибок.

Резюме

Поздравляем с завершением этой вводной лабораторной работы. Вы успешно сделали первые шаги в мир Jenkins.

В этой лабораторной работе вы научились:

• Получать доступ к панели управления Jenkins и определять ее ключевые компоненты.
• Создавать новый Freestyle-проект с нуля.
• Настраивать простой шаг сборки "Execute shell" (Выполнить shell).
• Вручную запускать сборку для вашего проекта.
• Находить и просматривать историю сборок и подробный вывод консоли для проверки результата.

Эти фундаментальные навыки являются основой для создания более сложных и мощных конвейеров автоматизации. Теперь вы хорошо подготовлены к изучению более продвинутых функций Jenkins.