Краткое руководство. Создание функции Go или Rust в Azure с помощью Visual Studio Code

Статья
08/03/2023

Из этой статьи вы узнаете, как с помощью Visual Studio Code создать пользовательский обработчик, который отвечает на HTTP-запросы. После тестирования кода в локальной среде его необходимо развернуть в бессерверной среде Функций Azure.

Пользовательские обработчики можно использовать для создания функций на любом языке и в любой среде выполнения, выполняя серверный процесс HTTP. В этой статье описываются процедуры для Go и Rust.

Выполнение этого краткого руководства предполагает небольшую дополнительную плату в несколько центов США в учетной записи Azure.

Настройка вашей среды

Перед началом работы убедитесь, что выполнены следующие предварительные требования.

Go
Rust

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

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
Visual Studio Code на одной из поддерживаемых платформ.
Расширение "Функции Azure" для Visual Studio Code.
Цепочка инструментов Rust и использование rustup. Используйте команду rustc --version, чтобы проверить установленную версию.

Установка или обновление основных средств

Расширение Функции Azure для Visual Studio Code интегрируется с Функции Azure core Tools, чтобы вы могли выполнять и отлаживать функции локально в Visual Studio Code с помощью среды выполнения Функции Azure. Прежде чем приступить к работе, рекомендуется установить Core Tools локально или обновить существующую установку, чтобы использовать последнюю версию.

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

Эта команда запускает установку на основе пакета последней версии Core Tools.

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

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

Щелкните значок Azure на панели действий. Затем в области Рабочая область (локальная) нажмите кнопку + и выберите пункт Создать функцию в раскрывающемся списке. В ответ на запрос выберите вариант Создать проект.
Выберите расположение каталога для рабочей области проекта и нажмите кнопку Выбрать. Нужно либо создать новую папку, либо выбрать пустую папку для рабочей области проекта. Не выбирайте папку проекта, которая является частью рабочей области.

Введите следующие сведения по соответствующим запросам:

Prompt	Выбор
Выбор язык для проекта приложения-функции	Выберите `Custom Handler`.
Выбор шаблона для первой функции проекта	Выберите `HTTP trigger`.
Укажите имя функции	Введите `HttpExample`.
Уровень авторизации	выберите `Anonymous`, что позволит любому пользователю вызывать конечную точку функции. Дополнительные сведения об уровне авторизации см. в разделе Authorization keys (Ключи авторизации).
Выбор способа открытия проекта	Выберите `Open in current window`.

Используя эти сведения, Visual Studio Code создает проект функций Azure с триггером HTTP. Файлы локального проекта можно просмотреть в Explorer.

Создание и сборка функции

Файл function.json в папке HttpExample объявляет функцию для триггера HTTP. Чтобы реализовать эту функцию, вам нужно добавить к ней обработчик и скомпилировать исполняемый файл.

Go
Rust

Нажмите клавиши CTRL+N (или CMD+N в macOS), чтобы создать новый файл. Сохраните его с именем handler.go в корневой папке приложения-функции (где расположен файл host.json).

Добавьте в файл handler.go следующий код и сохраните его. Это и есть ваш пользовательский обработчик Go.

package main

import (
    "fmt"
    "log"
    "net/http"
    "os"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    message := "This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.\n"
    name := r.URL.Query().Get("name")
    if name != "" {
        message = fmt.Sprintf("Hello, %s. This HTTP triggered function executed successfully.\n", name)
    }
    fmt.Fprint(w, message)
}

func main() {
    listenAddr := ":8080"
    if val, ok := os.LookupEnv("FUNCTIONS_CUSTOMHANDLER_PORT"); ok {
        listenAddr = ":" + val
    }
    http.HandleFunc("/api/HttpExample", helloHandler)
    log.Printf("About to listen on %s. Go to https://127.0.0.1%s/", listenAddr, listenAddr)
    log.Fatal(http.ListenAndServe(listenAddr, nil))
}

Нажмите клавиши CTRL+SHIFT+' или выберите команду New Terminal (Создать терминал) в меню Terminal (Терминал), чтобы открыть новый встроенный терминал VS Code.
Скомпилируйте этот пользовательский обработчик с помощью следующей команды. Исполняемый файл с именем handler (handler.exe в Windows) выводится в корневую папку приложения-функции.
```
go build handler.go
```

Нажмите клавиши CTRL+SHIFT+' или выберите команду New Terminal (Создать терминал) в меню Terminal (Терминал), чтобы открыть новый встроенный терминал VS Code.
В корневой папке приложения-функции (где размещен файл host.json) инициализируйте проект Rust с именем handler.
```
cargo init --name handler
```
В файл Cargo.toml добавьте следующие зависимости, требуемые для работы с этим кратким руководством. В нашем примере используется платформа веб-сервера warp.
```
[dependencies]
warp = "0.3"
tokio = { version = "1", features = ["rt", "macros", "rt-multi-thread"] }
```

Добавьте в файл src/main.rs следующий код и сохраните его. Это и есть ваш пользовательский обработчик Rust.

use std::collections::HashMap;
use std::env;
use std::net::Ipv4Addr;
use warp::{http::Response, Filter};

#[tokio::main]
async fn main() {
    let example1 = warp::get()
        .and(warp::path("api"))
        .and(warp::path("HttpExample"))
        .and(warp::query::<HashMap<String, String>>())
        .map(|p: HashMap<String, String>| match p.get("name") {
            Some(name) => Response::builder().body(format!("Hello, {}. This HTTP triggered function executed successfully.", name)),
            None => Response::builder().body(String::from("This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.")),
        });

    let port_key = "FUNCTIONS_CUSTOMHANDLER_PORT";
    let port: u16 = match env::var(port_key) {
        Ok(val) => val.parse().expect("Custom Handler port is not a number!"),
        Err(_) => 3000,
    };

    warp::serve(example1).run((Ipv4Addr::LOCALHOST, port)).await
}

Скомпилируйте двоичный файл для этого обработчика. Исполняемый файл с именем handler (handler.exe в Windows) выводится в корневую папку приложения-функции.
```
cargo build --release
cp target/release/handler .
```

Настройка приложения-функции

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

Откройте файл host.json.
В разделе customHandler.description задайте значение defaultExecutablePath для параметра handler (или handler.exe в среде Windows).
В разделе customHandler добавьте свойство с именем enableForwardingHttpRequest и задайте для него значение true. Для функций, которые содержат только триггер HTTP, этот параметр упрощает программирование. Он позволяет работать с обычным HTTP-запросом вместо полезных данных пользовательского обработчика запросов.

Убедитесь, что раздел customHandler похож на представленный здесь пример. Сохраните файл.

"customHandler": {
  "description": {
    "defaultExecutablePath": "handler",
    "workingDirectory": "",
    "arguments": []
  },
  "enableForwardingHttpRequest": true
}

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

Локальное выполнение функции

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

В интегрированном терминале запустите приложение-функцию с помощью Azure Functions Core Tools.
```
func start
```
Запустив Core Tools, перейдите по указанному далее URL-адресу, чтобы выполнить запрос GET, который включает строку запроса ?name=Functions.

http://localhost:7071/api/HttpExample?name=Functions
Возвращается ответ, который в браузере выглядит следующим образом:
Сведения о запросе отображаются на панели Терминал.
Чтобы остановить работу Core Tools, нажмите клавиши CTRL+C.

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

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

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

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

Компиляция пользовательского обработчика для Azure

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

Go
Rust

Во встроенном терминале скомпилируйте обработчик для Linux/x64. В корневой папке приложения-функции будет создан двоичный файл с именем handler.
- macOS
- Linux
- Windows
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
set GOOS=linux
set GOARCH=amd64
go build handler.go
```
Для параметра defaultExecutablePath в файле host.json измените значение handler.exe на handler. Теперь приложение-функция будет выполнять двоичный файл Linux.

Создайте файл в .cargo/config. Добавьте следующее содержимое и сохраните файл.
```
[target.x86_64-unknown-linux-musl]
linker = "rust-lld"
```
Во встроенном терминале скомпилируйте обработчик для Linux/x64. Будет создан двоичный файл с именем handler. Скопируйте его в корневую папку приложения-функции.
```
rustup target add x86_64-unknown-linux-musl
cargo build --release --target=x86_64-unknown-linux-musl
cp target/x86_64-unknown-linux-musl/release/handler .
```
Если вы используете ОС Windows, для параметра defaultExecutablePath в файле host.json измените значение с handler.exe на handler. Теперь приложение-функция будет выполнять двоичный файл Linux.
Добавьте следующую строку в файл .funcignore.
```
target
```
Это предотвращает публикацию содержимого папки target.

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

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

Щелкните значок Azure на панели действий. Затем в области Ресурсы щелкните значок + и выберите вариант Создать приложение-функцию в Azure.

Введите следующие сведения по соответствующим запросам:

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

Расширение показывает состояние отдельных ресурсов по мере их создания в Azure на панели Azure: журнал действий.

Журнал создания ресурсов Azure

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

Совет

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

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

Внимание

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

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

Запуск функции в Azure

Вернитесь в область Ресурсы на боковой панели, разверните подписку, выберите новое приложение-функцию и Функции. Щелкните правой кнопкой мыши (в Windows) или используйте Ctrl-щелчок (в macOS) на функции HttpExample и выберите Выполнить функцию....
В поле Введите текст запроса отображается текст сообщения запроса { "name": "Azure" }. Нажмите клавишу ВВОД, чтобы отправить это сообщение запроса в свою функцию.
При выполнении функции в Azure и возврате ответа в Visual Studio Code отобразится уведомление.

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

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

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

В Visual Studio Code нажмите клавишу F1, чтобы открыть палитру команд. В палитре команд найдите и щелкните Azure: Open in portal.
Выберите приложение-функцию и нажмите клавишу ВВОД. Страница приложения-функции откроется на портале Azure.
На вкладке Обзор выберите именованную ссылку рядом с полем Группа ресурсов.
На странице Группа ресурсов просмотрите список включенных ресурсов и убедитесь, что именно их нужно удалить.
Выберите Удалить группу ресурсов и следуйте инструкциям.

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

Дополнительные сведения о затратах на использование Функций см. в статье Оценка затрат на план потребления.

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

Сведения о пользовательских обработчиках в Функциях Azure

Share via

Краткое руководство. Создание функции Go или Rust в Azure с помощью Visual Studio Code

Настройка вашей среды

Установка или обновление основных средств

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

Создание и сборка функции

Настройка приложения-функции

Локальное выполнение функции

Компиляция пользовательского обработчика для Azure

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

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

Запуск функции в Azure

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

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

Дополнительные ресурсы

Share via

Краткое руководство. Создание функции Go или Rust в Azure с помощью Visual Studio Code

Настройка вашей среды

Установка или обновление основных средств

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

Создание и сборка функции

Настройка приложения-функции

Локальное выполнение функции

Вход в Azure

Компиляция пользовательского обработчика для Azure

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

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

Запуск функции в Azure

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

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

Дополнительные ресурсы