Creating a function version

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

To create a function version, run the command:

yc serverless function version create \
  --function-name=my-nodejs-function \
  --runtime nodejs18 \
  --entrypoint index.handler \
  --memory 128m \
  --execution-timeout 5s \
  --source-path ./hello-js.zip

Where:

• --function-name: Name of the function whose version you want to create.
• --runtime: Runtime environment.
• --entrypoint: Entry point in the following format: <file_name_without_extension>.<listener_name>.
• --memory: Amount of RAM.
• --execution-timeout: Maximum function running time before timeout.
• --source-path: ZIP archive with the function code and required dependencies.

Result:

done (1s)
id: d4evvn8obisa********
function_id: d4elpv8pft63********
created_at: "2020-08-01T19:09:19.531Z"
runtime: nodejs18
entrypoint: index.handler
resources:
  memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
  - $latest
log_options:
  folder_id: b1g681qpemb4********

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the relevant documentation on the Terraform website or its mirror.

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

To create a new function version:

1. Open the Terraform configuration file and change the function parameters:

   • yandex_function: Description of the function being created and its source code.
     • name: Function name.
     • description: Text description of the function.
     • user_hash: Any string to identify the function version. When the function changes, update this string, too. The function will update when this string is updated.
     • runtime: Function runtime environment.
     • entrypoint: Function name in the source code that will serve as an entry point to applications.
     • memory: Amount of memory allocated for the function, in MB.
     • execution_timeout: Function running timeout.
     • service_account_id: ID of the service account you want to use to invoke the function.
     • content: Function source code.
       • content.0.zip_filename: Name of the ZIP archive containing the function source code.

   Here is an example of the configuration file structure:

   resource "yandex_function" "test-function" {
       name               = "test-function"
       description        = "Test function"
       user_hash          = "first-function"
       runtime            = "nodejs18"
       entrypoint         = "main"
       memory             = "128"
       execution_timeout  = "10"
       service_account_id = "<service_account_ID>"
       content {
           zip_filename = "<path_to_ZIP_archive>"
       }
   }
   

   Note

   If the function name or description is changed, the version will not be created.

   For more information about yandex_function properties, see the relevant provider documentation.

2. Check the configuration using this command:

   terraform validate
   

   If the configuration is correct, you will get this message:

   Success! The configuration is valid.
   

3. Run this command:

   terraform plan
   

   You will see a detailed list of resources. No changes will be made at this step. If the configuration contains any errors, Terraform will show them.

4. Apply the changes:

   terraform apply
   

5. Type yes and press Enter to confirm the changes.

You can check the new version using the management console or this CLI command:

yc serverless function version list --function-name <function_name>

To create a function version, use the createVersion REST API method for the Function resource or the FunctionService/CreateVersion gRPC API call.

Request example

To use the examples, install cURL and authenticate in the API.

{
  "functionId": "<function_ID>",
  "runtime": "nodejs22",
  "entrypoint": "index.handler",
  "resources": {
    "memory": "134217728"
  },
  "executionTimeout": "5s",
  "versionId": "<previous_function_version_ID>"
}

Send the request by specifying the path to the previously prepared file with the request body:

export IAM_TOKEN=$(yc iam create-token)
curl -X POST \
  -H "Authorization: Bearer ${IAM_TOKEN}" \
  -d "@<body.json_file_path>" \
  https://serverless-functions.api.cloud.yandex.net/functions/v1/versions

Result:

{
  "done": false,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.serverless.functions.v1.CreateFunctionVersionMetadata",
    "functionVersionId": "d4e25m0gila4********"
  },
  "id": "d4edk0oobcc9********",
  "description": "Create function version",
  "createdAt": "2023-10-11T11:22:21.286786431Z",
  "createdBy": "ajeol2afu1js********",
  "modifiedAt": "2023-10-11T11:22:21.286786431Z"
}

You can create a function version using the Yandex Cloud Toolkit plugin for the IDE family on the JetBrains IntelliJ platform.