Руководство по развертыванию на платформе Azure Functions с помощью Jenkins

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

Предпосылки

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

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

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

Создание функции 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 поможет вам выполнить процесс.

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

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

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

   sudo apt install -y maven
   

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

   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. Пошаговые инструкции см. в статье "Развертывание в службе приложений Azure ".

7. Убедитесь, что плагин «Учетные данные» установлен.

   1. В меню выберите "Управление Jenkins".

   2. В разделе "Конфигурация системы" выберите "Управление подключаемым модулем".

   3. Выберите вкладку "Установленная".

   4. В поле фильтра введите credentials.

   5. Убедитесь, что плагин Учетные данные установлен. Если нет, его необходимо установить на вкладке "Доступно ".

   

8. В меню выберите "Управление Jenkins".

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

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

11. В меню выберите "Добавить учетные данные".

12. Введите следующие значения для служебного принципала Microsoft Azure:

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

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

Создайте форк образца репозитория GitHub

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

2. В правом верхнем углу на GitHub выберите Fork.

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

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

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

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

2. Активируйте подготовку среды для запуска.

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

4. Введите URL-адрес форка вашего репозитория на GitHub и путь сценария ("doc/resources/jenkins/JenkinsFile"), чтобы использовать в примере 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. Сначала получите ключ авторизации с помощью инструкций, приведенных в статье "Триггеры и привязки функций 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>

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