你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

Azure Functions 的连续部署

Azure Functions 允许您持续将源代码控制仓库的变更部署到函数应用。 在这个工作流程中,代码更新会触发从项目到Azure的构建、打包和部署。 支持的部署提供商和发布策略取决于托管计划。

托管计划 推荐的CI/CD提供者 部署与发布指导
Flex 消耗 GitHub Actions 或 Azure Pipelines 代码包应用使用 包部署。 对于 容器镜像应用,构建并测试镜像,将不可变版本推送到注册表,并更新应用的镜像引用。 暂不支持部署槽位。
弹性高级、专用和消耗 GitHub Actions 或 Azure Pipelines 使用 ZIP 部署。 如果应用支持,请部署到暂存槽位,验证更新,然后将该槽位交换到生产环境。
Azure 容器应用 容器构建与部署工作流程 部署容器镜像。 有关详细信息,请参阅 Azure 容器应用上的 Azure Functions 概述。

在本文顶部选择您的托管计划,查看适用于您的功能应用的持续部署指南。

对于支持部署时段的托管计划,应将持续部署配置为备用时段,而非生产时段。 在预发布环境中验证更新,然后将预发布槽交换到生产环境。 如果你直接连接到生产槽位,请确保只有符合生产要求的代码才能进入集成分支。

选择与 Flex Consumption 部署源匹配的工作流:

  • 代码包:配置 GitHub Actions 或 Azure Pipelines 以构建和部署应用包。
  • 容器镜像:配置您的 CI/CD 提供程序以构建和测试镜像,将不可变标签或摘要推送到容器注册表,并更新函数应用以引用新镜像。 保留先前验证过的图像版本以便回滚。 更多信息,请参见 更新和回滚映像。

由于 Flex Consumption 不支持部署槽位,请保留您在源代码控制、CI/CD 系统以及容器注册表中的部署历史。

对于 Azure 容器应用 上的函数,构建并部署一个容器映像。 部署名额不存在。 使用 修订版本,并考虑采用 蓝绿部署策略,以实现零停机发布。

本文中的部署中心步骤适用于支持 App Service 源码控制集成的功能应用。 在消耗计划中,此集成仅在 Windows 上受支持。 你也可以用 Azure CLI 配置源代码控制集成。

Azure Functions 支持以下源,以便持续部署到应用:

在 Azure Repos(Azure DevOps 其中的一项服务)中维护项目代码。 支持 Git 和 Team Foundation 版本控制。 与 Azure Pipelines 生成提供程序一起使用。 有关详细信息,请参阅 什么是 Azure Repos?

你也可以将函数应用连接到外部的 Git 仓库,但这个选项需要手动同步。 有关部署选项的详细信息,请参阅 Azure Functions 中的部署技术。

注意

本文中介绍的持续部署选项特定于仅代码部署。 關於 Azure Functions on Azure 容器应用,請參閱 Azure Functions on Azure 容器应用 overview. 关于由 Azure Functions 托管的高级或专用套餐中的自定义容器,请参见“与容器合作”和 Azure Functions 中的“启用容器持续部署到 Azure”部分。

对于代码包部署,Flex Consumption 支持通过 Azure Pipelines 从 Azure Repos 持续部署,以及从 GitHub 通过 GitHub Actions 进行持续部署。 不支持包括 Bitbucket 和本地 Git 部署在内的 App Service 源码控制集成。

对于容器镜像部署,请使用 CI/CD 工作流程,先构建并推送镜像,然后更新函数应用的镜像引用。 App Service 源代码控制集成工作流不会构建或部署 Flex Consumption 容器镜像。

在 Azure 容器应用 上使用函数时,将源代码保持在你偏好的仓库中,并使用 CI/CD 工作流程构建并推送容器镜像。 然后更新你的函数应用,使用新的镜像。 欲了解更多信息,请参见 Azure 容器应用 上的 Functions 部署与设置。

要求

Azure 中用于函数部署的单位是函数应用。 要成功执行持续部署,项目的目录结构须与 Azure Functions 预期的基本文件夹结构兼容。 当你使用Azure Functions Core Tools、Visual Studio Code或Visual Studio创建代码项目时,Azure Functions模板会生成具有正确目录结构的代码项目。 你可以在同一时间、同一个包中部署所有函数应用。

启用持续部署后,Azure门户中对函数代码的访问将设置为只读,因为真相源在其他地方。

注意

部署中心不支持为具有入站网络限制的函数应用启用持续部署。 相反,直接在 GitHub 或 Azure Pipelines 中配置构建提供商的工作流。 运行者或代理必须能够在配置的访问限制下访问应用的部署端点。 当终端是私有的,运行者或代理也需要私有DNS解析。 对于 Azure Pipelines,可以使用连接网络上的自托管代理,或者使用带有网络功能的托管 DevOps 代理池。 对于 GitHub Actions,可以使用连接网络上的自托管运行器,或使用 GitHub 托管的运行器配合 Azure 私有网络。

当你的函数应用有 入站网络限制时,工作流运行者或代理必须能够在配置的访问限制下访问应用的部署端点。 当终端是私有的,运行者或代理也需要私有DNS解析。 对于 Azure Pipelines,可以使用连接网络上的自托管代理,或者使用带有网络功能的托管 DevOps 代理池。 对于 GitHub Actions,可以使用连接网络上的自托管运行器,或使用 GitHub 托管的运行器配合 Azure 私有网络。

你的 CI/CD 工作流程必须构建一个有效的 Azure Functions 容器镜像,将镜像推送到容器应用可以访问的注册表,并更新函数应用,从该镜像创建一个版本。 欲了解更多信息,请参见 Azure 容器应用 上的创建函数应用。

选择生成提供程序

生成代码项目是部署过程的一部分。 特定的生成过程取决于特定的语言堆栈、操作系统和托管计划。 你可以本地或远程构建,取决于你的主机。 有关详细信息,请参阅远程构建。

重要说明

为了提高安全性,可以使用支持托管身份的构建提供商,如 Azure Pipelines 和 GitHub Actions。 App Service 构建服务要求你 启用基础认证 并使用基于文本的凭证。

Azure Functions 支持以下生成提供程序:

Azure Pipelines 是 Azure DevOps 中的服务之一,也是 Azure Repos 项目的默认生成提供程序。 还可以使用 Azure Pipelines 从 GitHub 生成项目。 在 Azure Pipelines 中,有一个专门用于部署到 Azure Functions 的 AzureFunctionApp 任务。 此任务提供对项目生成、打包和部署方式的控制。 Azure Pipelines 支持托管标识。

启用源代码管理集成时,请记住这些提供程序的优势和限制。 可能需要更改存储库源类型才能利用特定的提供程序。

对于代码包应用,可以使用 Azure Pipelines 或 GitHub Actions 来构建和部署你的项目。 这些提供商支持 Microsoft Entra 身份,并使用 Flex Consumption 包部署流程。

App Service 构建服务不适用于 Flex Consumption。

对于容器镜像应用,请使用构建提供者,该提供者可以构建和测试镜像,将其推送到你的容器注册表,并运行 Azure CLI 更新应用的镜像引用。 有关容器映像约定和部署流程,请参阅 通过容器和 Azure Functions Flex Consumption 使用操作系统级依赖。

使用容器构建工具,可以构建你的 Azure Functions 镜像,推送到容器注册表,然后更新函数应用,从新镜像创建版本。 关于端到端的 GitHub Actions 工作流程,请参见“用 GitHub Actions 部署到 Azure 容器应用”。

配置持续部署

Azure门户为您的功能应用提供部署中心,方便配置持续部署。 配置持续部署的特定方式取决于代码所在的源代码管理存储库类型,以及所选生成提供程序。

在 Azure 门户中,浏览到函数应用页,然后在左侧窗格的“部署”下选择“部署中心”。

在 Azure 门户中选择源存储库的函数应用部署中心的截图。

从以下支持选项之一中选择源存储库类型,在其中维护项目代码:

在 Azure DevOps 门户 中定义来自 Azure Repos 且使用 Azure Pipelines 的部署。 不要在函数应用里定义这些部署。 有关如何从 Azure Repos 创建基于 Azure Pipelines 的部署的分步指南,请参阅 使用 Azure Pipelines 实现持续交付。

部署完成后,服务会将指定源代码的所有代码部署到你的应用中。 此时,部署源中的更改会触发将这些更改部署到 Azure 中的函数应用的操作。

对于代码包应用,请使用以下任一提供程序在存储库中配置持续部署:

每次成功的工作流程运行都会部署一个新的应用包。 部署中心的源代码控制集成不支持Flex Consumption。

对于容器镜像应用,配置工作流以构建和测试镜像,推送不可变镜像版本,并更新函数应用以使用该镜像。 更多信息,请参见 “更新并回滚图像”。

配置你的CI/CD工作流程,构建并推送容器镜像,然后将镜像部署到函数应用中。 每次镜像更新都会创建一个容器应用修订版本。 欲了解更多信息,请参见“用 GitHub Actions 部署到 Azure 容器应用”。

在应用创建期间启用持续部署

当你在 Azure 门户中创建函数应用时,可以使用 GitHub Actions 从 GitHub 配置持续部署。 在创建函数应用页面的部署标签页配置 GitHub Actions。

要使用不同的部署源或构建工具进行持续集成,首先创建你的函数应用。 然后返回门户,在 部署中心设置持续集成。

对于 Azure Pipelines,先创建函数应用,然后在 Azure DevOps 中配置管道。

从容器镜像创建函数应用,然后配置你的CI/CD工作流程来发布更新镜像并创建修订版。 欲了解更多信息,请参见 Azure 容器应用 上的创建函数应用。

为部署启用基本身份验证

本节仅适用于使用 App Service 部署端点的部署方法。

在某些情况下,你的函数应用是在禁用对部署端点的基本认证权限的情况下创建的。 该条件阻止所有无法使用 Microsoft Entra 身份访问部署端点的方法发布。 禁用部署端点基本认证的发布影响详述于 “无基本认证部署”中。

重要说明

使用基本身份验证时,凭据以明文形式发送。 为了保护这些凭证,使用基本认证时,你必须通过加密连接(HTTPS)访问部署端点。 有关详细信息,请参阅保护部署。

要为部署端点启用基本身份验证:

  1. 在Azure 门户中,访问您的函数应用。

  2. 在应用的左侧菜单中,选择“设置>>设置。

  3. 将 SCM 基本身份验证发布凭据 设置为 “打开”,然后选择“ 保存”。

供应链管理基础认证不适用于Flex Consumption Package的部署。 默认情况下,Azure Pipelines 使用其所需 Azure 服务连接中的 Microsoft Entra 持有者令牌;建议使用工作负载标识联合。 对于 GitHub Actions,请使用推荐的 OpenID Connect (OIDC) 认证。 这些方法避免了SCM发布凭据,且比基础认证更安全。

这个基本的认证设置不适用于 Azure 容器应用 上的 Functions。 改为配置你的CI/CD提供者、容器注册表和容器应用之间的认证。

后续步骤