Первое, что вам нужно будет установить, - это основные инструменты функций Azure. Это пакет NPM, который установит необходимые исполняемые файлы для создания приложения Azure Functions.
"Инструкция по установке."
Затем давайте создадим демонстрационное приложение для работы с помощью следующей команды.
func init DemoProject
Эта команда создаст для вас новую папку, включая:
- local.settings.json
Этот файл является эквивалентом переменных среды вашего проекта. Используйте его для хранения всех настроек приложения и строк подключения.
Обратите внимание, что этот файл не будет использоваться при развертывании приложения в Azure.
Теперь давайте создадим нашу первую функцию.
func new --language JavaScript --template HttpTrigger --name HelloWorld
Эта команда создаст новую папку с именем HelloWorld, в которую входят:
- index.js
Этот файл включает исходный код функции HelloWorld.
- function.json
Файл также включает конфигурацию для функции HelloWorld, такую как тип триггера, привязки ввода и вывода. Более подробную информацию вы можете найти по этой ссылке.
Главное, что нужно заметить в этом файле, - это то, что он экспортирует только одну функцию.
По умолчанию среда выполнения функций Azure ищет код функции в файле с именем index.js, а затем выполняет экспортированную функцию.
Если вы экспортируете более одной функции, вам нужно будет назвать функцию по умолчанию «index» или «run». В качестве альтернативы вы можете использовать function.json для определения точки входа.
npm init
Затем давайте установим TypeScript:
npm install --save typescript
После этого давайте сгенерируем файл конфигурации TypeScript, запустив:
tsc --init
Оптимальный файл tsconfig будет выглядеть примерно так:
Обратите внимание, что для параметра sourceMap должно быть установлено значение true, чтобы упростить отладку, особенно с VSCode.
Перейдите к функции HelloWorld и создайте новый файл index.ts. Этот файл будет экспортировать функцию под названием index, которая принимает контекст и запрос в качестве аргументов.
Функция Azure принимает файлы .js, что означает, что сначала необходимо скомпилировать файл index.ts, выполнив следующие действия:
tsc
Это создаст:
- index.js
- index.map.js
И теперь ваша функция готова к выполнению.
Наконец, для эффективного опыта разработки мы будем использовать nodemon. Nodemon будет следить за всеми внесенными изменениями и автоматически компилировать файлы TypeScript в JavaScript.
npm install --save nodemon
Nodemon можно настроить на отслеживание файлов .ts и запуск команды при каждом изменении файла.
nodemon -e ts --exec tsc
Это все, что нужно для того, чтобы TypeScript был добавлен в вашу кодовую базу Функций Azure. В следующей части я рассмотрю процесс настройки конвейера CI с помощью VSTS для нашего приложения HelloWorld Functions.