Управление версиями функции

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

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

$ yc serverless function list

Результат:

+----------------------+--------------------+----------------------+--------+
|          ID          |        NAME        |      FOLDER ID       | STATUS |
+----------------------+--------------------+----------------------+--------+
| b097d9ous3gep99khe83 | my-beta-function   | aoek49ghmknnpj1ll45e | ACTIVE |
+----------------------+--------------------+----------------------+--------+

Управление версиями функции позволяет:

• Создать версию
• Получить информацию о версии функции
  • Получить список версий функции
  • Получить подробную информацию о версии функции
• Управлять тегами версии

Также вы можете изменить код функции с помощью редактора кода.

Создать версию функции

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

Подготовить ZIP-архив с кодом функции

1. Сохраните следующий код в файл с названием index.js:

   exports.handler = async function (event, context) {
       let name = 'World';
       if (event.queryStringParameters && event.queryStringParameters.name) {
           name = event.queryStringParameters.name
       }
       return {
           'statusCode': 200,
           'headers': {
               'Content-Type': 'text/plain'
           },
           'isBase64Encoded': false,
           'body': `Hello, ${name}!`
       }
   };
   

2. Добавьте файл index.js в ZIP-архив hello-js.zip.

Создать версию функции

При создании версии необходимо задать следующие параметры:

• Среда выполнения — предоставляет дополнительные библиотеки и переменные окружения, к которым можно получить доступ из кода функции. Соответствует языку программирования, на котором написана ваша функция.
• Точка входа — имя функции, которая будет вызываться в качестве обработчика. Подробнее об обработчике читайте в разделе Модель программирования.
• Таймаут — максимальное время выполнения функции, после которого сервис прервет выполнение, не дожидаясь ответа. Включает в себя время начальной инициализации при первом запуске.

$ yc serverless function version create \
--function-name=my-nodejs-function \ # Имя функции.
--runtime nodejs12 \ # Среда выполенения.
--entrypoint index.handler \ # Обработчик, указывается в формате <имя файла с функцией>.<имя обработчика>.
--memory 128m \ # Объем RAM.
--execution-timeout 5s \ # Максимальное время выполнения функции до таймаута.
--source-path ./hello-js.zip # ZIP-архив c кодом функции и всеми необходимыми зависимостями.    

done (1s)
id: d4evvn8obisajd51plaq
function_id: d4elpv8pft639ku7k0u6
created_at: "2020-08-01T19:09:19.531Z"
runtime: nodejs12
entrypoint: index.handler
resources:
memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- $latest
log_group_id: ckg3qh8h363p40gmr9gn

Получить информацию о версии функции

Получить список версий функции

$ yc serverless function version list --function-name <имя функции>

+----------------------+----------------------+----------+--------------+---------+---------------------+
|          ID          |     FUNCTION ID      | RUNTIME  |  ENTRYPOINT  |  TAGS   |     CREATED AT      |
+----------------------+----------------------+----------+--------------+---------+---------------------+
| b09u830mb1n32a7rj0n8 | b097d9ous3gep99khe83 | python37 | test.handler | $latest | 2019-06-13 09:23:23 |
| b09ch6pmpohfc9sogj5f | b097d9ous3gep99khe83 | python37 | test.handler | beta    | 2019-06-13 09:12:38 |
+----------------------+----------------------+----------+--------------+---------+---------------------+

Получить подробную информацию о версии функции

Добавить переменную окружения

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

$ yc serverless function version create \
--function-name=<имя функции> \ # Имя функции.
--runtime <среда выполнения> \ # Среда выполнения.
--entrypoint <обработчик> \ # Обработчик, указывается в формате <имя файла с функцией>.<имя обработчика>.
--memory 128m \ # Объем RAM.
--execution-timeout 5s \ # Максимальное время выполнения функции до таймаута.
--source-version-id <идентификатор версии> \ # id версии, с которой копируем исполняемый код
--environment <переменные окружения> # Переменные окружения в формате key=value. Можно указать несколько пар через запятую

Управлять тегами версии

При создании новой версии, ей присваивается тег по умолчанию — $latest. Вы можете добавить или удалить тег версии.

Для обращения к версии функции используйте ее уникальный идентификатор. Как узнать уникальный идентификатор версии, читайте в пункте Получить список версий функции.

Добавить тег

$ yc serverless function version set-tag --id <идентификатор версии> --tag <тег>

id: b09ch6pmpohfc9sogj5f
function_id: b097d9ous3gep99khe83
created_at: "2019-06-13T09:12:38.464Z"
runtime: python37
entrypoint: test.handler
resources:
  memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- beta
- first
log_group_id: eolv6578frac08uh5h6s

Удалить тег

$ yc serverless function version remove-tag --id <идентификатор версии> --tag <тег>

id: b09ch6pmpohfc9sogj5f
function_id: b097d9ous3gep99khe83
created_at: "2019-06-13T09:12:38.464Z"
runtime: python37
entrypoint: test.handler
resources:
  memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- beta
log_group_id: eolv6578frac08uh5h6s