update-custom-runtime-function
Update and deploy custom runtime functions on Alibaba Cloud Function Compute. Modify code after building or adjust configuration parameters like CPU, memory, environment variables, and network settings.
Instructions
更新并部署custom runtime函数。如果需要修改代码，必须先完成构建。如果需要更新函数配置，需要提供更新的参数，未提供的参数将保持不变
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| location | No | 本地代码工程的根路径，需要部署更新代码时，需要提供本地代码工程的根路径，否则可不提供 | |
| functionName | Yes | 要更新的目标函数名称 | |
| region | No | 部署的区域，当前可选的区域是cn-hangzhou, cn-shanghai, cn-beijing, cn-shenzhen, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1, me-east-1, cn-chengdu, cn-wulanchabu, cn-guangzhou，默认是cn-hangzhou | cn-hangzhou |
| cpu | No | 函数的 CPU 规格，单位为 vCPU，为 0.05 vCPU 的倍数。 和 diskSize 必须同时存在， 如果仅仅填写 memorySize, cpu 和 diskSize 可以不填。内存规格（以GB计算）与CPU规格的比例必须在1到4之间，例如内存为1024MB，则CPU必须为0.25到1之间，默认为1 | |
| memorySize | No | 函数的内存规格，单位为 MB，最小值为128，最大值为 30720。可以选择的内存规格为：128，256，512，1024，2048，4096，8192，16384，32768。默认为2048。内存规格（以GB计算）与CPU规格的比例必须在1到4之间，例如内存为1024MB，则CPU必须为0.25到1之间 | |
| customRuntimeConfig | No | 自定义运行时配置，定义启动命令、参数以及启动的HTTP Server的监听端口 | |
| description | No | 函数的描述，可以描述一下函数的功能。 | |
| diskSize | No | 磁盘大小，单位是MB，可选值: 512 | 10240 | |
| instanceConcurrency | No | 单实例多并发数。规定了单个实例可以同时同时被多个请求命中的上限，只对自定义运行时与自定义容器镜像运行时生效。范围为[1, 200] | |
| environmentVariables | No | 运行时的环境变量配置 | |
| internetAccess | No | 是否支持从函数实例内访问互联网 | |
| logConfig | No | 日志投递配置。如果配置为auto，则会自动创建SLS日志库并投递日志。如果配置为其他值，则需要配置project和logstore。 | |
| vpcConfig | No | 函数的VPC网络配置。如果配置为auto，则会自动创建VPC、VSwitch与安全组配置。如果配置为其他值，则需要配置vpcId、vSwitchIds与securityGroupId。函数实例会运行在配置的VPC网络中。 | |
| role | No | 函数运行时的角色配置。授予函数计算所需权限的 RAM 角色，使用场景包含：1. 把函数产生的日志发送到您的日志库中。2. 为函数在执行过程中访问其他云资源生成的临时访问令牌。一般可以设置为aliyunfcdefaultrole。角色ARN为acs:ram::****:role/aliyunfcdefaultrole,只需要输入aliyunfcdefaultrole即可 | |
| runtime | No | 函数的运行时环境，对于自定义运行时，当前支持debian10，debian11，debian12 | |
| timeout | No | 函数执行的超时时间，单位为秒，最小 1 秒，默认 3 秒。函数执行超过这个时间后会被终止执行。 | |
| layers | No | 函数计算的层配置，当前会自动为custom.debian10，custom.debian11，custom.debian12添加默认的公共层 | |
| tags | No | 函数标签的key与value配置 |
Implementation Reference
- src/index.ts:332-371 (handler)Core handler function that updates an existing custom runtime function. It syncs the current YAML config, updates it with new parameters if provided, and deploys the changes using Serverless Devs fc3 component.async function updateCustomRuntimeFunction(params: any): Promise<CallToolResult> { const { functionName, region } = params; const accessKeyId = process.env.ALIBABA_CLOUD_ACCESS_KEY_ID; const accessKeySecret = process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET; const stsToken = process.env.ALIBABA_CLOUD_SECURITY_TOKEN || ''; if (!accessKeyId || !accessKeySecret) { return { isError: true, content: [{ type: "text", text: `执行失败，请设置ALIBABA_CLOUD_ACCESS_KEY_ID, ALIBABA_CLOUD_ACCESS_KEY_SECRET, ALIBABA_CLOUD_SECURITY_TOKEN环境变量` }] }; } const fcClient = createFcClient(region); const accountId = await getAccountId(); if (!accountId) { return { isError: true, content: [{ type: "text", text: `执行失败，获取accountId异常` }] }; } try { await fcClient.getFunction(functionName, new GetFunctionRequest({})); } catch (error: any) { if (error.statusCode !== 404) { return { isError: true, content: [{ type: "text", text: `获取函数信息失败：${JSON.stringify(error as any)}` }] }; } return { isError: true, content: [{ type: "text", text: `函数不存在` }] }; } const sconfig: any = { AccountID: accountId, AccessKeyID: accessKeyId, AccessKeySecret: accessKeySecret, SecurityToken: stsToken, }; // 同步yaml文件 const tmpYamlDir = prepareTmpDir(); const syncResult = await syncYaml(tmpYamlDir, functionName, region, sconfig); // update Yaml const fc3Props = updateYamlByInputs(syncResult.yamlPath, syncResult.codePath, params); // Deploy try { const result = await deployFunction(functionName, syncResult.yamlPath, sconfig, fc3Props); return { content: [{ type: "text", text: `部署完成。output: ${result}` }] }; } catch (error) { return { isError: true, content: [{ type: "text", text: `部署失败：${JSON.stringify(error as any)}` }] }; } }
- src/index.ts:454-497 (registration)Tool registration for remote mode (when REMOTE_MODE=true), includes schema validation using Zod schemas and wrapper handler that downloads codeUri if provided before calling the core update function."update-custom-runtime-function", "更新custom runtime函数。只需要提供需要更新的参数，未提供的参数将保持不变", { codeUri: codeUriSchema.optional(), functionName: functionNameSchema.describe("要更新的目标函数名称"), region: regionSchema, cpu: cpuSchema.optional(), memorySize: memorySizeSchema.optional(), customRuntimeConfig: customRuntimeConfigSchema.optional(), description: functionDescriptionSchema.optional(), diskSize: diskSizeSchema.optional(), instanceConcurrency: instanceConcurrencySchema.optional(), environmentVariables: environmentVariablesSchema.optional(), internetAccess: internetAccessSchema.optional(), logConfig: logConfigSchema.optional(), vpcConfig: vpcConfigSchema.optional(), role: functionRoleSchema.optional(), runtime: customRuntimeSchema.optional(), timeout: functionTimeoutSchema.optional(), layers: customRuntimeLayersSchema.optional(), tags: functionTagSchema.optional(), }, async (args) => { const { codeUri } = args; let location; if (codeUri) { location = path.join(os.tmpdir(), `code-${Date.now()}.zip`); // download codeUri to location try { await downloadFile(codeUri, location); } catch (error) { return { isError: true, content: [{ type: "text", text: `执行失败，下载代码工程失败: ${JSON.stringify(error as any)}` }] }; } if (!fs.existsSync(location)) { return { isError: true, content: [{ type: "text", text: `执行失败，下载代码工程失败` }] }; } } const nextArgs = { ...args, location, } return await updateCustomRuntimeFunction(nextArgs); } )
- src/index.ts:499-529 (registration)Tool registration for local mode (default), includes schema validation and direct call to core update function if location exists.server.tool( "update-custom-runtime-function", "更新并部署custom runtime函数。如果需要修改代码，必须先完成构建。如果需要更新函数配置，需要提供更新的参数，未提供的参数将保持不变", { location: locationSchema.describe("本地代码工程的根路径，需要部署更新代码时，需要提供本地代码工程的根路径，否则可不提供").optional(), functionName: functionNameSchema.describe("要更新的目标函数名称"), region: regionSchema, cpu: cpuSchema.optional(), memorySize: memorySizeSchema.optional(), customRuntimeConfig: customRuntimeConfigSchema.optional(), description: functionDescriptionSchema.optional(), diskSize: diskSizeSchema.optional(), instanceConcurrency: instanceConcurrencySchema.optional(), environmentVariables: environmentVariablesSchema.optional(), internetAccess: internetAccessSchema.optional(), logConfig: logConfigSchema.optional(), vpcConfig: vpcConfigSchema.optional(), role: functionRoleSchema.optional(), runtime: customRuntimeSchema.optional(), timeout: functionTimeoutSchema.optional(), layers: customRuntimeLayersSchema.optional(), tags: functionTagSchema.optional(), }, async (args) => { const { location } = args; if (location && !fs.existsSync(location)) { return { isError: true, content: [{ type: "text", text: `执行失败，指定的本地代码工程路径不存在` }] }; } return await updateCustomRuntimeFunction(args); } )
- src/schema.ts:1-182 (schema)Zod schema definitions for all tool parameters, imported and used in the tool registrations for input validation (e.g., functionNameSchema, regionSchema, cpuSchema, customRuntimeConfigSchema).import { z } from "zod"; // region schema export const regionSchema = z.enum(['cn-hangzhou', 'cn-shanghai', 'cn-beijing', 'cn-shenzhen', 'cn-hongkong', 'ap-southeast-1', 'ap-southeast-2', 'ap-southeast-3', 'ap-southeast-5', 'ap-northeast-1', 'eu-central-1', 'eu-west-1', 'us-west-1', 'us-east-1', 'ap-south-1', 'me-east-1', 'cn-chengdu', 'cn-wulanchabu', 'cn-guangzhou']) .default('cn-hangzhou') .describe("部署的区域，当前可选的区域是cn-hangzhou, cn-shanghai, cn-beijing, cn-shenzhen, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1, me-east-1, cn-chengdu, cn-wulanchabu, cn-guangzhou，默认是cn-hangzhou"); // equal rule schema export const equalRuleSchema = z.object({ match: z.string().describe("匹配规则"), replacement: z.string().describe("替换规则"), }).describe("自定义域名完全匹配重写规则配置"); // wildcard rule schema export const wildcardRuleSchema = z.object({ match: z.string().describe("匹配规则"), replacement: z.string().describe("替换规则"), }).describe("自定义域名通配符重写规则配置"); // regex rule schema export const regexRuleSchema = z.object({ match: z.string().describe("匹配规则"), replacement: z.string().describe("替换规则"), }).describe("自定义域名正则重写规则配置"); // rewrite config schema export const rewriteConfigSchema = z.object({ equalRules: z.array(equalRuleSchema).describe("精确匹配规则列表"), wildcardRules: z.array(wildcardRuleSchema).describe("通配匹配规则列表"), regexRules: z.array(regexRuleSchema).describe("正则匹配规则列表"), }).describe("重写配置，可以采用精确匹配、通配匹配或正则匹配其中之一"); // path config schema export const pathConfigSchema = z.object({ path: z.string().describe("HTTP协议中的PATH路径，例如/api/，或/api/*"), functionName: z.string().describe("路由的目标函数名称"), qualifier: z.string().describe("路由的目标函数版本或别名，默认是LATEST").optional(), methods: z.array(z.enum(['GET', 'POST', 'PUT', 'DELETE', 'HEAD', 'OPTIONS'])).describe("HTTP方法，可选值为GET, POST, PUT, DELETE, HEAD, OPTIONS").default(['GET', 'POST','PUT', 'DELETE', 'HEAD', 'OPTIONS']), rewriteConfig: rewriteConfigSchema.optional(), }).describe("自定义域名路由路径配置。"); // route config schema export const routeConfigSchema = z.object({ routes: z.array(pathConfigSchema).describe("路由配置"), }); // auth config schema export const authConfigSchema = z.object({ authType: z.enum(['anonymous', 'function']).describe("认证类型，可选值为anonymous, function。anonymous：匿名认证，无需认证。function：函数签名校验认证。默认为匿名校验").optional(), }).describe("权限认证配置"); // cert config schema export const certConfigSchema = z.object({ certName: z.string().describe("证书名称"), privateKey: z.string().describe("PEM格式证书私钥"), certificate: z.string().describe("PEM格式证书内容，必须包含全部的证书内容，包括中间证书"), }).describe("证书配置，如果要支持HTTPS协议，则必须要配置证书"); // tls config schema export const tlsConfigSchema = z.object({ minVersion: z.string().describe("TLS版本，可选值为TLSv1.0, TLSv1.1, TLSv1.2, TLSv1.3。默认为TLSv1.2"), maxVersion: z.string().describe("TLS版本，可选值为TLSv1.0, TLSv1.1, TLSv1.2, TLSv1.3。默认为TLSv1.2"), cipherSuites: z.array(z.string()).describe("TLS密码套件，可选值为TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256, TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256。默认为TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256"), }).describe("TLS配置，如果要支持HTTPS协议，则必须要配置TLS"); // waf config schema export const wafConfigSchema = z.object({ enable: z.boolean().describe("是否开启WAF"), }).describe("Web应用防火墙（WAF）配置"); // log config schema export const logConfigSchema = z.union([z.object({ project: z.string().describe("日志投递的SLS日志项目名称"), logstore: z.string().describe("日志投递的SLS日志库名称"), logBeginRule: z.enum(["DefaultRegex", "None"]).default("DefaultRegex").describe("日志投递到SLS日志库时的切分规则，可选值为DefaultRegex，表示使用默认的切分规则。启用后，函数计算将按日志分割规则进行切分，切分成多个日志段，并逐条写入日志服务。默认的日志分割规则为 ^.{0,2}\d{4}-\d{2}-\d{2}，即匹配符合xxxx-xx-xx格式的日期，其中x代表数字。该规则将按照行首是否带有日期进行切分，例如您的日志行首是2023-10-10，则该日志将被认为是一块日志的首行，首行和接下来连续不带日期的日志将被作为一条日志写入到日志服务。不启用日志分割规则是，默认使用换行符\\n进行切分。"), enableInstanceMetrics: z.boolean().default(true).describe("是否开启实例级指标投递，开启后，函数计算会自动将实例级指标投递到SLS日志库。"), enableRequestMetrics: z.boolean().default(true).describe("是否开启请求级指标投递，开启后，函数计算会自动将请求级指标投递到SLS日志库。"), }), z.enum(["auto"])]).describe("日志投递配置。如果配置为auto，则会自动创建SLS日志库并投递日志。如果配置为其他值，则需要配置project和logstore。") // vpc config schema export const vpcConfigSchema = z.union([z.object({ vpcId: z.string().describe("VPC的ID"), vSwitchIds: z.string().describe("VSwitch的ID"), securityGroupId: z.string().describe("安全组ID"), }), z.enum(["auto"])]).describe("函数的VPC网络配置。如果配置为auto，则会自动创建VPC、VSwitch与安全组配置。如果配置为其他值，则需要配置vpcId、vSwitchIds与securityGroupId。函数实例会运行在配置的VPC网络中。") export const protocolSchema = z.enum(['HTTP', 'HTTPS', 'HTTP,HTTPS']).describe("域名路由配置的协议，可选值为HTTP, HTTPS, HTTP,HTTPS。HTTP：仅支持 HTTP 协议。HTTPS：仅支持 HTTPS 协议。HTTP,HTTPS：支持 HTTP 及 HTTPS 协议。"); // update custom domain config schema export const updateCustomDomainConfigSchema = z.object({ protocol: protocolSchema.optional(), routeConfig: routeConfigSchema, authConfig: authConfigSchema, certConfig: certConfigSchema.optional(), tlsConfig: tlsConfigSchema.optional(), wafConfig: wafConfigSchema.optional(), }); export const domainSchema = z.string().describe("域名，例如example.com，域名不能带有'https://'或'http://'等协议内容"); // create custom domain config schema export const createCustomDomainConfigSchema = z.object({ domain: domainSchema, protocol: protocolSchema.optional(), routeConfig: routeConfigSchema, authConfig: authConfigSchema, certConfig: certConfigSchema.optional(), tlsConfig: tlsConfigSchema.optional(), wafConfig: wafConfigSchema.optional(), }); // cpu schema export const cpuSchema = z.number().describe("函数的 CPU 规格，单位为 vCPU，为 0.05 vCPU 的倍数。 和 diskSize 必须同时存在， 如果仅仅填写 memorySize, cpu 和 diskSize 可以不填。内存规格（以GB计算）与CPU规格的比例必须在1到4之间，例如内存为1024MB，则CPU必须为0.25到1之间，默认为1"); // memory size schema export const memorySizeSchema = z.number().describe("函数的内存规格，单位为 MB，最小值为128，最大值为 30720。可以选择的内存规格为：128，256，512，1024，2048，4096，8192，16384，32768。默认为2048。内存规格（以GB计算）与CPU规格的比例必须在1到4之间，例如内存为1024MB，则CPU必须为0.25到1之间"); // function name schema export const functionNameSchema = z.string().describe("函数名称，函数名称在每个region必须是唯一的。") .regex(/^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,63}$/); // location schema export const locationSchema = z.string().describe("本地代码工程的根路径，例如/Users/xxx/my-project，不需要打包为zip"); export const codeUriSchema = z.string().describe("zip格式代码包下载链接，代码工程必须是已经完成构建后打包的代码工程，且地址必须是免鉴权的地址，例如: https://mybucket.oss-cn-hangzhou.aliyuncs.com/objectName?Expires=1749109495&OSSAccessKeyId=osstmpak&Signature=osstmpsign%3D"); // custom runtime config schema export const customRuntimeConfigSchema = z.object({ command: z.array(z.string()).min(1).describe("自定义运行时启动命令，命令执行的用户是root，执行的目录是/code,例如python3"), args: z.array(z.string()).min(1).describe("自定义运行时启动命令参数，例如app.py").optional(), port: z.number().describe("自定义运行时中启动的HTTP Server的监听端口，默认为9000").default(9000), }).describe("自定义运行时配置，定义启动命令、参数以及启动的HTTP Server的监听端口"); // function description schema export const functionDescriptionSchema = z.string().describe("函数的描述，可以描述一下函数的功能。"); export const functionVersionDescriptionSchema = z.string().describe("函数版本的描述，可以描述一下发布的函数版本的功能。"); // disk size schema export const diskSizeSchema = z.number().describe("磁盘大小，单位是MB，可选值: 512 | 10240"); // instance concurrency schema export const instanceConcurrencySchema = z.number().describe("单实例多并发数。规定了单个实例可以同时同时被多个请求命中的上限，只对自定义运行时与自定义容器镜像运行时生效。范围为[1, 200]"); // environment variables schema export const environmentVariablesSchema = z.record( z.string().describe("环境变量名称"), z.string().describe("环境变量值") ).describe("运行时的环境变量配置"); // internet access schema export const internetAccessSchema = z.boolean().describe("是否支持从函数实例内访问互联网"); // function role schema export const functionRoleSchema = z.string().describe("函数运行时的角色配置。授予函数计算所需权限的 RAM 角色，使用场景包含：1. 把函数产生的日志发送到您的日志库中。2. 为函数在执行过程中访问其他云资源生成的临时访问令牌。一般可以设置为aliyunfcdefaultrole。角色ARN为acs:ram::****:role/aliyunfcdefaultrole,只需要输入aliyunfcdefaultrole即可"); // custom runtime schema export const customRuntimeSchema = z.enum(['custom.debian10', 'custom.debian11', 'custom.debian12']).describe("函数的运行时环境，对于自定义运行时，当前支持debian10，debian11，debian12"); // function timeout schema export const functionTimeoutSchema = z.number().describe("函数执行的超时时间，单位为秒，最小 1 秒，默认 3 秒。函数执行超过这个时间后会被终止执行。"); // custom runtime layers schema export const customRuntimeLayersSchema = z.array(z.string()).describe("函数计算的层配置，当前会自动为custom.debian10，custom.debian11，custom.debian12添加默认的公共层"); // function tag schema export const functionTagSchema = z.array(z.object({ key: z.string().describe("标签名称"), value: z.string().describe("标签值") })).describe("函数标签的key与value配置"); export const listFunctionsPrefixSchema = z.string().describe("函数名称前缀，用于过滤函数列表"); export const listFunctionsNextTokenSchema = z.string().describe("函数列表的下一页token，用于分页查询函数列表。第一页不需要提供"); export const listFunctionVersionsNextTokenSchema = z.string().describe("函数版本列表的下一页token，用于分页查询函数版本列表。第一页不需要提供"); export const listFunctionVersionsLimitSchema = z.number().describe("函数版本列表的返回数量上限，默认50，最大100").min(1).max(100).default(50); export const listFunctionVersionsDirectionSchema = z.enum(["BACKWARD", "FORWARD"]).describe("函数版本列表的排序方向，BACKWARD表示按版本号降序，FORWARD表示按版本号升序").default("BACKWARD"); export const versionIdSchema = z.string().describe("函数版本ID");
- src/index.ts:181-240 (helper)Helper function to update the synced YAML file with new parameter values, preserving unchanged ones.function updateYamlByInputs(yamlPath: string, originCodePath: string, args: any) { const yamlContent = fs.readFileSync(yamlPath, 'utf-8'); const yamlObject: any = yaml.load(yamlContent); const { location, functionName, region, cpu, memorySize, customRuntimeConfig, description, diskSize, instanceConcurrency, environmentVariables, layers, internetAccess, logConfig, vpcConfig, role, runtime, timeout, tags } = args; if (location) { yamlObject.resources[functionName].props.code = location; } else { yamlObject.resources[functionName].props.code = originCodePath; } if (cpu) { yamlObject.resources[functionName].props.cpu = cpu; } if (memorySize) { yamlObject.resources[functionName].props.memorySize = memorySize; } if (customRuntimeConfig) { yamlObject.resources[functionName].props.customRuntimeConfig = customRuntimeConfig; } if (description) { yamlObject.resources[functionName].props.description = description; } if (diskSize) { yamlObject.resources[functionName].props.diskSize = diskSize; } if (instanceConcurrency) { yamlObject.resources[functionName].props.instanceConcurrency = instanceConcurrency; } if (environmentVariables) { const finalEnv = prepareEnvVars(environmentVariables); yamlObject.resources[functionName].props.environmentVariables = finalEnv; } if (layers) { const finalLayers = prepareLayers(layers, region); yamlObject.resources[functionName].props.layers = finalLayers; } if (internetAccess) { yamlObject.resources[functionName].props.internetAccess = internetAccess; } if (logConfig) { yamlObject.resources[functionName].props.logConfig = logConfig; } if (vpcConfig) { yamlObject.resources[functionName].props.vpcConfig = vpcConfig; } if (role) { yamlObject.resources[functionName].props.role = role; } if (runtime) { yamlObject.resources[functionName].props.runtime = runtime; } if (timeout) { yamlObject.resources[functionName].props.timeout = timeout; } if (tags) { yamlObject.resources[functionName].props.tags = tags; } fs.writeFileSync(yamlPath, yaml.dump(yamlObject)); return yamlObject.resources[functionName].props; }