Развертывание веб-приложения с использованием Java Servlet API и YDB

1. Создайте функцию с именем add-task:

   yc serverless function create --name=add-task
   

   Результат:

   id: d4ejb1799eko********
   folder_id: aoek49ghmknn********
   created_at: "2021-03-08T14:07:32.134Z"
   name: add-task
   log_group_id: eolm8aoq9vcp********
   http_invoke_url: https://functions.yandexcloud.net/d4ejb1799eko********
   status: ACTIVE
   

2. Создайте версию функции add-task:

   yc serverless function version create \
     --function-name=add-task \
     --runtime java21 \
     --entrypoint yandex.cloud.examples.serverless.todo.AddTaskServlet \
     --memory 128m \
     --execution-timeout 10s \
     --source-path ./servlet.zip \
     --environment DATABASE=<имя_БД>,ENDPOINT=<YDB_эндпоинт>
   

   Где:

   • --function-name — имя функции, версию которой вы хотите создать.
   • --runtime — среда выполнения.
   • --entrypoint — точка входа, указывается в формате <имя_файла_с_функцией>.<имя_обработчика>.
   • --memory — объем RAM.
   • --execution-timeout — максимальное время выполнения функции до таймаута.
   • --source-path — путь к созданному ранее ZIP-архиву servlet.zip с кодом функции и необходимыми зависимостями.
   • --environment — переменные окружения в формате key=value.

   Результат:

   done (1s)
   id: d4evvn8obisa********
   function_id: d4ejb1799eko********
   ...
   tags:
   - $latest
   log_group_id: ckg3qh8h363p********
   

3. Сделайте функцию публичной:

   yc serverless function allow-unauthenticated-invoke add-task
   

   Результат:

   done (1s)
   

4. Повторите шаги 1-3 и создайте функцию с именем list-tasks и точкой входа yandex.cloud.examples.serverless.todo.ListTasksServlet.

5. Повторите шаги 1-3 и создайте функцию с именем delete-task и точкой входа yandex.cloud.examples.serverless.todo.DeleteTaskServlet.

Воспользуйтесь API методами create, createVersion и setAccessBindings для ресурса Function.

Создать функцию и ее версию можно с помощью плагина Yandex Cloud Toolkit для семейства IDE на платформе IntelliJ от JetBrains.

1. Сохраните следующую спецификацию в файл todo.yaml:

   openapi: 3.0.0
   info:
     title: ToDo list
     version: 1.0.0
   paths:
     /:
       get:
         x-yc-apigateway-integration:
           type: object-storage
           bucket: <бакет>
           object: index.html
           presigned_redirect: false
           service_account: <сервисный_аккаунт>
         operationId: static
     /add:
       post:
         x-yc-apigateway-integration:
           type: cloud-functions
           function_id: <идентификатор_add-task>
         operationId: addTask
     /list:
       get:
         x-yc-apigateway-integration:
           type: cloud-functions
           function_id: <идентификатор_list-tasks>
         operationId: listTasks
     /delete:
       delete:
         x-yc-apigateway-integration:
           type: cloud-functions
           function_id: <идентификатор_delete-task>
         operationId: deleteTask
   

   Где:

   • bucket — имя бакета, в котором лежит файл index.html.
   • service_account — идентификатор сервисного аккаунта, созданного при подготовке окружения.
   • Блок /add, параметр function_id — идентификатор функции add-task.
   • Блок /list, параметр function_id — идентификатор функции list-tasks.
   • Блок /delete, параметр function_id — идентификатор функции delete-task.

2. Создайте API-шлюз:

   yc serverless api-gateway create \
     --name todo-list \
     --spec=todo.yaml \
     --description "simple todo list"
   

   Результат:

   done (41s)
   id: d5delqeel34q********
   folder_id: b1g86q4m5vej********
   created_at: "2021-03-08T14:07:32.134Z"
   name: todo-list
   description: simple todo list
   status: ACTIVE
   domain: d5delqeel34q********.apigw.yandexcloud.net
   log_group_id: ckg2hdmevnvc********
   

Создать API-шлюз можно с помощью плагина Yandex Cloud Toolkit для семейства IDE на платформе IntelliJ от JetBrains.