Начало работы. Установка Jenkins на виртуальной машине Linux Azure

В этой статье показано, как установить Jenkins на виртуальной машине Ubuntu Linux с помощью средств и подключаемых модулей, настроенных для работы с Azure.

В этой статье вы узнаете, как:

• Создание файла установки, скачивающего и устанавливающего Jenkins
• Создайте группу ресурсов
• Создание виртуальной машины с файлом установки
• Откройте порт 8080, чтобы получить доступ к Jenkins на виртуальной машине
• Подключение к виртуальной машине через SSH
• Настройка примера задания Jenkins на основе примера приложения Java в GitHub
• Создание примера задания Jenkins

1. Настройка среды

• Подписка Azure. Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем начинать работу.

2. Откройте Cloud Shell

1. Если у вас уже открыт сеанс Cloud Shell, перейдите к следующему разделу.

2. Перейдите на портал Azure

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

4. Откройте Cloud Shell.

   

5. Если вы ранее не использовали Cloud Shell, настройте параметры среды и хранилища.

6. Выберите среду командной строки.

   

3. Создание виртуальной машины

1. Создайте тестовый каталог с именем jenkins-get-started.

2. Перейдите в тестовый каталог.

3. Создайте файл с именем cloud-init-jenkins.txt.

4. Вставьте следующий код в новый файл:

   #cloud-config
   package_upgrade: true
   runcmd:
     - sudo apt install openjdk-17-jre -y
     - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
     -  echo 'deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/' | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
     - sudo apt-get update && sudo apt-get install jenkins -y
     - sudo service jenkins restart
   
   
   

5. Запустите az group create, чтобы создать группу ресурсов.

   az group create --name jenkins-get-started-rg --location eastus
   

6. Запустите az vm create , чтобы создать виртуальную машину.

   az vm create \
   --resource-group jenkins-get-started-rg \
   --name jenkins-get-started-vm \
   --image UbuntuLTS \
   --admin-username "azureuser" \
   --generate-ssh-keys \
   --public-ip-sku Standard \
   --custom-data cloud-init-jenkins.txt
   

7. Запустите az vm list , чтобы проверить создание (и состояние) новой виртуальной машины.

   az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
   

8. Так как Jenkins выполняется через порт 8080, запустите az vm open , чтобы открыть порт 8080 на новой виртуальной машине.

   az vm open-port \
   --resource-group jenkins-get-started-rg \
   --name jenkins-get-started-vm  \
   --port 8080 --priority 1010
   

4. Настройка Jenkins

1. Запустите az vm show , чтобы получить общедоступный IP-адрес для примера виртуальной машины.

   az vm show \
   --resource-group jenkins-get-started-rg \
   --name jenkins-get-started-vm -d \
   --query [publicIps] \
   --output tsv
   

   Ключевые моменты:

   • Параметр --query ограничивает выходные данные общедоступными IP-адресами виртуальной машины.

2. Используя IP-адрес, полученный на предыдущем шаге, выполните SSH-подключение к виртуальной машине. Вам потребуется подтвердить запрос на подключение.

   ssh azureuser@<ip_address>
   

   Ключевые моменты:

   • При успешном подключении запрос Cloud Shell содержит имя пользователя и имя виртуальной машины: azureuser@jenkins-get-started-vm

3. Убедитесь, что Jenkins запущен, получив состояние службы Jenkins.

   service jenkins status
   

   Ключевые моменты:

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

4. Получите автоматически созданный пароль Jenkins.

   sudo cat /var/lib/jenkins/secrets/initialAdminPassword
   

5. Используя IP-адрес, откройте следующий URL-адрес в браузере: http://<ip_address>:8080

6. Введите пароль, полученный ранее, и нажмите кнопку "Продолжить".

   

7. Выберите плагин для установки.

   

8. В поле фильтра в верхней части страницы введите github. Выберите подключаемый модуль GitHub и нажмите кнопку "Установить".

   

9. Введите сведения для первого пользователя администратора и нажмите кнопку "Сохранить и продолжить".

   

10. На странице "Конфигурация экземпляра" нажмите кнопку "Сохранить и завершить".

    

11. Нажмите кнопку "Пуск" с помощью Jenkins.

    

5. Создание первого задания

1. На домашней странице Jenkins нажмите кнопку "Создать задание".

   

2. Введите имя mySampleAppзадания, выберите проект Freestyle и нажмите кнопку "ОК".

   

3. Перейдите на вкладку "Управление исходным кодом". Включите Git и введите следующий URL-адрес для значения URL-адреса репозитория: https://github.com/spring-guides/gs-spring-boot.git Затем измените спецификатор ветви на */main.

   

4. Выберите вкладку "Сборка", а затем выберите "Добавить шаг сборки"

   

5. В раскрывающемся меню выберите "Вызвать скрипт Gradle".

   

6. Выберите "Использовать оболочку Gradle", а затем введите completeрасположение оболочки и build для задач.

   

7. Выберите Дополнительно и введите complete в поле корневого скрипта сборки.

   

8. Прокрутите страницу до нижней части страницы и нажмите кнопку "Сохранить".

6. Создание примера приложения Java

1. При отображении домашней страницы проекта выберите "Создать сейчас ", чтобы скомпилировать код и упаковать пример приложения.

   

2. Под графиком под заголовком История сборок показано, что работа находится в процессе сборки.

   

3. По завершении сборки выберите ссылку "Рабочая область ".

   

4. Перейдите по адресу complete/build/libs, чтобы убедиться, что файл .jar был успешно построен.

   

5. Теперь сервер Jenkins готов к созданию собственных проектов в Azure!

Устранение неполадок

Если возникли проблемы с настройкой Jenkins, перейдите на страницу установки Jenkins , чтобы получить последние инструкции и известные проблемы.

Дальнейшие шаги