Provides a FCV3 Function resource.

The resource scheduling and running of Function Compute is based on functions. The FC function consists of function code and function configuration.

For information about FCV3 Function and how to use it, see What is Function.

-> NOTE: Available since v1.228.0.

Example Usage

Basic Usage

variable "name" {
  default = "terraform-example"
}

provider "alicloud" {
  region = "cn-shanghai"
}

resource "random_uuid" "default" {
}

resource "alicloud_oss_bucket" "default" {
  bucket = "${var.name}-${random_uuid.default.result}"
}

resource "alicloud_oss_bucket_object" "default" {
  bucket  = alicloud_oss_bucket.default.bucket
  key     = "FCV3Py39.zip"
  content = "print('hello')"
}

resource "alicloud_fcv3_function" "default" {
  description = "Create"
  memory_size = "512"
  layers = [
    "acs:fc:cn-shanghai:official:layers/Python39-Aliyun-SDK/versions/3"
  ]
  timeout   = "3"
  runtime   = "custom.debian10"
  handler   = "index.handler"
  disk_size = "512"
  custom_runtime_config {
    command = [
      "python",
      "-c",
      "example"
    ]
    args = [
      "app.py",
      "xx",
      "x"
    ]
    port = "9000"
    health_check_config {
      http_get_url          = "/ready"
      initial_delay_seconds = "1"
      period_seconds        = "10"
      success_threshold     = "1"
      timeout_seconds       = "1"
      failure_threshold     = "3"
    }

  }

  log_config {
    log_begin_rule = "None"
  }

  code {
    oss_bucket_name = alicloud_oss_bucket.default.bucket
    oss_object_name = alicloud_oss_bucket_object.default.key
    checksum        = "4270285996107335518"
  }

  instance_lifecycle_config {
    initializer {
      timeout = "1"
      handler = "index.init"
    }

    pre_stop {
      timeout = "1"
      handler = "index.stop"
    }

  }

  cpu                  = "0.5"
  instance_concurrency = "2"
  function_name        = "${var.name}-${random_uuid.default.result}"
  environment_variables = {
    "EnvKey" = "EnvVal"
  }
  internet_access = "true"
}

Argument Reference

The following arguments are supported:

• code - (Optional) Function code ZIP package. code and customContainerConfig. See code below.
• cpu - (Optional, Computed) The CPU specification of the function. The unit is vCPU, which is a multiple of the 0.05 vCPU.
• custom_container_config - (Optional) The configuration of the custom container runtime. After the configuration is successful, the function can use the custom container image to execute the function. code and customContainerConfig. See custom_container_config below.
• custom_dns - (Optional) Function custom DNS configuration See custom_dns below.
• custom_runtime_config - (Optional) Customize the runtime configuration. See custom_runtime_config below.
• description - (Optional) The description of the function. The function compute system does not use this attribute value, but we recommend that you set a concise and clear description for the function.
• disk_size - (Optional, Computed) The disk specification of the function, in MB. The optional value is 512 MB or 10240MB.
• environment_variables - (Optional, Map) The environment variable set for the function, you can get the value of the environment variable in the function.
• function_name - (Optional, ForceNew, Computed) The function name. Consists of uppercase and lowercase letters, digits (0 to 9), underscores (), and dashes (-). It must begin with an English letter (a ~ z), (A ~ Z), or an underscore (). Case sensitive. The length is 1~128 characters.
• gpu_config - (Optional) Function GPU configuration. See gpu_config below.
• handler - (Required) Function Handler: the call entry for the function compute system to run your function.
• instance_concurrency - (Optional, Computed) Maximum instance concurrency.
• instance_lifecycle_config - (Optional) Instance lifecycle callback method configuration. See instance_lifecycle_config below.
• internet_access - (Optional, Computed) Allow function to access public network
• layers - (Optional) The list of layers.
• log_config - (Optional) The logs generated by the function are written to the configured Logstore. See log_config below.
• memory_size - (Optional, Computed) The memory specification of the function. The unit is MB. The memory size is a multiple of 64MB. The minimum value is 128MB and the maximum value is 32GB. At the same time, the ratio of cpu to memorySize (calculated by GB) should be between 1:1 and 1:4.
• nas_config - (Optional) NAS configuration. After this parameter is configured, the function can access the specified NAS resource. See nas_config below.
• oss_mount_config - (Optional) OSS mount configuration See oss_mount_config below.
• role - (Optional) The user is authorized to the RAM role of function compute. After the configuration, function compute will assume this role to generate temporary access credentials. In the function, you can use the temporary access credentials of the role to access the specified Alibaba cloud service, such as OSS and OTS
• runtime - (Required) Function runtime type
• timeout - (Optional, Computed) The maximum running time of the function, in seconds.
• vpc_config - (Optional) VPC configuration. After this parameter is configured, the function can access the specified VPC resources. See vpc_config below.

code

The code supports the following:

• checksum - (Optional) The CRC-64 value of the function code package.
• oss_bucket_name - (Optional) The name of the OSS Bucket that stores the function code ZIP package.
• oss_object_name - (Optional) The name of the OSS Object that stores the function code ZIP package.
• zip_file - (Optional) The Base 64 encoding of the function code ZIP package.

custom_container_config

The custom_container_config supports the following:

• acceleration_type - (Optional, Deprecated since v1.228.0) Whether to enable Image acceleration. Default: The Default value, indicating that image acceleration is enabled. None: indicates that image acceleration is disabled. (Obsolete).
• acr_instance_id - (Optional, Deprecated since v1.228.0) ACR Enterprise version Image Repository ID, which must be entered when using ACR Enterprise version image. (Obsolete).
• command - (Optional) Container startup parameters.
• entrypoint - (Optional) Container start command.
• health_check_config - (Optional) Function custom health check configuration. See health_check_config below.
• image - (Optional) The container Image address.
• port - (Optional) The listening port of the HTTP Server when the custom container runs.

custom_container_config-health_check_config

The custom_container_config-health_check_config supports the following:

• failure_threshold - (Optional) The health check failure threshold. The system considers the health check failure when the health check fails. The value range is 1~120. The default value is 3.
• http_get_url - (Optional) The URL of the container's custom health check.
• initial_delay_seconds - (Optional) The delay between the start of the container and the initiation of the health check. Value range 0~120. The default value is 0.
• period_seconds - (Optional) Health check cycle. The value range is 1~120. The default value is 3.
• success_threshold - (Optional) The threshold for the number of successful health checks. When the threshold is reached, the system considers that the health check is successful. The value range is 1~120. The default value is 1.
• timeout_seconds - (Optional) Health check timeout. Value range 1~3. The default value is 1.

custom_dns

The custom_dns supports the following:

• dns_options - (Optional) List of configuration items in the resolv.conf file. Each item corresponds to a key-value pair in the format of key:value, where the key is required. See dns_options below.
• name_servers - (Optional) IP Address List of DNS servers.
• searches - (Optional) DNS search domain list.

custom_dns-dns_options

The custom_dns-dns_options supports the following:

• name - (Optional) Configuration Item Name.
• value - (Optional) Configuration Item Value.

custom_runtime_config

The custom_runtime_config supports the following:

• args - (Optional) Instance startup parameters.
• command - (Optional) Instance start command.
• health_check_config - (Optional) Function custom health check configuration. See health_check_config below.
• port - (Optional, Computed) The listening port of the HTTP Server.

custom_runtime_config-health_check_config

The custom_runtime_config-health_check_config supports the following:

• failure_threshold - (Optional, Computed) The health check failure threshold. The system considers the health check failure when the health check fails. The value range is 1~120. The default value is 3.
• http_get_url - (Optional) The URL of the container's custom health check. No more than 2048 characters in length.
• initial_delay_seconds - (Optional) The delay between the start of the container and the initiation of the health check. Value range 0~120. The default value is 0.
• period_seconds - (Optional) Health check cycle. The value range is 1~120. The default value is 3.
• success_threshold - (Optional) The threshold for the number of successful health checks. When the threshold is reached, the system considers that the health check is successful. The value range is 1~120. The default value is 1.
• timeout_seconds - (Optional) Health check timeout. Value range 1~3. The default value is 1.

gpu_config

The gpu_config supports the following:

• gpu_memory_size - (Optional) GPU memory specification, unit: MB, multiple of 1024MB.
• gpu_type - (Optional) GPU card architecture.
  • fc.gpu.tesla.1 indicates the type of the Tesla Architecture Series card of the GPU instance (the same as the NVIDIA T4 card type).
  • fc.gpu.ampere.1 indicates the GPU instance type of Ampere Architecture Series card (same as NVIDIA A10 card type).
  • fc.gpu.ada.1 Indicates the GPU instance Ada Lovelace architecture family card type.

instance_lifecycle_config

The instance_lifecycle_config supports the following:

• initializer - (Optional) Initializer handler method configuration. See initializer below.
• pre_stop - (Optional) PreStop handler method configuration. See pre_stop below.

instance_lifecycle_config-initializer

The instance_lifecycle_config-initializer supports the following:

• handler - (Optional) The execution entry of the callback method, which is similar to the request handler.
• timeout - (Optional) The timeout time of the callback method, in seconds.

instance_lifecycle_config-pre_stop

The instance_lifecycle_config-pre_stop supports the following:

• handler - (Optional) The execution entry of the callback method, which is similar to the request handler.
• timeout - (Optional) The timeout time of the callback method, in seconds.

log_config

The log_config supports the following:

• enable_instance_metrics - (Optional, Computed) After this feature is enabled, you can view core metrics such as instance-level CPU usage, memory usage, instance network status, and the number of requests within an instance. false: The default value, which means that instance-level metrics are turned off. true: indicates that instance-level metrics are enabled.
• enable_request_metrics - (Optional, Computed) After this function is enabled, you can view the time and memory consumed by a call to all functions under this service. false: indicates that request-level metrics are turned off. true: The default value, indicating that request-level metrics are enabled.
• log_begin_rule - (Optional, Computed) Log Line First Matching Rules.
• logstore - (Optional) The Logstore name of log service.
• project - (Optional) The name of the log service Project.

nas_config

The nas_config supports the following:

• group_id - (Optional, Computed) Group ID.
• mount_points - (Optional) Mount point list. See mount_points below.
• user_id - (Optional, Computed) Account ID.

nas_config-mount_points

The nas_config-mount_points supports the following:

• enable_tls - (Optional) Use transport encryption to mount. Note: only general-purpose NAS supports transmission encryption.
• mount_dir - (Optional) Local Mount Directory.
• server_addr - (Optional) NAS server address.

oss_mount_config

The oss_mount_config supports the following:

• mount_points - (Optional) OSS mount point list. See mount_points below.

oss_mount_config-mount_points

The oss_mount_config-mount_points supports the following:

• bucket_name - (Optional) OSS Bucket name.
• bucket_path - (Optional) Path of the mounted OSS Bucket.
• endpoint - (Optional) OSS access endpoint.
• mount_dir - (Optional) Mount Directory.
• read_only - (Optional) Read-only.

vpc_config

The vpc_config supports the following:

• security_group_id - (Optional) Security group ID.
• vswitch_ids - (Optional) Switch List.
• vpc_id - (Optional) VPC network ID.

Attributes Reference

The following attributes are exported:

• id - The ID of the resource supplied above.
• create_time - The creation time of the function.
• custom_container_config - The configuration of the custom container runtime. After the configuration is successful, the function can use the custom container image to execute the function. code and customContainerConfig.
  • acceleration_info (Deprecated since v1.228.0) - Image Acceleration Information (Obsolete).
    • status - Image Acceleration Status (Deprecated).
  • resolved_image_uri - The actual digest version of the deployed Image. The code version specified by this digest is used when the function starts.

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

• create - (Defaults to 5 mins) Used when create the Function.
• delete - (Defaults to 5 mins) Used when delete the Function.
• update - (Defaults to 5 mins) Used when update the Function.

Import

FCV3 Function can be imported using the id, e.g.

$ terraform import alicloud_fcv3_function.example <id>