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

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

1. Чтобы создать бакет, выполните команду, указав уникальное имя бакета:

   yc storage bucket create \
     --name <имя_бакета> \
     --default-storage-class standard
   

   Результат:

   name: sample-bucket
   folder_id: b1g5bhjofg7o********
   anonymous_access_flags: {}
   default_storage_class: STANDARD
   versioning: VERSIONING_DISABLED
   created_at: "2026-06-01T04:44:30.688587Z"
   resource_id: e3eqmpmknkus********
   

   Подробнее о команде yc storage bucket create читайте в справочнике CLI.

2. Чтобы загрузить в бакет файл index.html, выполните команду:

   yc storage s3api put-object \
     --bucket <имя_бакета> \
     --key index.html \
     --body "<локальный_путь_к_файлу>" \
     --content-type "text/html"
   

   Где:

   • --bucket — имя бакета, созданного ранее.
   • --body — локальный путь к файлу index.html, скачанному ранее из репозитория. Например: /Users/myuser/repositories/yc-serverless-servlet/src/main/resources/index.html.

   Результат:

   etag: '"f38989ca9039c275f5f56840********"'
   request_id: 72d413fc********
   

   Подробнее о команде yc storage s3api put-object читайте в справочнике CLI.

1. Создайте базу данных в режиме Serverless, указав в команде ее имя:

   yc ydb database create <имя_БД> \
     --serverless
   

   Результат:

   done (22s)
   id: etnm3b9gco6k********
   folder_id: b1g5bhjofg7o********
   created_at: "2026-06-01T04:54:48Z"
   name: sample-database
   status: PROVISIONING
   endpoint: grpcs://ydb.serverless.yandexcloud.net:2135/?database=/ru-central1/b1gj9ja2h4ct********/etnm3b9gco6k********
   serverless_database:
     storage_size_limit: "53687091200"
   location_id: ru-central1
   backup_config:
     backup_settings:
       - name: daily
         backup_schedule:
           daily_backup_schedule:
             execute_time:
               hours: 17
         backup_time_to_live: 604800s
         type: SYSTEM
   document_api_endpoint: https://docapi.serverless.yandexcloud.net/ru-central1/b1gj9ja2h4ct********/etnm3b9gco6k********
   monitoring_config: {}
   

   Сохраните значение поля endpoint. Оно понадобится позднее.

   Подробнее о команде yc ydb database create читайте в справочнике CLI.

2. Установите утилиту YDB CLI, позволяющую работать с базами данных YDB.

3. Сохраните IAM-токен, необходимый для аутентификации запросов через YDB CLI, в переменную окружения IAM_TOKEN:

   export IAM_TOKEN=$(yc iam create-token)
   

4. Создайте таблицу с именем Tasks:

   ydb \
     --endpoint grpcs://ydb.serverless.yandexcloud.net:2135 \
     --database "/ru-central1/b1gj9ja2h4ct********/etnjkrvloo7k********" \
     scripting yql -s \
     "CREATE TABLE Tasks
     (
       TaskId Utf8,
       Name Utf8,
       Description Utf8,
       CreatedAt Datetime,
       PRIMARY KEY (TaskId)
     );"
   

   Где:

   • --endpoint — первая часть значения поля endpoint, сохраненного при создании базы данных (часть до вхождения /?database=). Например, grpcs://ydb.serverless.yandexcloud.net:2135.
   • --database — вторая часть значения поля endpoint (часть после вхождения /?database=). Например: /ru-central1/b1gj9ja2h4ct********/etnjkrvloo7k********.

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

   yc serverless function create \
     --name add-task
   

   Результат:

   id: d4e3reah34e0********
   folder_id: b1g5bhjofg7o********
   created_at: "2026-06-01T05:07:13.071Z"
   name: add-task
   http_invoke_url: https://functions.yandexcloud.net/d4e3reah34e0********
   status: ACTIVE
   

   Сохраните идентификатор созданной функции (значение поля id). Он понадобится позднее при создании API-шлюза.

   Подробнее о команде yc serverless function create читайте в справочнике CLI.

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

   yc serverless function version create \
     --function-name add-task \
     --runtime java21 \
     --service-account-id <идентификатор_сервисного_аккаунта> \
     --entrypoint "yandex.cloud.examples.serverless.todo.AddTaskServlet" \
     --memory 128m \
     --execution-timeout 10s \
     --source-path "./servlet.zip" \
     --environment ENDPOINT="<YDB_эндпоинт>",DATABASE="<имя_БД>"
   

   Где:

   • --function-name — имя функции, версию которой вы хотите создать.

   • --runtime — среда выполнения.

   • --service-account-id — идентификатор сервисного аккаунта, созданного при подготовке окружения.

   • --entrypoint — точка входа, указывается в формате <имя_файла_с_функцией>.<имя_обработчика>.

   • --memory — объем RAM, доступный функции.

   • --execution-timeout — максимальное время выполнения функции до таймаута.

   • --source-path — локальный путь к созданному ранее ZIP-архиву servlet.zip с кодом функции и необходимыми зависимостями.

   • --environment — переменные окружения в формате key=value:

     • ENDPOINT — первая часть значения поля endpoint, сохраненного при создании базы данных (часть между вхождениями grpcs:// и /?database=). Например, ydb.serverless.yandexcloud.net:2135.
     • DATABASE — вторая часть значения поля endpoint (часть после вхождения /?database=). Например: /ru-central1/b1gj9ja2h4ct********/etnjkrvloo7k********.

   Результат:

   done (52s)
   id: d4eve0ahaf3e********
   function_id: d4e3reah34e0********
   created_at: "2026-06-01T05:18:34.900Z"
   ...
   log_options:
     folder_id: b1g5bhjofg7o********
   

   Подробнее о команде yc serverless function version create читайте в справочнике CLI.

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

   yc serverless function allow-unauthenticated-invoke add-task
   

   Подробнее о команде yc serverless function allow-unauthenticated-invoke читайте в справочнике CLI.

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

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

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_id: <идентификатор_сервисного_аккаунта>
         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_id — идентификатор сервисного аккаунта, созданного при подготовке окружения.
   • Блок /add, параметр function_id — идентификатор функции add-task, сохраненный ранее.
   • Блок /list, параметр function_id — идентификатор функции list-tasks, сохраненный ранее.
   • Блок /delete, параметр function_id — идентификатор функции delete-task, сохраненный ранее.

2. Создайте API-шлюз, указав в команде локальный путь к созданному ранее файлу todo.yaml:

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

   Результат:

   done (2s)
   id: d5d9ut8546r7********
   folder_id: b1g5bhjofg7o********
   created_at: "2026-06-01T05:49:08.648Z"
   name: todo-list
   description: simple todo list
   status: ACTIVE
   domain: d5d9ut8546r7********.wnq2w1o5.apigw.yandexcloud.net
   connectivity: {}
   log_options:
     folder_id: b1g5bhjofg7o********
   execution_timeout: 300s
   

   Сохраните доменное имя (значение поля domain) созданного API-шлюза. Шлюз будет доступен по URL-адресу https://<доменное_имя>.

   Подробнее о команде yc serverless api-gateway create читайте в справочнике CLI.