functions 包

包含用于打包 Azure 机器学习模型以部署到 Azure Functions 的功能。

使用 Azure Functions，可以运行可由指定事件（例如数据更改）触发的，或按机器学习工作流中经常需要的计划触发的小段代码（称为“函数”）。 有关详细信息，请参阅 Azure Functions 简介。

使用此包中的函数，可以从 Azure 机器学习工作区中注册的模型创建 Azure Functions 应用程序。 每个函数返回一个 ModelPackage 对象，该对象表示封装模型及其依赖项的 Docker 映像或 Dockerfile 生成上下文。

有关使用用于机器学习的 Azure Functions 的示例，请参阅教程：在 Azure Functions 中使用 Python 和 TensorFlow 应用机器学习模型和教程：使用 PyTorch 将预先训练的图像分类模型部署到 Azure Functions。

函数

package

以 Docker 映像或 Dockerfile 生成上下文的形式创建模型包。

此函数创建模型包，以便在具有指定 trigger 类型的 Azure Functions 中使用。 此包中的其他函数为特定的触发器类型创建模型包。 有关详细信息，请参阅 Azure Functions 触发器和绑定。

package(workspace, models, inference_config, generate_dockerfile=False, functions_enabled=False, trigger=None, **kwargs)

参数

名称	说明
workspace 必需	Workspace 要在其中创建包的工作区。
models 必需	list[Model] 要包含在包中的模型对象列表。 可以是空列表。
inference_config 必需	InferenceConfig 用于配置模型操作的 InferenceConfig 对象。 此项必须包括环境对象。
generate_dockerfile	bool 是否创建可在本地运行的 Dockerfile，而不是生成映像。 默认值: False
functions_enabled	bool 是否应在打包容器中启用 Azure Functions。 默认值: False
trigger	str 函数的可选触发器。 值可以是“blob”、“http”或“service_bus_queue”。 默认值: None
kwargs 必需	此模块中定义的特定包函数的任何参数。 例如，对于 package_http 方法，传递的参数是 auth_level。

返回

类型	说明
ModelPackage	ModelPackage 对象。

例外

类型	说明
WebserviceException	指定的触发器无效。

package_blob

使用 Blob 触发器创建作为 Docker 映像或者 Dockerfile 生成上下文的 Azure Functions 模型包。

package_blob(workspace, models, inference_config, generate_dockerfile=False, input_path=None, output_path=None)

参数

名称	说明
workspace 必需	Workspace 要在其中创建包的工作区。
models 必需	list[Model] 要包含在包中的模型对象列表。 可以是空列表。
inference_config 必需	InferenceConfig 用于配置模型操作的 InferenceConfig 对象。 此项必须包括环境对象。
generate_dockerfile	bool 是否创建可在本地运行的 Dockerfile，而不是生成映像。 默认值: False
input_path	str Blob 触发器选项的输入路径。 默认值: None
output_path	str Blob 触发器选项的输出路径。 默认值: None

返回

类型	说明
ModelPackage	ModelPackage 对象。

例外

类型	说明
WebserviceException	指定的触发器无效。

package_http

使用 HTTP 触发器创建作为 Docker 映像或 Dockerfile 生成上下文的 Azure Functions 模型包。

package_http(workspace, models, inference_config, generate_dockerfile=False, auth_level=None)

参数

名称	说明
workspace 必需	Workspace 要在其中创建包的工作区。
models 必需	list[Model] 要包含在包中的模型对象列表。 可以是空列表。
inference_config 必需	InferenceConfig 用于配置模型操作的 InferenceConfig 对象。 此项必须包括环境对象。
generate_dockerfile	bool 是否创建可在本地运行的 Dockerfile，而不是生成映像。 默认值: False
auth_level	str 生成的 HTTP 函数的身份验证级别。 默认值: None

返回

类型	说明
ModelPackage	ModelPackage 对象。

例外

类型	说明
WebserviceException	指定的触发器无效。

package_service_bus_queue

使用服务总线队列触发器创建作为 Docker 映像或者 Dockerfile 的 Azure Functions 模型包。

package_service_bus_queue(workspace, models, inference_config, generate_dockerfile=False, input_queue_name=None, output_queue_name=None)

参数

名称	说明
workspace 必需	Workspace 要在其中创建包的工作区。
models 必需	list[Model] 要包含在包中的模型对象列表。 可以是空列表。
inference_config 必需	InferenceConfig 用于配置模型操作的 InferenceConfig 对象。 此项必须包括环境对象。
generate_dockerfile	bool 是否创建可在本地运行的 Dockerfile，而不是生成映像。 默认值: False
input_queue_name	str 队列触发器选项的输入队列名称。 默认值: None
output_queue_name	str 队列触发器选项的输出队列名称。 默认值: None

返回

类型	说明
ModelPackage	ModelPackage 对象。

例外

类型	说明
WebserviceException	指定的触发器无效。