Бөлісу құралы:

Краткое руководство. Создание приложения Устойчивые функции PowerShell

  • Мақала

Используйте Устойчивые функции, функцию Функции Azure для записи функций с отслеживанием состояния в бессерверной среде. Чтобы установить Устойчивые функции, установите расширение Функции Azure в Visual Studio Code. Расширение управляет состоянием, контрольными точками и перезапускается в приложении.

В этом кратком руководстве вы используете расширение Устойчивые функции в Visual Studio Code для локального создания и тестирования приложения hello world Устойчивые функции в Функции Azure. Устойчивые функции оркестрации и цепочки приложений объединяют вызовы к другим функциям. Затем вы публикуете код функции в Azure. Используемые средства доступны через расширение Visual Studio Code.

Запуск приложения Устойчивые функции в Azure.

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

Для работы с этим кратким руководством вам понадобится:

  • Установленный экземпляр Visual Studio Code.

  • Установленное Функции Azure расширение Visual Studio Code.

  • Последняя версия установленных Функции Azure Core Tools.

  • Средство тестирования HTTP, которое обеспечивает безопасность данных. Дополнительные сведения см. в средствах тестирования HTTP.

  • Подписка Azure. Чтобы использовать Устойчивые функции, у вас должна быть учетная запись служба хранилища Azure.

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

Создание локального проекта

В этом разделе вы используете Visual Studio Code. чтобы создать локальный проект Функций Azure.

  1. В Visual Studio Code выберите F1 (или нажмите клавиши CTRL/CMD+SHIFT+P), чтобы открыть палитру команд. В командной строке (>), введите и выберите Функции Azure: Создать проект.

    Снимок экрана: команда

  2. Выберите Обзор. В диалоговом окне "Выбор папки" перейдите в папку, используемую для проекта, и нажмите кнопку "Выбрать".

  3. В запросах укажите следующие сведения:

    Prompt Действие Description
    Выбор языка для проекта приложения-функции Выберите PowerShell. Создает локальный проект функций PowerShell.
    Выбор версии Выберите Функции Azure версии 4. Этот параметр отображается только в том случае, если основные инструменты еще не установлены. В этом случае основные средства устанавливаются при первом запуске приложения.
    Выбор шаблона для первой функции проекта выберите Пока пропустить.
    Выбор способа открытия проекта Выберите "Открыть" в текущем окне. Открывает Visual Studio Code в выбранной папке.

Visual Studio Code устанавливает Функции Azure Core Tools, если требуется создать проект. Кроме того, создается проект приложения-функции в папке. Проект будет содержать файлы конфигурации host.json и local.settings.json.

В корневой папке также создается файл package.json .

Настройка приложения-функции для использования PowerShell 7

Откройте файл local.settings.json и убедитесь, что для параметра с именем FUNCTIONS_WORKER_RUNTIME_VERSION задано значение ~7. Если он отсутствует или задано другое значение, обновите содержимое файла.

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "powershell",
    "FUNCTIONS_WORKER_RUNTIME_VERSION" : "~7"
  }
}

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

Самый простой Устойчивые функции приложение имеет три функции:

  • Функция Orchestrator: рабочий процесс, который оркеструет другие функции.
  • Функция действия: функция, вызываемая функцией оркестратора, выполняет работу и при необходимости возвращает значение.
  • Клиентская функция: обычная функция в Azure, которая запускает функцию оркестратора. В этом примере используется функция, активироваемая HTTP.

Функция оркестратора

Используйте шаблон для создания кода приложения Устойчивые функции в проекте.

  1. В палитре команд введите и выберите Функции Azure: Создать функцию.

  2. В запросах укажите следующие сведения:

    Prompt Действие Description
    Выбор шаблона для функции Введите оркестратор Устойчивые функции. Создает оркестрацию приложений Устойчивые функции.
    Укажите имя функции Введите HelloOrchestrator. Имя устойчивой функции.

Вы добавили оркестратор для координации функций действий. Откройте файл HelloOrchestrator/run.ps1, чтобы ознакомиться с функцией оркестратора. Каждый вызов командлета Invoke-ActivityFunction вызывает функцию действия с именем Hello.

Затем добавьте указанную Hello функцию действия.

Функция действия

  1. В палитре команд введите и выберите Функции Azure: Создать функцию.

  2. В запросах укажите следующие сведения:

    Prompt Действие Description
    Выбор шаблона для функции Выберите действие Устойчивые функции. Создает функцию действия.
    Укажите имя функции Введите Hello. Имя функции действия.

Вы добавили Hello функцию действия, вызываемую оркестратором. Откройте файл Hello/run.ps1 и убедитесь, что эта функция принимает имя в качестве входных данных и возвращает приветствие. Функция действия — это выполнение таких действий, как вызов базы данных или выполнение вычисления.

Наконец, вы добавите функцию, активированную HTTP, которая запускает оркестрацию.

Функция клиента (начальный объект HTTP)

  1. В палитре команд введите и выберите Функции Azure: Создать функцию.

  2. В запросах укажите следующие сведения:

    Prompt Действие Description
    Выбор шаблона для функции Выберите начальный Устойчивые функции HTTP. Создает начальную функцию HTTP.
    Укажите имя функции Введите HttpStart. Имя функции действия.
    Уровень авторизации Выберите "Анонимный". Для демонстрационных целей это значение позволяет вызывать функцию без использования проверки подлинности.

Вы добавили функцию, активированную HTTP, которая запускает оркестрацию. Откройте HttpStart/run.ps1 , чтобы проверить, используется ли командлет Start-NewOrchestration для запуска новой оркестрации. Затем он использует командлет New-OrchestrationCheckStatusResponse для возврата HTTP-ответа, содержащего URL-адреса, которые можно использовать для мониторинга и управления новым оркестрацией.

Теперь у вас есть приложение Устойчивые функции, которое можно запустить локально и развернуть в Azure.

Примечание.

Следующая версия приложения PowerShell Устойчивые функции теперь доступна в предварительной версии. Его можно скачать из коллекция PowerShell. Узнайте больше об этом и узнайте, как попробовать его в руководстве по автономному пакету SDK PowerShell. Чтобы включить его, следуйте инструкциям, совместимым с этим кратким руководством.

Локальное тестирование функции

Функции Azure Core Tools предоставляет возможность запуска проекта Функции Azure на локальном компьютере разработки. Вам будет предложено установить эти средства при первом запуске функции в Visual Studio.

  1. Чтобы проверить функцию, установите точку останова Hello в коде функции действия (в Hello/run.ps1). Выберите F5 или выберите "Отладка " в палитре команд, чтобы запустить проект приложения-функции. Выходные данные основных инструментов отображаются на панели терминала.

    Примечание.

    Дополнительные сведения об отладке см. в Устойчивые функции диагностика.

  2. Устойчивые функции требуется выполнить учетную запись хранения Azure. Когда Visual Studio Code предложит выбрать учетную запись хранения, щелкните Выбрать учетную запись хранения.

    Снимок экрана: команда

  3. В запросах укажите следующие сведения, чтобы создать новую учетную запись хранения в Azure.

    Prompt Действие Description
    Выбор подписки Выберите имя подписки. Вашу подписку Azure.
    Выбрать учетную запись хранения Выберите Создать новую учетную запись хранения.
    Введите имя новой учетной записи хранения Введите уникальное имя. Имя учетной записи хранения для создания.
    Выбор группы ресурсов Введите уникальное имя. Имя создаваемой группы ресурсов.
    Выбор расположения Выберите регион Azure. Выберите регион, близкий к вам.

  4. На панели терминала скопируйте конечную точку URL-адреса функции, активируемой HTTP.

    Снимок экрана с локальными выходными данными в Azure.

  5. Используйте браузер или средство тестирования HTTP для отправки HTTP-запроса POST в конечную точку URL-адреса.

    Последний сегмент замените именем функции оркестратора (HelloOrchestrator в нашем примере). URL-адрес должен выглядеть приблизительно так: http://localhost:7071/api/orchestrators/HelloOrchestrator.

    Ответ — это начальный результат функции HTTP. Он позволяет узнать, что устойчивый оркестрация успешно запущена. Он еще не отображает конечный результат оркестрации. Ответ включает несколько полезных URL-адреса. Теперь запросите состояние оркестрации.

  6. Скопируйте значение URL-адреса для statusQueryGetUri, вставьте его в адресную строку браузера и выполните запрос. Вы также можете продолжать использовать средство тестирования HTTP для выдачи запроса GET.

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

    {
    "name": "HelloOrchestrator",
    "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
    "runtimeStatus": "Completed",
    "input": null,
    "customStatus": null,
    "output": [
        "Hello Tokyo!",
        "Hello Seattle!",
        "Hello London!"
    ],
    "createdTime": "2020-03-18T21:54:49Z",
    "lastUpdatedTime": "2020-03-18T21:54:54Z"
}

  7. Чтобы остановить отладку, в Visual Studio Code выберите SHIFT+F5.

После проверки правильности работы функции на локальном компьютере пришло время опубликовать проект в Azure.

Вход в Azure

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

  1. Если вы еще не вошли, на панели действий выберите значок Azure. Затем в разделе "Ресурсы" выберите вход в Azure.

    Снимок экрана: вход в окно Azure в Visual Studio Code.

    Если вы уже выполнили вход и видите существующие подписки, перейдите к следующему разделу. Если у вас еще нет учетной записи Azure, выберите "Создать учетную запись Azure". Учащиеся могут выбрать "Создать учетную запись Azure для учащихся".

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

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

Создание приложения-функции в Azure

В этом разделе показано, как создать приложение-функцию и связанные ресурсы в подписке Azure. Многие решения по созданию ресурсов принимаются на основе поведения по умолчанию. Для получения большего контроля над созданными ресурсами необходимо создать приложение-функцию с дополнительными параметрами.

  1. В Visual Studio Code нажмите клавишу F1, чтобы открыть палитру команд. В командной строке (>), введите и выберите Функции Azure: создание приложения-функции в Azure.

  2. В запросах укажите следующие сведения:

    Prompt Действие
    Выбор подписки Выберите подписку Azure для использования. Запрос не отображается, если в разделе "Ресурсы" отображается только одна подписка.
    Ввод глобально уникального имени для приложения-функции Введите имя, допустимое в URL-пути. Введенное имя проверяется, чтобы убедиться, что оно уникально в Функции Azure.
    Выберите стек сред выполнения Выберите языковую версию, выполняемую локально.
    Выбор расположения для новых ресурсов Выберите регион Azure. Для повышения производительности выберите регион рядом с вами.

    На панели "Журнал действий" расширение Azure отображает состояние отдельных ресурсов, созданных в Azure.

    Снимок экрана: журнал создания ресурсов Azure.

  3. При создании приложения-функции в подписке Azure создаются следующие связанные ресурсы. Ресурсы именуются на основе имени, введенного для приложения-функции.

    • группу ресурсов — логический контейнер связанных ресурсов;
    • Учетная запись хранения Azure уровня "Стандартный" для сохранения состояния и других сведений о проектах.
    • Приложение-функция, которое предоставляет окружение для выполнения кода вашей функции. Приложение-функция позволяет группировать функции в логические единицы и упростить развертывание, масштабирование и совместное использование ресурсов, а также управление ими в рамках единого плана размещения.
    • План службы приложение Azure, определяющий базовый узел приложения-функции.
    • Экземпляр Application Insights, подключенный к приложению-функции, и который отслеживает использование функций в приложении.

    После создания приложения-функции и применения пакета развертывания отобразится уведомление.

    Совет

    По умолчанию ресурсы Azure, необходимые приложению-функции, создаются на основе имени, введенного для приложения-функции. По умолчанию ресурсы создаются с приложением-функцией в той же группе ресурсов. Если вы хотите настроить имена связанных ресурсов или повторно использовать существующие ресурсы, опубликуйте проект с дополнительными параметрами создания.

Развертывание проекта в Azure

Внимание

Развертывание в существующем приложении-функции всегда перезаписывает содержимое этого приложения в Azure.

  1. В палитре команд введите и выберите Функции Azure: Развернуть в приложении-функции.

  2. Выберите только что созданное приложение-функцию. При появлении запроса на перезапись предыдущих развертываний выберите "Развернуть ", чтобы развернуть код функции в новом ресурсе приложения-функции.

  3. После завершения развертывания выберите "Просмотреть выходные данные ", чтобы просмотреть результаты создания и развертывания, включая созданные ресурсы Azure. Если вы пропустили уведомление, выберите значок колокольчика в правом нижнем углу, чтобы увидеть его снова.

    Снимок экрана с окном

Тестирование функции в Azure

  1. Скопируйте URL-адрес триггера HTTP из выходной панели. URL-адрес, вызывающий функцию, активируемую HTTP, должен иметь следующий формат:

    https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

  2. Вставьте новый URL-адрес HTTP-запроса в адресную строку браузера. При использовании опубликованного приложения можно ожидать, что вы получите тот же ответ о состоянии, который вы получили при локальном тестировании.

Приложение PowerShell Устойчивые функции, созданное и опубликованное с помощью Visual Studio Code, готово к использованию.

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

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

Связанный контент