本文提供有关 Azure Functions Core Tools 的参考文档。 使用此本地运行时和命令行工具,可以从本地计算机开发、管理和部署Azure Functions项目。 若要了解有关使用 Core Tools 的详细信息,请参阅 Work with Azure Functions Core Tools。
Core Tools 命令归纳为以下上下文,每个上下文提供一组独特的操作。
| 命令上下文 | 说明 |
|---|---|
func |
用于在本地计算机上创建和运行函数的命令。 |
func azure |
用于处理Azure资源的命令,包括发布。 |
func azurecontainerapps |
将容器化函数应用部署到Azure Container Apps。 |
func durable |
用于处理 Durable Functions 的命令。 |
func extensions |
用于安装和管理扩展的命令。 |
func kubernetes |
用于处理 Kubernetes 和Azure Functions的命令。 |
func settings |
用于管理本地 Functions 主机的环境设置的命令。 |
func templates |
用于列出可用函数模板的命令。 |
使用本文中的命令之前,必须安装 Core Tools。
func init
使用特定语言创建新的 Functions project。
func init <PROJECT_FOLDER>
当提供 <PROJECT_FOLDER> 时,project将在具有此名称的新文件夹中创建。 否则,将使用当前文件夹。
func init 支持以下选项,除非另有说明,否则它们不支持版本 1.x:
| 选项 | 说明 |
|---|---|
--csx |
将.NET函数创建为 C# 脚本,即版本 1.x 行为。 仅对 --worker-runtime dotnet 有效。 |
--docker |
使用基于所选 --worker-runtime 的基础映像创建容器的 Dockerfile。 计划部署容器化函数应用时,请使用此选项。 |
--docker-only |
将 Dockerfile 添加到现有project。 如果未在 local.settings.json 中指定或设置 worker-runtime,则会进行相应提示。 如果计划部署容器化函数应用并已存在project,请使用此选项。 |
--force |
即使project中存在现有文件,也会初始化project。 此设置会覆盖同名的现有文件。 project 文件夹中的其他文件不会受到影响。 |
--language |
初始化特定于语言的project。 当前在 --worker-runtime 设为 node 时受支持。 选项包括 typescript 和 javascript。 你也可使用 --worker-runtime javascript 或 --worker-runtime typescript。 |
--managed-dependencies |
安装托管的依赖项。 目前只有 PowerShell 辅助运行时支持此功能。 |
--model |
当有多个模型可用时,为目标语言设置所需的编程模型。 支持的选项为 V1 和 V2(适用于 Python)以及 V3 和 V4(适用于 Node.js)。 有关详细信息,请参阅 Python 开发人员指南和 Node.js 开发人员指南。 |
--source-control |
控制是否创建 git 存储库。 默认不会创建存储库。 如果为 true,则会创建存储库。 |
--worker-runtime |
设置project的语言运行时。 支持的值包括:csharp、、dotnet、dotnet-isolated、javascript(nodeJavaScript 的默认值)、powershell和pythontypescript。 对于 Java,请使用 Maven。 若要仅使用project文件生成与语言无关的project,请使用 custom。 如果未设置,则初始化期间系统会提示你选择运行时。 |
--target-framework |
设置函数应用project的目标框架。 仅对 --worker-runtime dotnet-isolated 有效。 支持的值包括:net10.0(预览)、net9.0、net8.0(默认值)、net6.0 和 net48(.NET Framework 4.8)。 |
注意
当你使用 --docker 或 --docker-only 选项时,Core Tools 会自动为 C#、JavaScript、Python 和 PowerShell 函数创建 Dockerfile。 对于 Java 函数,你必须手动创建 Dockerfile。 有关详细信息,请参阅创建容器化函数应用。
func logs
获取在 Kubernetes 群集中运行的函数的日志。
func logs --platform kubernetes --name <APP_NAME>
func logs 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--platform |
函数应用的托管平台。 支持的选项:kubernetes。 |
--name |
Azure中的函数应用名称。 |
有关详细信息,请参阅使用 KEDA 的 Kubernetes 上的 Azure Functions。
func new
基于模板在当前project中创建一个新函数。
func new
在没有 func new 选项的情况下运行 --template 时,系统会提示你选择模板。 在版本 1.x 中,必须使用该 --language 选项来设置语言。
func new 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--authlevel |
设置 HTTP 触发器的授权级别。 支持的值为:function、anonymous、admin。 在本地运行时,不会强制实施授权。 有关详细信息,请参阅授权级别。 |
--csx |
生成版本 1.x 和门户编辑器中使用的相同 C# 脚本 (.csx) 模板。 |
--language,-l |
仅在版本 1.x 中重新引导。 在所有其他版本中,语言由 --worker-runtime 传递给 func init的值定义。 |
--name,-n |
函数名称。 |
--template,-t |
使用 func templates list 命令查看每种受支持语言的可用模板的完整列表。 |
若要了解详细信息,请参阅创建函数。
func pack
创建一个部署包,其中包含处于可运行状态的project代码。 如果需要在 func azure functionapp publish 命令外部的本地计算机上手动为应用创建部署包,请使用此方法。 默认情况下,func pack根据需要生成project。
func pack
在包含host.json project文件的目录中运行 func pack,该文件是应用的根目录。 生成的输出(.zip)文件与要打包的文件夹同名。 如果已存在具有该名称的 .zip 文件,则首先将其删除,然后替换为更新的版本。
默认情况下,func pack在运行函数的目录中生成和打包 Functions project。 可以通过在命令后设置project根路径(如 func pack ./myprojectroot)来运行 func pack 来打包其他目录。 当运行不包含func pack文件的目录host.json时,将返回错误。
默认情况下, func pack 生成所有项目并安装所有语言的依赖项。
--no-build使用和--skip-install选项修改此行为。
重要
在 Windows 计算机上生成的 Python 应用包通常会在 Azure Functions 中部署到 Linux 并在 Linux 上运行时遇到问题。
--no-build请考虑与远程生成一起使用,或在 --build-native-deps Windows 上运行 Python 应用时func pack使用。
该 func pack 作支持以下选项:
| 选项 | 说明 |
|---|---|
--output |
设置在其中创建部署 .zip 包文件的位置的路径。 |
--no-build |
包装前不会生成Project。 对于 C# 应用,仅在已生成二进制文件时使用。 对于 Node.js 应用,同时 npm install 跳过并 npm run build 跳过。 在包内容上请求远程生成时,可以使用此选项。 |
--skip-install |
打包基于 Node.js的函数应用时跳过运行 npm install 。 使用此选项可避免覆盖自定义 npm 模块。 |
--build-native-deps |
使用与Azure中使用的环境匹配的映像在本地安装 Python 依赖项,这需要 Docker 工具。 启用后,Core Tools 将启动 Docker 容器,在该容器内部生成应用,并创建一个 .zip 文件,其中还原 .python_packages了所有依赖项。 在 Windows 上运行时使用此选项,以避免在 Azure 中部署到 Linux 时出现潜在的库问题。 |
func run
仅限 1.x 版。
使用此命令直接调用函数。 此命令的工作方式类似于在Azure portal中使用 Test 选项卡运行函数。 此命令仅适用于版本 1.x。 对于更高版本,请使用 func start 并直接调用函数终结点。
func run
该 func run 命令支持以下选项:
| 选项 | 说明 |
|---|---|
--content |
传递给函数的内联内容。 |
--debug |
运行函数前,将调试程序附加到主机进程。 |
--file |
要用作内容的文件名。 |
--no-interactive |
不提示输入,这适用于自动化方案。 |
--timeout |
本地 Functions 主机准备就绪前的等待时间(以秒为单位)。 |
例如,若要调用 HTTP 触发的函数并传递内容正文,请运行以下命令:
func run MyHttpTrigger --content '{\"name\": \"Azure\"}'
func start
启动本地运行时主机,并在当前文件夹中加载函数project。
具体命令取决于运行时版本。
func start
func start 支持以下选项:
| 选项 | 说明 |
|---|---|
--cert |
包含私钥的 .pfx 文件的路径。 仅支持与 --useHttps 一起使用。 |
--cors |
以逗号分隔的 CORS 来源列表,其中不包含空格。 |
--cors-credentials |
允许使用 Cookie 和身份验证标头的经身份验证的跨域请求。 |
--dotnet-isolated-debug |
设置为 true 时,将暂停.NET工作进程,直到调试程序从正在调试的.NET隔离project附加。 |
--enable-json-output |
尽可能将控制台日志以 JSON 格式发出。 |
--enableAuth |
启用具有授权要求的完整身份验证处理管道。 |
--functions |
要加载的以空格分隔的函数列表。 |
--language-worker |
用于配置语言辅助角色的参数。 例如,可以通过提供 debug 端口和其他必需参数来为语言辅助角色启用调试。 |
--no-build |
在运行之前不要生成当前project。 仅适用于.NET类项目。 默认为 false。 |
--password |
密码或包含 .pfx 文件密码的文件。 只能与 --cert 配合使用。 |
--port |
要侦听的本地端口。 默认值:7071。 |
--timeout |
Functions 主机启动的超时时间(以秒为单位)。 默认值:20 秒。 |
--useHttps |
绑定到 https://localhost:{port} ,而不是绑定到 http://localhost:{port} 。 默认情况下,此选项会在计算机上创建可信证书。 |
运行project后,可以验证单个函数终结点。
func azure functionapp 全局选项
所有 func azure functionapp 命令都支持以下选项:
| 选项 | 说明 |
|---|---|
--slot |
如果已配置,则以特定的命名 部署槽位为目标。 |
--access-token |
提供一个access令牌,而不是默认令牌,用于在Azure中执行经过身份验证的作。 |
--access-token-stdin |
从标准输入读取特定access令牌。 直接从上一个命令(如 az account get-access-token)读取令牌时,请使用此选项。 |
--management-url |
设置Azure云的管理 URL,默认为 https://management.chinacloudapi.cn。 当函数应用在主权云中运行时,请使用此选项。 |
--subscription |
设置默认Azure订阅。 |
func azure functionapp fetch-app-settings
从特定函数应用获取设置。
func azure functionapp fetch-app-settings <APP_NAME>
有关详细信息,请参阅下载应用程序设置。
该命令将设置下载到project的 local.settings.json 文件中。 命令会屏蔽屏幕上的值,以便获得安全性。 可以通过local.settings.json来保护文件中的设置。
func azure functionapp list-functions
返回指定函数应用中的函数列表。
func azure functionapp list-functions <APP_NAME>
| 选项 | 说明 |
|---|---|
--show-keys |
返回的函数终结点 URL 包括函数级access键值。 |
func azure functionapp logstream
将本地命令提示符连接到Azure中函数应用的流式处理日志。
func azure functionapp logstream <APP_NAME>
连接的默认超时为两小时。 可以通过添加名为 SCM_LOGSTREAM_TIMEOUT 的应用设置来更改超时值,超时值以秒为单位。
在弹性消耗或消耗计划中,Linux 尚不支持此功能。 对于这些应用,请使用 --browser 选项在门户中查看日志。
deploy 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--browser |
在默认浏览器中打开函数应用的 Azure Application Insights Live Stream。 |
有关详细信息,请参阅 Azure Functions 中启用流式处理执行日志。
func azure functionapp publish
将 Functions project部署到Azure中的现有函数应用资源。
func azure functionapp publish <APP_NAME>
有关详细信息,请参阅 Deploy project 文件。
以下发布选项适用于不同的版本:
| 选项 | 说明 |
|---|---|
--additional-packages |
构建本机依赖项时要安装的包列表。 例如:python3-dev libevent-dev。 |
--build,-b |
部署到 Linux 函数应用时执行生成操作。 接受:remote 和 local。 |
--build-native-deps |
发布 Python 函数应用时跳过生成 .wheels 文件夹。 |
--csx |
发布 C# 脚本 (.csx) project。 |
--dotnet-cli-params |
发布已编译的 C# (.csproj) 函数时,Core Tools 调用 dotnet build --output bin/publish。 传递到此选项的任何参数将追加到命令行。 |
--force |
在某些情况下忽略预发布验证。 |
--list-ignored-files |
基于 .funcignore 文件显示发布期间忽略的文件列表。 |
--list-included-files |
基于 .funcignore 文件显示发布的文件列表。 |
--no-build |
发布期间不会生成Project。 对于 Python,不执行 pip install。 |
--nozip |
关闭默认的 Run-From-Package 模式。 文件提取到 wwwroot 服务器上的文件夹,而不是直接从部署包运行。 |
--overwrite-settings -y |
使用 --publish-local-settings -i 时隐藏覆盖应用设置的提示。 |
--publish-local-settings -i |
将 local.settings.json 中的设置发布到Azure,提示覆盖设置(如果已存在)。 如果使用 local storage 模拟器,请先将应用设置更改为 actual storage 连接。 |
--publish-settings-only,-o |
仅发布设置,并跳过内容。 默认为提示。 |
func azure storage fetch-connection-string
获取指定Azure Storage帐户的connection string。
func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>
有关详细信息,请参阅 Download a storage connection string。
func azurecontainerapps deploy
将容器化函数应用部署到Azure Container Apps环境。 函数应用和环境使用的storage帐户必须已存在。
func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>
以下部署选项适用:
| 选项 | 说明 |
|---|---|
--environment |
现有容器应用环境的名称。 |
--image-build |
设置为 true 时,跳过本地 Docker 生成。 |
--image-name |
容器注册表中现有容器的映像名称。 映像名称包括标记名称。 |
--location |
用于部署的区域。 理想情况下,此区域与环境和storage帐户资源相同。 |
--name |
用于容器应用环境中函数应用部署的名称。 在门户中管理函数应用时,也使用相同的名称。 该名称在环境中应是唯一的。 |
--registry |
设置后,将运行 Docker 生成,并将映像推送到注册表集中 --registry。 不能将 --registry 与 --image-name 一起使用。 对于Docker Hub,也可以使用 --registry-username。 |
--registry-password |
用于从专用注册表检索映像的密码或令牌。 |
--registry-username |
用于从专用注册表检索映像的用户名。 |
--resource-group |
要在其中创建与函数相关的资源的资源组。 |
--storage-account |
函数应用要使用的storage帐户的connection string。 |
--worker-runtime |
设置函数应用的运行时语言。 此参数仅用于 --image-name 和 --image-build. 否则,在本地生成期间确定语言。 支持的值为:dotnet、dotnetIsolated、node、python、powershell 和 custom(用于客户处理程序)。 |
重要
Storage连接字符串和其他服务凭据是重要的机密。 请确保安全地存储使用 func azurecontainerapps deploy 的任何脚本文件,并且不会将它们存储在任何可公开访问的源代码管理中。
func deploy
func deploy 命令已弃用。 请改用 func kubernetes deploy。
func durable delete-task-hub
删除Durable Functions任务中心中的所有storage artifacts。
func durable delete-task-hub
delete-task-hub 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--task-hub-name |
要使用的 Durable Functions 任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func durable get-history
返回指定业务流程实例的历史记录。
func durable get-history --id <INSTANCE_ID>
get-history 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--id |
指定业务流程实例的 ID(必需)。 |
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--task-hub-name |
要使用的 Durable Functions 任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func durable get-instances
返回所有业务流程实例的状态。 使用 top 参数支持分页。
func durable get-instances
get-instances 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--continuation-token |
可选标记,指示要返回的请求的特定页面或部分。 |
--connection-string-setting |
包含要使用的storage connection string的应用设置的可选名称。 |
--created-after |
(可选)获取在此日期和时间(UTC)之后创建的实例。 接受所有 ISO 8601 格式的日期时间。 |
--created-before |
(可选)获取在特定日期和时间(UTC)之前创建的实例。 接受所有 ISO 8601 格式的日期时间。 |
--runtime-status |
(可选)获取状态与特定状态相符的实例,包括 running、completed 和 failed。 可以提供一个或多个空格分隔的状态。 |
--top |
(可选)限制给定请求中返回的记录数。 |
--task-hub-name |
要使用的Durable Functions任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func durable get-runtime-status
获取指定业务流程实例的状态。
func durable get-runtime-status --id <INSTANCE_ID>
get-runtime-status 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--id |
指定业务流程实例的 ID(必需)。 |
--show-input |
设置后,响应包含函数的输入。 |
--show-output |
设置后,响应包含执行历史记录。 |
--task-hub-name |
要使用的Durable Functions任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func durable purge-history
清除超过指定阈值的业务流程的业务流程实例状态、历史记录和blob storage。
func durable purge-history
purge-history 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--created-after |
(可选)删除此日期/时间 (UTC) 之后创建的实例的历史记录。 接受所有 ISO 8601 格式的日期时间值。 |
--created-before |
(可选)删除此日期/时间 (UTC) 之前创建的实例的历史记录。 接受所有 ISO 8601 格式的日期时间值。 |
--runtime-status |
(可选)删除状态与特定状态(包括 completed、terminated、canceled 和 failed)匹配的实例的历史记录。 可以提供一个或多个空格分隔的状态。 如果不包括 --runtime-status,则无论状态如何,都会删除实例历史记录。 |
--task-hub-name |
要使用的Durable Functions任务中心的可选名称。 |
若要了解详细信息,请参阅 Durable Functions 文档。
func durable raise-event
向指定的业务流程实例引发事件。
func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>
raise-event 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--event-data |
要以内联方式或从 JSON 文件传递到事件的数据(必需)。 对于文件,请使用与号 (@) 作为文件路径的前缀,例如 @path/to/file.json。 |
--event-name |
要引发的事件的名称(必需)。 |
--id |
指定业务流程实例的 ID(必需)。 |
--task-hub-name |
要使用的Durable Functions任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func durable rewind
回退指定的业务流程实例。
func durable rewind --id <INSTANCE_ID> --reason <REASON>
rewind 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--id |
指定业务流程实例的 ID(必需)。 |
--reason |
回退业务流程的原因(必需)。 |
--task-hub-name |
要使用的Durable Functions任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func durable start-new
启动指定业务流程协调程序函数的新实例。
func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>
start-new 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--function-name |
要启动的业务流程协调程序函数的名称(必需)。 |
--id |
指定业务流程实例的 ID(必需)。 |
--input |
以内联方式或从 JSON 文件传递到业务流程协调程序函数的输入(必需)。 对于文件,请使用与号 (@) 作为文件路径的前缀,例如 @path/to/file.json。 |
--task-hub-name |
要使用的Durable Functions任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func durable terminate
停止指定的业务流程实例。
func durable terminate --id <INSTANCE_ID> --reason <REASON>
terminate 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connection-string-setting |
包含要使用的storage connection string的设置的可选名称。 |
--id |
指定业务流程实例的 ID(必需)。 |
--reason |
停止业务流程的原因(必需)。 |
--task-hub-name |
要使用的Durable Functions任务中心的可选名称。 |
有关详细信息,请参阅 Durable Functions 文档。
func extensions install
在非.NET project或 C# 脚本project中手动安装 Functions 扩展。
func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>
install 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--configPath |
包含 extensions.csproj 文件的目录的路径。 |
--csx |
支持 C# 脚本 (.csx) 项目。 |
--force |
更新现有扩展的版本。 |
--output |
扩展的输出路径。 |
--package |
特定扩展包的标识符。 如果未指定,则与 func extensions sync 一样,安装所有引用的扩展。 |
--source |
不使用 NuGet.org 时的 NuGet 馈送源。 |
--version |
扩展包版本。 |
以下示例在本地project中安装事件中心扩展的版本 5.0.1:
func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1
使用 func extensions install 时需考虑下列事项:
对于编译过的 C# 项目(进程内和独立工作进程),请改用标准 NuGet 包安装方法,例如
dotnet add package。若要使用 Core Tools 手动安装扩展,必须安装 .NET SDK。
如果可能,请使用 扩展捆绑包。 以下各项介绍了你可能需要手动安装扩展的一些原因:
- 需要access捆绑包中不可用的特定扩展版本。
- 需要access捆绑包中不可用的自定义扩展。
- 需要access单个捆绑包中不可用的特定扩展组合。
必须先从定义捆绑包的 host.json 文件中删除
extensionBundle对象,然后才能手动安装扩展。 如果已经在 host.json 文件中设置了扩展捆绑包,则不会执行任何操作。首次显式安装扩展时,.NET project名为 extensions.csproj 的文件将添加到应用的根目录project。 此文件定义函数所需的 NuGet 包集。 虽然可以在此文件中使用 NuGet 包引用,但 Core Tools 允许你安装扩展,而无需手动编辑此 C# project文件。
func extensions sync
安装添加到函数应用的所有扩展。
sync 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--configPath |
包含 extensions.csproj 文件的目录的路径。 |
--csx |
支持 C# 脚本 (.csx) 项目。 |
--output |
扩展的输出路径。 |
重新生成缺少的 extensions.csproj 文件。 如果在 host.json 文件中定义扩展捆绑包,则不会执行任何作。
func kubernetes deploy
将 Functions project作为自定义 Docker 容器部署到 Kubernetes 群集。
func kubernetes deploy
此命令将project生成为自定义容器并将其发布到 Kubernetes 群集。 自定义容器必须有一个 Dockerfile。 若要使用 Dockerfile 创建应用,请使用 --dockerfile 选项和 func init 命令。
可使用以下 Kubernetes 部署选项:
| 选项 | 说明 |
|---|---|
--dry-run |
(可选)显示部署模板,但不执行。 |
--config-map-name |
用于部署的现有配置映射的可选名称,功能应用设置。 需要 --use-config-map。 默认行为是基于 Values中的 对象创建设置。 |
--cooldown-period |
在部署纵向缩减到零之前以及所有触发器不再处于活动状态之后的冷却时间(以秒为单位),默认为 300 秒。 |
--ignore-errors |
在资源返回错误后继续进行部署。 默认行为是出错时停止。 |
--image-name |
要用于 Pod 部署以及从中读取函数的映像的名称。 |
--keda-version |
设置要安装的 KEDA 版本。 有效选项为:v1 和 v2(默认)。 |
--keys-secret-name |
用于存储 access 密钥的 Kubernetes 机密集合的名称。 |
--max-replicas |
设置水平 Pod 自动缩放程序 (HPA) 缩放到的最大副本计数。 |
--min-replicas |
设置最小副本计数,如果低于此数,HPA 将不再进行缩放。 |
--mount-funckeys-as-containervolume |
将 access 密钥装载为容器卷。 |
--name |
用于 Kubernetes 中的部署和其他artifacts的名称。 |
--namespace |
设置要部署到的 Kubernetes 命名空间,默认为默认命名空间。 |
--no-docker |
从当前目录而不是从映像中读取函数。 需要装载映像文件系统。 |
--registry |
设置后,系统会运行 Docker 生成并将映像推送到使用该名称的注册表。 不能将 --registry 与 --image-name 一起使用。 对于 Docker,请使用你的用户名。 |
--polling-interval |
检查非 HTTP 触发器的轮询间隔(以秒为单位),默认为 30 秒。 |
--pull-secret |
用于access专用注册表凭据的机密。 |
--secret-name |
现有 Kubernetes 机密集合的名称,该集合包含要用于部署功能应用设置。 默认行为是基于 Values中的 对象创建设置。 |
--show-service-fqdn |
使用 Kubernetes FQDN 而不是 IP 地址(默认行为)显示 HTTP 触发器的 URL。 |
--service-type |
设置 Kubernetes 服务的类型。 支持的值为:ClusterIP、NodePort 和 LoadBalancer(默认)。 |
--use-config-map |
使用 ConfigMap 对象(v1)而不是 Secret 对象(v1)来配置 function 应用设置。 映射名称是使用 --config-map-name 设置的。 |
Core Tools 使用本地 Docker CLI 生成并发布映像。 确保 Docker 已安装在本地。 运行 docker login 命令以连接到帐户。
Azure Functions支持在Azure Functions中托管容器化函数。
func kubernetes install
在 Kubernetes 群集中安装 KEDA。
func kubernetes install
将 KEDA 安装到 kubectl 配置文件中定义的群集。
install 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--dry-run |
显示部署模板,但不执行。 |
--keda-version |
设置要安装的 KEDA 版本。 有效选项为:v1 和 v2(默认)。 |
--namespace |
支持安装到特定的 Kubernetes 命名空间。 如果未设置,则使用默认命名空间。 |
有关详细信息,请参阅 在 Kubernetes 中管理 KEDA 和函数。
func kubernetes remove
从 kubectl 配置文件中定义的 Kubernetes 群集中删除 KEDA。
func kubernetes remove
从 kubectl 配置文件中定义的群集中删除 KEDA。
remove 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--namespace |
支持从特定的 Kubernetes 命名空间中卸载。 如果未设置,则使用默认命名空间。 |
若要了解详细信息,请参阅从 Kubernetes 卸载 KEDA。
func settings add
func settings add <SETTING_NAME> <VALUE>
将 <SETTING_NAME> 替换为应用设置的名称,将 <VALUE> 替换为设置的值。
add 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connectionString |
将名称/值对添加到 ConnectionStrings 集合,而不是 Values 集合。 仅在某些框架需要时才使用 ConnectionStrings 集合。 若要了解详细信息,请参阅 local.settings.json 文件。 |
func settings decrypt
func settings decrypt
该命令还会解密 ConnectionStrings 集合中的connection string值。 在 local.settings.json中,命令设置为 IsEncryptedfalse。 通过加密本地设置,可减少从 local.settings.json 泄露重要信息的风险。 在Azure中,应用程序设置始终存储为加密。
func settings delete
func settings delete <SETTING_NAME>
将 <SETTING_NAME> 替换为应用设置的名称,将 <VALUE> 替换为设置的值。
delete 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--connectionString |
从 ConnectionStrings 集合而不是 Values 集合中删除名称/值对。 |
func settings encrypt
func settings encrypt
该命令还会加密 ConnectionStrings 集合中的connection string值。 在 local.settings.json中,命令集 IsEncrypted 设置为 true,指定本地运行时在使用设置之前解密设置。 通过加密本地设置,可减少从 local.settings.json 泄露重要信息的风险。 在Azure中,应用程序设置始终存储为加密。
func settings list
func settings list
同时也输出 ConnectionStrings 集合中的连接字符串。 默认情况下,为了安全起见,将对值进行掩码处理。 使用选项 --showValue 显示实际值。
list 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--showValue |
显示输出中的实际未掩码值。 |
func templates list
列出可用的函数(触发器)模板。
list 操作支持以下选项:
| 选项 | 说明 |
|---|---|
--language |
用于筛选返回模板的语言。 默认为返回所有语言。 |