Руководство. Развертывание в Функции Azure с помощью Jenkins

Важно!

Многие службы Azure используют подключаемые модули Jenkins. Поддержка некоторых таких подключаемых модулей будет прекращена 29 февраля 2024 г. В настоящее время для интеграции Jenkins со службами Azure рекомендуется использовать Azure CLI. Дополнительные сведения см. в статье Подключаемые модули Jenkins для Azure.

Функции Azure — это независимая от сервера служба вычислений. С помощью Функций Azure вы можете выполнить код по требованию, не запуская операции по подготовке инфраструктуры или управлению ею. В этом руководстве описано, как развернуть функцию Java в Функциях Azure с помощью подключаемого модуля для Функций Azure.

Необходимые компоненты

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

Просмотр исходного кода

Используемый в этом руководстве исходный код расположен в репозитории GitHub для Visual Studio China.

Создание функции Java

Чтобы создать функцию Java с помощью стека среды выполнения Java, используйте портал Azure или Azure CLI.

Ниже объясняется, как создать функцию Java с помощью Azure CLI:

1. Создайте группу ресурсов, заменив <заполнитель resource_group> именем группы ресурсов.

   az group create --name <resource_group> --location eastus
   

2. Создайте учетную запись хранения Azure, заменив заполнители соответствующими значениями.

   az storage account create --name <storage_account> --location eastus --resource-group <resource_group> --sku Standard_LRS    
   

3. Создайте приложение-функцию для тестирования, заменив заполнители соответствующими значениями.

   az functionapp create --resource-group <resource_group> --runtime java --consumption-plan-location eastus --name <function_app> --storage-account <storage_account> --functions-version 2
   

Подготовка сервера Jenkins

Ниже описывается, как подготовить сервер Jenkins:

1. Разверните сервер Jenkins в Azure. Если у вас еще не установлен экземпляр сервера Jenkins, в статье Создание сервера Jenkins на виртуальной машине Azure под управлением Linux на портале Azure приведены соответствующие пошаговые инструкции.

2. Войдите в экземпляр Jenkins по SSH.

3. На экземпляре Jenkins установите Az CLI 2.0.67 или более поздней версии.

4. Установите Maven с помощью следующей команды:

   sudo apt install -y maven
   

5. Установите Azure Functions Core Tools на экземпляре Jenkins. Для этого введите следующие команды в строке терминала:

   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
   sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
   sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-$(lsb_release -cs)-prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list'
   cat /etc/apt/sources.list.d/dotnetdev.list
   sudo apt-get update
   sudo apt-get install azure-functions-core-tools-3
   

6. Серверу Jenkins требуется субъект-служба Azure для аутентификации и доступа к ресурсам Azure. Пошаговые инструкции см. в статье Руководство. Развертывание из GitHub в Службе приложений Azure с использованием непрерывной интеграции и непрерывного развертывания Jenkins.

7. Убедитесь, что подключаемый модуль учетных данных установлен.

   1. В меню выберите пункт Manage Jenkins (Управление Jenkins).

   2. В разделе System Configuration (Конфигурация системы) выберите Manage plug-in (Управление подключаемым модулем).

   3. Откройте вкладку Установленные.

   4. В поле Filter (Фильтр) введите credentials.

   5. Убедитесь, что подключаемый модуль учетных данных установлен. В противном случае установите его, перейдя на вкладку Available (Доступно).

   

8. В меню выберите пункт Manage Jenkins (Управление Jenkins).

9. В разделе Security (Безопасность) выберите Manage Credentials (Управление учетными данными).

10. В разделе Credentials (Учетные данные) выберите (global) (Глобальные).

11. В меню выберите пункт Add Credentials (Добавить учетные данные).

12. Введите следующие значения для субъекта-службы Microsoft Azure:

    • Тип: выберите значение: имя пользователя с паролем.
    • Имя пользователя: укажите appId созданный субъект-службу.
    • Пароль: укажите password (секрет) субъекта-службы.
    • Идентификатор: укажите идентификатор учетных данных, например azuresp.

13. Нажмите ОК.

Создание вилки для примера из репозитория GitHub

1. Выполните вход в репозиторий GitHub с примером приложения для четных или нечетных чисел.

2. В правом верхнем углу в GitHub выберите Fork (Создать вилку).

3. Следуя инструкциям на экране, выберите свою учетную запись GitHub и завершите создание вилки.

Создание конвейера Jenkins

В этом разделе описано, как создать конвейер Jenkins.

1. Создайте конвейер на панели мониторинга Jenkins.

2. Установите флажок Prepare an environment for the run (Подготовить среду к запуску).

3. В разделе "Определение конвейера" выберите сценарий конвейера> из SCM.

4. Введите URL-адрес и путь к скрипту (doc/resources/jenkins/JenkinsFile) для своей вилки с GitHub, чтобы использовать их в примере JenkinsFile.

    node {
    withEnv(['AZURE_SUBSCRIPTION_ID=99999999-9999-9999-9999-999999999999',
            'AZURE_TENANT_ID=99999999-9999-9999-9999-999999999999']) {
        stage('Init') {
            cleanWs()
            checkout scm
        }
   
        stage('Build') {
            sh 'mvn clean package'
        }
   
        stage('Publish') {
            def RESOURCE_GROUP = '<resource_group>' 
            def FUNC_NAME = '<function_app>'
            // login Azure
            withCredentials([usernamePassword(credentialsId: 'azuresp', passwordVariable: 'AZURE_CLIENT_SECRET', usernameVariable: 'AZURE_CLIENT_ID')]) {
            sh '''
                az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
                az account set -s $AZURE_SUBSCRIPTION_ID
            '''
            }
            sh 'cd $PWD/target/azure-functions/odd-or-even-function-sample && zip -r ../../../archive.zip ./* && cd -'
            sh "az functionapp deployment source config-zip -g $RESOURCE_GROUP -n $FUNC_NAME --src archive.zip"
            sh 'az logout'
            }
        }
    }
   

Сборка и развертывание

Теперь можно выполнить задание Jenkins.

1. Сначала получите ключ авторизации, выполнив инструкции из статьи Триггеры и привязки HTTP в службе "Функции Azure".

2. Введите URL-адрес приложения в окне браузера. Замените заполнители соответствующими значениями и укажите числовое значение для <input_number> в качестве входных данных для функции Java.

   https://<function_app>.azurewebsites.net/api/HttpTrigger-Java?code=<authorization_key>&number=<input_number>
   

3. Отобразятся результаты, аналогичные приведенным ниже в качестве примера выходным данным (для тестирования использовалось нечетное число 365):

   The number 365 is Odd.
   

Очистка ресурсов

Если вы не собираетесь использовать это приложение в дальнейшем, удалите созданные ресурсы, выполнив следующее действие:

az group delete -y --no-wait -n <resource_group>

Следующие шаги

Функции Azure