Как начать работу с бессерверными функциями DigitalOcean

function main(args) {
    return {
        body: {
            value: (args.value * 2),
            timestamp: Date.now()
        },
        headers: {
            "Content-Type": "application/json"
        }
    };
}

Повторно разверните свою функцию:

$ doctl serverless deploy .

Эта функция наивно удваивает число, заданное параметром запроса value. Он также включает отметку времени для каждого тела ответа. Поле headers используется в объекте ответа для применения правильного JSON Content-Type.

Вы можете вызвать эту функцию с помощью Doctl или curl в том же стиле, что и раньше:

$ curl $URL?value=2
{
  "timestamp": 1654784122966,
  "value": 4
}

Повторное развертывание функции вручную после каждого изменения утомительно и требует много времени. Запустите команду watch во время работы, чтобы автоматически внедрять изменения после изменения файлов:

$ doctl serverless watch .
Watching '.' [use Control-C to terminate]

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

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

$ doctl serverless activations logs --follow --function sample/hello

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

Развертывание в рабочей среде

Команда serverless deploy в настоящее время предназначена только для разработчиков. Вы можете развернуть его в рабочей среде, создав репозиторий Git для своего проекта «Функции» и запустив его с помощью платформы приложений DigitalOcean.

Создайте новый проект на GitHub или GitLab и загрузите свой код:

$ git init
$ git remote add origin git@github.com:user/repo.git
$ git add .
$ git commit -m "initial commit"
$ git push -u origin master

Затем перейдите на панель управления DigitalOcean и нажмите ссылку «Приложения» на левой боковой панели. Нажмите появившуюся кнопку «Создать приложение». На следующем экране следуйте инструкциям, чтобы подключиться к своей учетной записи GitHub и выбрать новый репозиторий. Нажмите синюю кнопку «Далее».

DigitalOcean автоматически обнаружит ваш репозиторий как проект Functions, если у вас есть project.yml в его корне. Нажмите кнопку «Перейти к просмотру», чтобы продолжить.

Следующий экран должен подтвердить, что вам будет выставлен счет с использованием плана «Функции».

Нажмите «Создать ресурсы», чтобы подготовить приложение и начать его первое развертывание. Прогресс будет отображаться на панели инструментов.

Конечные точки вашей функции станут общедоступными после завершения развертывания. Вы можете найти домен ondigitalocean.app вашего приложения по умолчанию, прокрутив вниз страницу настроек приложения на панели инструментов. В нашем примере домен приложения — sea-lion-app.7ougx.ondigitalocean.app.

Функции автоматически отображаются как URI следующего формата:

<app>.ondigitalocean.app/<function-package>/<function-action>

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

$ curl https://sea-lion-app.7ougx.ondigitalocean.app/sample/hello?value=2
{
  "timestamp": 1654786505969,
  "value": 4
}

Функция успешно развернута! Теперь вы можете использовать вкладку «Домены» в настройках вашего приложения, чтобы прикрепить собственный домен вместо домена по умолчанию.

Краткое содержание

DigitalOcean Functions — новейший конкурент на все более переполненной арене бессерверных функций. Платформа позволяет разрабатывать функциональные возможности на стороне сервера без управления виртуальными машинами или контейнеризации кода вручную.

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

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