Creating a function

If you do not have the Yandex Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

To create a function, run the command:

yc serverless function create --name=<function_name>

Result:

id: b09bhaokchn9********
folder_id: aoek49ghmknn********
created_at: "2019-06-14T10:03:37.475Z"
name: python_function
log_group_id: eolm8aoq9vcp********
http_invoke_url: https://functions.yandexcloud.net/b09bhaokchn9********
status: ACTIVE

Terraform allows you to quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. Configuration files store the infrastructure description in the HashiCorp Configuration Language (HCL). Terraform and its providers are distributed under the Business Source License.

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

If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

If you don't have Terraform, install it and configure the Yandex Cloud provider.

To create a function:

1. In the configuration file, describe the parameters of the resources you want to create:

   • yandex_function: Description of the new function and its source code:
     • name: Function name.
     • folder_id: Folder ID.
     • description: Text description of the function.
     • labels: Function labels in key:value format.
     • 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 execution timeout.
     • service_account_id: ID of the service account to call the function under.
     • environment: Environment variables in key:value format.
     • tags: Function tags.
     • version: Function version.
     • image_size: Size of the image for the function.
     • loggroup_id: ID of the log group for the function.
     • package: Package with the function version source code. You can only use either the package or the content field.
     • package.0.sha_256: SHA256 hash of the package.
     • package.0.bucket_name: Name of the Object Storage bucket that stores the function version source code.
     • package.0.object_name: Name of the Object Storage object containing the function version source code.
     • content: Function source code. You can only use either the content or the package field.
     • content.0.zip_filename: Name of the ZIP archive containing the function source code.

   Here is an example of the configuration file structure:

   provider "yandex" {
       token     = "<service_account_OAuth_token_or_static_key>"
       folder_id = "<folder_ID>"
       zone      = "ru-central1-a"
   }
        
   resource "yandex_function" "test-function" {
       name               = "test-function"
       description        = "Test function"
       user_hash          = "first-function"
       runtime            = "python37"
       entrypoint         = "main"
       memory             = "128"
       execution_timeout  = "10"
       service_account_id = "<service_account_ID>"
       tags               = ["my_tag"]
       content {
           zip_filename = "<path_to_ZIP_archive>"
       }
   }
   
   output "yandex_function_test-function" {
       value = "${yandex_function.test-function.id}"
   }
   

   For more information about the yandex_function resource properties, see the 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
   

   The terminal will display a list of resources with parameters. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

4. Apply the configuration changes:

   terraform apply
   

5. Confirm the changes: type yes into the terminal and press Enter.

   You can check the new resources and their settings using the management console or this CLI command:

   yc serverless function list
   

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

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