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

为 Azure Functions 中的函数应用自动执行资源部署

可以使用 Bicep 文件或 Azure 资源管理器 (ARM) 模板自动执行部署函数应用的过程。 在部署期间,可以使用现有的 Azure 资源或创建新资源。 自动化可在以下应用场景中提供帮助:

  • 将资源部署与 Azure Pipelines 和基于 GitHub Actions 的部署中的源代码集成。
  • 从备份还原函数应用和相关资源。
  • 多次部署应用拓扑。

本文介绍如何自动创建 Azure Functions 的资源和部署。 根据函数使用的触发器和绑定,可能需要部署其他资源,这不属于本文的讨论范畴。

所需的模板代码取决于函数应用的所需托管选项。 本文支持以下托管选项:

托管选项 部署类型 若要了解详细信息,请参阅...
Azure Functions 消耗计划 仅限代码 消耗计划
Azure Functions Flex Consumption 计划 仅限代码 Flex 消耗计划
Azure Functions Elastic Premium 计划 代码 |容器 高级计划
Azure Functions Dedicated(应用服务)计划 代码 |容器 专用计划
Azure Container Apps 仅容器 Azure Functions 的容器应用托管
Azure Arc 代码 |容器 Azure Arc 上的应用服务、函数和逻辑应用(预览版)

使用本文时,请记住以下注意事项:

  • 示例显示为特定资源的单个部分。 有关一组广泛的完整 Bicep 文件和 ARM 模板示例,请参阅这些函数应用部署示例
  • 示例显示为特定资源的单个部分。

所需资源

必须为 Azure Functions 托管的部署创建或配置以下资源:

资源 要求 语法和属性参考
存储帐户 必选 Microsoft.Storage/storageAccounts
Application Insights 组件 建议 Microsoft.Insights/components*
托管计划 必须 Microsoft.Web/serverfarms
函数应用 必选 Microsoft.Web/sites

必须为 Azure Functions 托管的部署创建或配置以下资源:

资源 要求 语法和属性参考
存储帐户 必选 Microsoft.Storage/storageAccounts
Application Insights 组件 建议 Microsoft.Insights/components*
函数应用 必选 Microsoft.Web/sites

Azure 容器应用托管部署通常包括以下资源:

资源 要求 语法和属性参考
存储帐户 必选 Microsoft.Storage/storageAccounts
Application Insights 组件 建议 Microsoft.Insights/components*
托管环境 必须 Microsoft.App/managedEnvironments
函数应用 必选 Microsoft.Web/sites

*如果还没有可供 Application Insights 实例使用的 Log Analytics 工作区,则还需要创建此资源。

在单个 Bicep 文件或 ARM 模板中部署多个资源时,创建资源的顺序非常重要。 这一要求是资源之间依赖关系的结果。 对于此类依赖关系,请确保使用 dependsOn 元素在依赖资源中定义依赖关系。 有关详细信息,请参阅在 ARM 模板中定义部署资源的顺序Bicep 中的资源依赖关系

先决条件

  • 这些示例设计为在现有资源组的上下文中执行。
  • Application Insights 和存储日志都需要 Azure Log Analytics 工作区。 工作区可以在服务之间共享,根据经验,你应该在每个地理区域创建一个工作区以提高性能。 有关如何创建 Log Analytics 工作区的示例,请参阅创建 Log Analytics 工作区。 可以在 Azure 门户中的“设置”>“属性”>“资源 ID”下的工作区页面中找到完全限定的工作区资源 ID
  • 本文假设已在 Azure 容器应用中创建托管环境。 需要使用托管环境的名称和 ID 才能创建在容器应用上托管的函数应用。

创建存储帐户

所有函数应用都需要一个 Azure 存储帐户。 你需要一个支持 blob、表、队列和文件的常规用途帐户。 有关详细信息,请参阅 Azure Functions 存储帐户要求

重要

存储帐户用于存储重要的应用数据,有时包括应用程序代码本身。 应限制其他应用和用户对存储帐户的访问。

本示例部分创建标准常规用途 v2 存储帐户:

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: storageAccountName
  location: location
  kind: 'StorageV2'
  sku: {
    name: 'Standard_LRS'
  }
  properties: {
    supportsHttpsTrafficOnly: true
    defaultToOAuthAuthentication: true
    allowBlobPublicAccess: false
  }
}

有关更多上下文,请参阅模板存储库中完整的 main.bicep 文件。

有关更多上下文,请参阅模板存储库中完整的 storage-account.bicep 文件。

需要将此存储帐户的连接字符串设置为 Functions 所需的 AzureWebJobsStorage 应用设置。 本文中的模板基于创建的存储帐户构造此连接字符串值,这是最佳做法。 有关详细信息,请参阅应用程序配置

部署容器

部署到在 Flex Consumption 计划中运行的应用需要 Azure Blob 存储中的容器作为部署源。 可以使用默认存储帐户,也可以指定单独的存储帐户。 有关详细信息,请参阅配置部署设置

创建应用时必须已配置此部署帐户,包括用于部署的特定容器。 若要详细了解如何配置部署,请参阅部署源

此示例演示如何在存储帐户中创建容器:

resource blobServices 'blobServices' = if (!empty(containers)) {
  name: 'default'
  properties: {
    deleteRetentionPolicy: deleteRetentionPolicy
  }
  resource container 'containers' = [for container in containers: {
    name: container.name
    properties: {
      publicAccess: contains(container, 'publicAccess') ? container.publicAccess : 'None'
    }
  }]
}

有关上下文中的代码片段,请参阅此部署示例

其他部署设置由应用本身配置

启用存储日志

由于存储帐户用于重要的函数应用数据,因此应该监视此帐户,以了解该内容的修改情况。 要监视存储帐户,需要为 Azure 存储配置 Azure Monitor 资源日志。 在此示例部分,名为 myLogAnalytics 的 Log Analytics 工作区用作这些日志的目标。

resource blobService 'Microsoft.Storage/storageAccounts/blobServices@2021-09-01' existing = {
  name:'default'
  parent:storageAccountName
}

resource storageDataPlaneLogs 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
  name: '${storageAccountName}-logs'
  scope: blobService
  properties: {
    workspaceId: myLogAnalytics.id
    logs: [
      {
        category: 'StorageWrite'
        enabled: true
      }
    ]
    metrics: [
      {
        category: 'Transaction'
        enabled: true
      }
    ]
  }
}

该工作区可用于稍后定义的 Application Insights 资源。 有关详细信息,包括如何使用这些日志,请参阅监视 Azure 存储

创建 Application Insights

应使用 Application Insights 监视函数应用执行。 Application Insights 现在需要一个可以共享的 Azure Log Analytics 工作区。 以下示例假设你使用现有工作区,并且具有工作区的完全限定的资源 ID。 有关详细信息,请参阅 Azure Log Analytics 工作区

在本示例部分中,Application Insights 资源使用类型 Microsoft.Insights/components 和类型 web 定义:

resource applicationInsight 'Microsoft.Insights/components@2020-02-02' = {
  name: applicationInsightsName
  location: appInsightsLocation
  tags: tags
  kind: 'web'
  properties: {
    Application_Type: 'web'
    WorkspaceResourceId: '<FULLY_QUALIFIED_RESOURCE_ID>'
  }
}

有关更多上下文,请参阅模板存储库中完整的 main.bicep 文件。

必须使用 APPLICATIONINSIGHTS_CONNECTION_STRING 应用程序设置向函数应用提供连接。 有关详细信息,请参阅应用程序配置

本文中的示例获取所创建的实例的连接字符串值。 旧版本可能会改用 APPINSIGHTS_INSTRUMENTATIONKEY 来设置检测密钥,这是不再推荐的做法。

创建托管计划

托管在 Azure Functions Flex Consumption 计划Premium 计划Dedicated(应用服务)计划中的应用必须显式定义托管计划。

Flex Consumption 是基于 Linux 的托管计划,它基于 Consumption 按使用付费的无服务器计费模型。 计划的特点是支持专用网络、实例内存大小选择和改进的托管标识支持。

Flex Consumption 计划是一种特殊的 serverfarm 资源。 可通过在 sku 属性中使用 FC1 作为 Name 属性值并将 tier 值设为 FlexConsumption 来指定它。

本示例部分创建 Flex Consumption 计划:

resource flexFuncPlan 'Microsoft.Web/serverfarms@2023-12-01' = {
  name: planName
  location: location
  tags: tags
  kind: 'functionapp'
  sku: {
    tier: 'FlexConsumption'
    name: 'FC1'
  }
  properties: {
    reserved: true
  }
}

有关更多上下文,请参阅 Flex Consumption 计划示例存储库中完整的 function.bicep 文件。

由于 Flex Consumption 计划目前仅支持 Linux,因此还必须将 reserved 属性设置为 true

高级计划提供与消耗计划相同的扩展,但包括专用资源和附加功能。 若要了解详细信息,请参阅 Azure Functions 高级计划

高级计划是特殊类型的 serverfarm 资源。 可通过使用 EP1EP2EP3 作为 sku 属性中的 Name 属性值来指定它。 定义 Functions 托管计划的方式取决于函数应用是在 Windows 还是 Linux 上运行。 此示例部分创建 EP1 计划:

resource hostingPlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  location: location
  sku: {
    name: 'EP1'
    tier: 'ElasticPremium'
    family: 'EP'
  }
  kind: 'elastic'
  properties: {
    maximumElasticWorkerCount: 20
  }
}

有关更多上下文,请参阅模板存储库中完整的 main.bicep 文件。

有关 sku 对象的详细信息,请参阅 SkuDefinition 或查看示例模板。

在 Dedicated(应用服务)计划中,函数应用在应用服务计划中的基本、标准和高级 SKU 上的专用 VM 上运行,类似于 Web 应用。 有关详细信息,请参阅 Dedicated 计划

有关 Bicep 文件/Azure 资源管理器模板示例,请参阅基于 Azure 应用服务计划的函数应用

在 Functions 中,专用计划只是由 serverfarm 资源定义的常规应用服务计划。 必须至少提供 name 值。 有关受支持的计划名称列表,请参阅 az appservice plan create 中的 --sku 设置,了解 Dedicated 计划的当前受支持值列表。

定义托管计划的方式取决于函数应用是在 Windows 还是 Linux 上运行:

resource hostingPlanName 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  location: location
  sku: {
    tier: 'Standard'
    name: 'S1'
    size: 'S1'
    family: 'S'
    capacity: 1
  }
}

有关更多上下文,请参阅模板存储库中完整的 main.bicep 文件。

创建托管计划

无需显式定义消耗托管计划资源。 如果跳过此资源定义,则在创建函数应用资源本身时,会基于区域自动创建或选择计划。

可以将消耗计划显式定义为特殊类型的 serverfarm 资源,该资源使用 computeModesku 属性的值 Dynamic 指定。 本示例部分演示如何显式定义消耗计划。 定义托管计划的方式取决于函数应用是在 Windows 还是 Linux 上运行。

resource hostingPlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  location: location
  sku: {
    name: 'Y1'
    tier: 'Dynamic'
    size: 'Y1'
    family: 'Y'
    capacity: 0
  }
  properties: {
    computeMode: 'Dynamic'
  }
}

有关更多上下文,请参阅模板存储库中完整的 main.bicep 文件。

Kubernetes 环境

可将 Azure Functions 部署到已启用 Azure Arc 的 Kubernetes 作为代码项目或容器化函数应用。

若要创建应用和计划资源,必须已为支持 Azure Arc 的 Kubernetes 群集创建应用服务 Kubernetes 环境。 本文中的示例假定你具有要部署到的自定义位置 (customLocationId) 和应用服务 Kubernetes 环境 (kubeEnvironmentId) 的资源 ID,此示例中设置了这些资源 ID:

param kubeEnvironmentId string
param customLocationId string

站点和计划必须通过 extendedLocation 字段引用自定义位置。 如该截断示例所示,extendedLocation 位于 properties 外部,作为 kindlocation 的对等方:

resource hostingPlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  ...
  {
    extendedLocation: {
      name: customLocationId
    }
  }
}

计划资源应将 Kubernetes (K1) 值用于 SKUkind 字段应该为 linux,kubernetes,并且 reserved 属性应该为 true,因为它是 Linux 部署。 还必须将 extendedLocationkubeEnvironmentProfile.id 分别设置为自定义位置 ID 和 Kubernetes 环境 ID,如以下示例部分所示:

resource hostingPlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  location: location
  kind: 'linux,kubernetes'
  sku: {
    name: 'K1'
    tier: 'Kubernetes'
  }
  extendedLocation: {
    name: customLocationId
  }
  properties: {
    kubeEnvironmentProfile: {
      id: kubeEnvironmentId
    }
    reserved: true
  }
}

创建函数应用

函数应用资源由类型为 Microsoft.Web/siteskind 的资源定义,其中至少包括 functionapp

定义函数应用资源的方式取决于是托管在 Linux 上还是 Windows 上:

有关在 Windows 上运行时所需的应用程序设置的列表,请参阅应用程序配置。 如需获取 Bicep 文件/Azure 资源管理器模板示例,请参阅消耗计划中托管在 Windows 上的函数应用模板。

有关在 Windows 上运行时所需的应用程序设置的列表,请参阅应用程序配置

Flex Consumption 取代了 Bicep 和 ARM 模板部署中使用的多个标准应用程序设置和站点配置属性。 有关详细信息,请参阅应用程序配置

resource flexFuncApp 'Microsoft.Web/sites@2023-12-01' = {
  name: appName
  location: location
  tags: tags
  kind: 'functionapp,linux'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    serverFarmId: flexFuncPlan.id
    siteConfig: {
      appSettings: [
        {
          name: 'AzureWebJobsStorage__accountName'
          value: storage.name
        }
        {
          name: 'APPLICATIONINSIGHTS_CONNECTION_STRING'
          value: appInsights.properties.ConnectionString
        }
      ]
    }
    functionAppConfig: {
      deployment: {
        storage: {
          type: 'blobContainer'
          value: '${storage.properties.primaryEndpoints.blob}${deploymentStorageContainerName}'
          authentication: {
            type: 'SystemAssignedIdentity'
          }
        }
      }
      scaleAndConcurrency: {
        maximumInstanceCount: maximumInstanceCount
        instanceMemoryMB: instanceMemoryMB
      }
      runtime: { 
        name: functionAppRuntime
        version: functionAppRuntimeVersion
      }
    }
  }
}

有关更多上下文,请参阅 Flex Consumption 计划示例存储库中完整的 function.bicep 文件。

注意

如果选择有选择地定义消耗计划,则必须在应用上设置 serverFarmId 属性,使其指向计划的资源 ID。 确保函数应用还有一个引用该计划的 dependsOn 设置。 如果未显式定义计划,系统会创建一个计划。

在应用上设置 serverFarmId 属性,使其指向计划的资源 ID。 确保函数应用还有一个引用该计划的 dependsOn 设置。

resource functionAppName_resource 'Microsoft.Web/sites@2022-03-01' = {
  name: functionAppName
  location: location
  kind: 'functionapp'
  properties: {
    serverFarmId: hostingPlanName.id
    siteConfig: {
      appSettings: [
        {
          name: 'APPLICATIONINSIGHTS_CONNECTION_STRING'
          value: applicationInsightsName.properties.ConnectionString
        }
        {
          name: 'AzureWebJobsStorage'
          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};EndpointSuffix=${environment().suffixes.storage};AccountKey=${storageAccount.listKeys().keys[0].value}'
        }
        {
          name: 'WEBSITE_CONTENTAZUREFILECONNECTIONSTRING'
          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};EndpointSuffix=${environment().suffixes.storage};AccountKey=${storageAccount.listKeys().keys[0].value}'
        }
        {
          name: 'WEBSITE_CONTENTSHARE'
          value: toLower(functionAppName)
        }
        {
          name: 'FUNCTIONS_EXTENSION_VERSION'
          value: '~4'
        }
        {
          name: 'FUNCTIONS_WORKER_RUNTIME'
          value: 'node'
        }
        {
          name: 'WEBSITE_NODE_DEFAULT_VERSION'
          value: '~14'
        }
      ]
    }
  }
}

如需完整的端到端示例,请参阅此 main.bicep 文件

resource functionApp 'Microsoft.Web/sites@2022-03-01' = {
  name: functionAppName
  location: location
  kind: 'functionapp'
  properties: {
    serverFarmId: hostingPlan.id
    siteConfig: {
      alwaysOn: true
      appSettings: [
        {
          name: 'APPLICATIONINSIGHTS_CONNECTION_STRING'
          value: applicationInsightsName.properties.ConnectionString
        }
        {
          name: 'AzureWebJobsStorage'
          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};EndpointSuffix=${environment().suffixes.storage};AccountKey=${storageAccount.listKeys().keys[0].value}'
        }
        {
          name: 'FUNCTIONS_EXTENSION_VERSION'
          value: '~4'
        }
        {
          name: 'FUNCTIONS_WORKER_RUNTIME'
          value: 'node'
        }
        {
          name: 'WEBSITE_NODE_DEFAULT_VERSION'
          value: '~14'
        }
      ]
    }
  }
}

如需完整的端到端示例,请参阅此 main.bicep 文件

部署源

可以使用 linuxFxVersion 站点设置来请求在创建特定 Linux 容器时部署到应用。 要访问专用存储库中的映像,需要更多设置。 有关详细信息,请参阅应用程序配置

重要

创建自己的容器时,需要将容器的基础映像更新为受支持的最新基础映像。 Azure Functions 支持的基映像特定于语言,可在 Azure Functions 基础映像存储库中找到。

Functions 团队致力于发布这些基础映像的每月更新。 定期更新包括 Functions 运行时和语言的最新次要版本更新和安全修补程序。 你应该定期从最新的基础映像更新容器,并重新部署更新后的容器版本。

Bicep 文件或 ARM 模板还可以选择性地为函数代码定义部署,其中包括以下方法:

Flex Consumption 计划在 blob 存储容器(称为部署容器)中的 zip 压缩包文件中维护项目代码。 可以配置用于部署的存储帐户和容器。 有关更多信息,请参阅部署

必须使用一个部署将代码包发布到部署容器。 在 ARM 或 Bicep 部署期间,可以通过定义使用 /onedeploy 扩展的包源来执行此操作。 如果选择直接将包上传到容器,则包不会自动部署。

部署容器

用于部署、身份验证方法和凭据的特定存储帐户和容器在站点 propertiesfunctionAppConfig.deployment.storage 元素中设置。 创建应用时,容器和任何应用程序设置必须存在。 有关如何创建存储容器的示例,请参阅部署容器

此示例使用系统分配的托管标识访问在部署中的其他位置创建的指定 Blob 存储容器:

deployment: {
  storage: {
    type: 'blobContainer'
    value: '${storage.properties.primaryEndpoints.blob}${deploymentStorageContainerName}'
    authentication: {
      type: 'SystemAssignedIdentity'
    }
  }
}

使用托管标识时,还必须允许函数应用使用标识访问存储帐户,如以下示例所示:

// Allow access from function app to storage account using a managed identity
resource storageRoleAssignment 'Microsoft.Authorization/roleAssignments@2020-04-01-preview' = {
  name: guid(storage.id, storageRoleDefinitionId)
  scope: storage
  properties: {
    roleDefinitionId: resourceId('Microsoft.Authorization/roleDefinitions', storageRoleDefinitionId)
    principalId: flexFuncApp.identity.principalId
    principalType: 'ServicePrincipal'
  }
}

有关完整参考示例,请参阅此 Bicep 文件

此示例要求知道所分配角色的 GUID 值。 可以使用 az role definition list 命令获取任何友好角色名称的此 ID 值,如以下示例所示:

az role definition list --output tsv --query "[?roleName=='Storage Blob Data Owner'].{name:name}"

使用连接字符串代替托管标识时,需要改为将 authentication.type 设置为 StorageAccountConnectionString,并将 authentication.storageAccountConnectionStringName 设置为包含部署存储帐户连接字符串的应用程序设置的名称。

部署包

Flex Consumption 计划使用一个部署来部署代码项目。 代码包本身与在其他 Functions 托管计划中用于 zip 部署的方式相同。 但是,包文件本身的名称必须为 released-package.zip

若要在模板中包含一个部署包,请将 /onedeploy 资源定义用于包含部署包的远程 URL。 Functions 主机必须能够访问此远程包源和部署容器。

此示例将一个部署源添加到现有应用:

@description('The name of the function app.')
param functionAppName string

@description('The location into which the resources should be deployed.')
param location string = resourceGroup().location

@description('The zip content URL for released-package.zip.')
param packageUri string

resource functionAppName_OneDeploy 'Microsoft.Web/sites/extensions@2022-09-01' = {
  name: '${functionAppName}/onedeploy'
  location: location
  properties: {
    packageUri: packageUri
    remoteBuild: false 
  }
}

Bicep 文件或 ARM 模板还可以选择性地使用 zip 部署包为函数代码定义部署。

若要使用 Azure 资源管理器成功部署应用程序,了解如何在 Azure 中部署资源尤为重要。 在大多数情况下,使用 siteConfig 应用顶级配置。 请务必在顶级设置这些配置,因为这些配置会将信息传达给 Functions 运行时和部署引擎。 在应用子 sourcecontrols/web 资源之前,需要使用顶级信息。 虽然可以在子级别 config/appSettings 资源中配置这些设置,但在某些情况下,必须在应用 config/appSettings 之前部署函数应用。

Zip 部署包

Zip 部署是部署函数应用代码的推荐方法。 默认情况下,使用 zip 部署的函数在部署包本身中运行。 有关详细信息,包括部署包的要求,请参阅 Azure Functions 的 Zip 部署。 使用资源部署自动化时,可以在 Bicep 或 ARM 模板中引用 .zip 部署包。

若要在模板中使用 zip 部署,请将应用中的 WEBSITE_RUN_FROM_PACKAGE 设置设置为 1 并包括 /zipDeploy 资源定义。

对于 Linux 上的消耗计划,请直接在 WEBSITE_RUN_FROM_PACKAGE 设置中设置部署包的 URI,如此示例模板所示。

此示例将 zip 部署源添加到现有应用:

@description('The name of the function app.')
param functionAppName string

@description('The location into which the resources should be deployed.')
param location string = resourceGroup().location

@description('The zip content url.')
param packageUri string

resource functionAppName_ZipDeploy 'Microsoft.Web/sites/extensions@2021-02-01' = {
  name: '${functionAppName}/ZipDeploy'
  location: location
  properties: {
    packageUri: packageUri
  }
}

在模板中添加 zip 部署资源时,请记住以下事项:

  • packageUri 必须是 Functions 可以访问的位置。 请考虑将 Azure Blob 存储与共享访问签名 (SAS) 配合使用。 SAS 过期后,Functions 无法再访问用于部署的共享。 重新生成 SAS 时,请记得使用新的 URI 值更新 WEBSITE_RUN_FROM_PACKAGE 设置。

  • WEBSITE_RUN_FROM_PACKAGE 设置为 URI 时,必须手动同步触发器

  • 添加或更新设置时,请确保始终在 appSettings 集合中设置所有必需的应用程序设置。 更新会删除未显式设置的现有设置。 有关详细信息,请参阅应用程序配置

  • Functions 不支持将 Web 部署 (msdeploy) 用于包部署。 必须在部署管道和自动化中使用 zip 部署。 有关详细信息,请参阅 Azure Functions 的 Zip 部署

远程生成

部署过程假定你使用的 .zip 文件或 zip 部署包含可随时运行的应用。 这意味着默认情况下不会运行任何自定义项。

在某些情况下,需要远程重新生成应用。 例如,当需要在 Windows 计算机上开发的 Python 或 Node.js 应用中包含特定于 Linux 的包时。 在这种情况下,可以将 Functions 配置为在 zip 部署后对代码执行远程生成。

请求远程生成的方式取决于要部署到的操作系统:

将应用部署到 Windows 时,会运行特定于语言的命令(例如适用于 C# 应用的 dotnet restore 或适用于 Node.js 应用的 npm install)。

若要启用与持续集成相同的生成过程,请在部署代码中将 SCM_DO_BUILD_DURING_DEPLOYMENT=true 添加到应用程序设置,并完全删除 WEBSITE_RUN_FROM_PACKAGE

Linux 容器

如果要将容器化函数应用 部署到 Azure Functions Premium 或 Dedicated 计划,则必须:

如果缺少某些设置,则应用程序预配可能会失败,并出现以下 HTTP/500 错误:

Function app provisioning failed.

有关详细信息,请参阅应用程序配置

resource functionApp 'Microsoft.Web/sites@2022-03-01' = {
  name: functionAppName
  location: location
  kind: 'functionapp'
  properties: {
    serverFarmId: hostingPlan.id
    siteConfig: {
      appSettings: [
        {
          name: 'AzureWebJobsStorage'
          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};AccountKey=${storageAccount.listKeys().keys[0].value}'
        }
        {
          name: 'FUNCTIONS_WORKER_RUNTIME'
          value: 'node'
        }
        {
          name: 'WEBSITE_NODE_DEFAULT_VERSION'
          value: '~14'
        }
        {
          name: 'FUNCTIONS_EXTENSION_VERSION'
          value: '~4'
        }
        {
          name: 'DOCKER_REGISTRY_SERVER_URL'
          value: dockerRegistryUrl
        }
        {
          name: 'DOCKER_REGISTRY_SERVER_USERNAME'
          value: dockerRegistryUsername
        }
        {
          name: 'DOCKER_REGISTRY_SERVER_PASSWORD'
          value: dockerRegistryPassword
        }
        {
          name: 'WEBSITES_ENABLE_APP_SERVICE_STORAGE'
          value: 'false'
        }
      ]
      linuxFxVersion: 'DOCKER|myacr.azurecr.io/myimage:mytag'
    }
  }
  dependsOn: [
    storageAccount
  ]
}

容器化函数部署到 Azure 容器应用时,模板必须:

  • kind 字段设置为 functionapp,linux,container,azurecontainerapps 的值。
  • managedEnvironmentId 站点属性设置为容器应用环境的完全限定 URI。
  • 与站点同时创建 Microsoft.App/managedEnvironments 资源时,在站点的 dependsOn 集合中添加资源链接。

从专用容器注册表部署到现有容器应用环境的容器化函数应用的定义可能如以下示例所示:

resource functionApp 'Microsoft.Web/sites@2022-03-01' = {
  name: functionAppName
  kind: 'functionapp,linux,container,azurecontainerapps'
  location: location
  properties: {
    serverFarmId: hostingPlanName
    siteConfig: {
      linuxFxVersion: 'DOCKER|myacr.azurecr.io/myimage:mytag'
      appSettings: [
        {
          name: 'FUNCTIONS_EXTENSION_VERSION'
          value: '~4'
        }
        {
          name: 'AzureWebJobsStorage'
          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};AccountKey=${storageAccount.listKeys().keys[0].value}'
        }
        {
          name: 'APPLICATIONINSIGHTS_CONNECTION_STRING'
          value: applicationInsightsName.properties.ConnectionString
        }
      ]
    }
    managedEnvironmentId: managedEnvironmentId
  }
  dependsOn: [
    storageAccount
    hostingPlan
  ]
}

将函数部署到 Azure Arc 时,为函数应用资源的 kind 字段设置的值取决于部署的类型:

部署类型 kind 字段值
仅限代码的部署 functionapp,linux,kubernetes
容器部署 functionapp,linux,kubernetes,container

还必须像对托管计划资源那样设置 customLocationId

使用 .NET 6 快速入门映像的容器化函数应用的定义可能如以下示例所示:

resource functionApp 'Microsoft.Web/sites@2022-03-01' = {
  name: functionAppName
  kind: 'kubernetes,functionapp,linux,container'
  location: location
  extendedLocation: {
    name: customLocationId
  }
  properties: {
    serverFarmId: hostingPlanName
    siteConfig: {
      linuxFxVersion: 'DOCKER|mcr.microsoft.com/azure-functions/4-dotnet-isolated6.0-appservice-quickstart'
      appSettings: [
        {
          name: 'FUNCTIONS_EXTENSION_VERSION'
          value: '~4'
        }
        {
          name: 'AzureWebJobsStorage'
          value: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};AccountKey=${storageAccount.listKeys().keys[0].value}'
        }
        {
          name: 'APPLICATIONINSIGHTS_CONNECTION_STRING'
          value: applicationInsightsName.properties.ConnectionString
        }
      ]
      alwaysOn: true
    }
  }
  dependsOn: [
    storageAccount
    hostingPlan
  ]
}

应用程序配置

在 Flex Consumption 计划中,可以使用两种类型的属性在 Azure 中配置函数应用:

配置 Microsoft.Web/sites 属性
应用程序配置 functionAppConfig
应用程序设置 siteConfig.appSettings 集合

这些应用程序配置在 functionAppConfig 中维护:

行为 functionAppConfig 中设置
始终就绪实例 scaleAndConcurrency.alwaysReady
部署源 deployment
实例内存大小 scaleAndConcurrency.instanceMemoryMB
HTTP 触发器并发 scaleAndConcurrency.triggers.http.perInstanceConcurrency
语言运行时 runtime.name
语言版本 runtime.version
最大实例计数 scaleAndConcurrency.maximumInstanceCount

Flex Consumption 计划还支持以下应用程序设置:

Functions 提供了以下选项用于在 Azure 中配置函数应用:

配置 Microsoft.Web/sites 属性
站点设置 siteConfig
应用程序设置 siteConfig.appSettings 集合

siteConfig 属性需要以下站点设置:

仅当使用托管标识从 Azure 容器注册表实例获取映像时,才需要这些站点设置:

对于特定操作系统和托管选项,这些应用程序设置是必需的(或推荐的):

容器部署需要以下应用程序设置:

仅当从专用容器注册表进行部署时,才需要这些设置:

使用 Bicep 文件或 ARM 模板处理站点和应用程序设置时,请记住以下注意事项:

  • 可选的 alwaysReady 设置包含一个由一个或多个 {name,instanceCount} 对象组成的数组,每个按函数缩放组对应一个对象。 这些缩放组用于制定随时可用的缩放决策。 此示例为 http 组和名为 helloworld 的单个函数(非分组触发器类型)设置了始终就绪的计数:
      alwaysReady: [
        {
          name: 'http'
          instanceCount: 2
        }
        {
          name: 'function:helloworld'
          instanceCount: 1
        }
      ]
    
  • 在自动化部署中设置 WEBSITE_CONTENTSHARE 时,有一些需要考虑的重要事项。 有关详细指南,请参阅 WEBSITE_CONTENTSHARE 参考。
  • 应始终将应用程序设置定义为所创建的 Microsoft.Web/sites 资源的 siteConfig/appSettings 集合,如本文示例中所示。 此定义可保证函数应用运行所需的设置在初始启动时可用。

  • 使用模板添加或更新应用程序设置时,请确保在更新中包含所有现有设置。 必须执行此操作,因为基础更新 REST API 调用会替换整个 /config/appsettings 资源。 如果删除现有设置,函数应用将不会运行。 若要以编程方式更新单个应用程序设置,可以改用 Azure CLI、Azure PowerShell 或 Azure 门户进行更改。 有关详细信息,请参阅使用应用程序设置

槽部署

Functions 支持将不同版本的代码部署到函数应用中的唯一终结点。 使用此选项可以更轻松地开发、验证和部署函数更新,而不会影响生产环境中运行的函数。 部署槽位是 Azure 应用服务的一项功能。 可用槽数取决于托管计划。 有关详细信息,请参阅 Azure Functions 部署槽位函数。

槽资源的定义方式与函数应用资源 (Microsoft.Web/sites) 相同,但使用 Microsoft.Web/sites/slots 资源标识符。 有关在 Premium 计划中创建生产槽和过渡槽的示例部署(在 Bicep 和 ARM 模板中),请参阅具有部署槽位的 Azure 函数应用

若要了解如何使用模板交换槽,请参阅使用资源管理器模板自动执行

使用槽部署时,请记住以下注意事项:

  • 不要在部署槽位定义中显式设置 WEBSITE_CONTENTSHARE 设置。 在部署槽位中创建应用时,会生成此设置。

  • 交换槽时,某些应用程序设置被视为“有粘性的”,因为它们与槽保持一致,而不是与被交换的代码保持一致。 可以通过在模板中的特定应用程序设置定义中包含 "slotSetting":true 来定义此类槽设置。 有关详细信息,请参阅管理设置

安全部署

可以在部署中创建函数应用,其中一个或多个资源已通过与虚拟网络集成受到保护。 函数应用的虚拟网络集成由 Microsoft.Web/sites/networkConfig 资源定义。 此集成取决于引用的函数应用和虚拟网络资源。 函数应用还可能依赖于其他专用网络资源,例如专用终结点和路由。 有关详细信息,请参阅 Azure Functions 网络选项

这些项目提供基于 Bicep 的示例,演示如何在虚拟网络中部署函数应用,包括有网络访问限制的情况:

创建使用安全存储帐户的部署时,必须显式设置 WEBSITE_CONTENTSHARE 设置并创建在此设置中命名的文件共享资源。 确保使用 WEBSITE_CONTENTSHARE 值创建 Microsoft.Storage/storageAccounts/fileServices/shares 资源,如本示例(ARM 模板|Bicep 文件)所示。 还需要将站点属性 vnetContentShareEnabled 设置为 true。

注意

如果这些设置不是使用安全存储帐户的部署的一部分,那么在部署验证期间会看到此错误:Could not access storage account using provided connection string

这些项目提供 Bicep 和 ARM 模板示例,演示如何在虚拟网络中部署函数应用,包括有网络访问限制的情况:

受限制的场景 说明
创建具有虚拟网络集成的函数应用 函数应用是在具有对该网络中资源的完全访问权限的虚拟网络中创建的。 对函数应用的入站和出站访问不受限制。 有关详细信息,请参阅虚拟网络集成
创建访问安全存储帐户的函数应用 创建的函数应用使用安全存储帐户,Functions 使用专用终结点访问该帐户。 有关详细信息,请参阅将存储帐户限制在虚拟网络中
创建使用专用终结点的函数应用和存储帐户 创建的函数应用只能使用专用终结点进行访问,并且它使用专用终结点访问存储资源。 有关详细信息,请参阅专用终结点

受限网络设置

当函数应用存在网络限制时,可能还需要使用这些设置:

设置 说明
WEBSITE_CONTENTOVERVNET 1 使函数应用能够在存储帐户限制在虚拟网络中时进行缩放的应用程序设置。 有关详细信息,请参阅将存储帐户限制在虚拟网络中
vnetrouteallenabled 1 强制来自函数应用的所有流量使用虚拟网络的站点设置。 有关详细信息,请参阅区域虚拟网络集成。 此站点设置取代了应用程序设置 WEBSITE_VNET_ROUTE_ALL

网络限制注意事项

通过专用终结点限制对存储帐户的访问时,无法通过门户或虚拟网络外部的任何设备访问存储帐户。 可以通过管理默认网络访问规则授予对存储帐户中安全 IP 地址或虚拟网络的访问权限。

函数访问密钥

主机级函数访问密钥定义为 Azure 资源。 这意味着可以在 ARM 模板和 Bicep 文件中创建和管理主机密钥。 主机密钥定义为 Microsoft.Web/sites/host/functionKeys 类型的资源。 此示例在创建函数应用时创建名为 my_custom_key 的主机级访问密钥:

resource functionKey 'Microsoft.Web/sites/host/functionKeys@2022-09-01' = {
  name: '${parameters('name')}/default/my_custom_key'
  properties: {
    name: 'my_custom_key'
  }
  dependsOn: [
    resourceId('Microsoft.Web/Sites', parameters('name'))
  ]
}

在此示例中,name 参数是新函数应用的名称。 必须包含一个 dependsOn 设置,以确保使用新的函数应用创建密钥。 最后,主机密钥的 properties 对象还包含可用于设置特定密钥的 value 属性。

如果未设置 value 属性,则建议 Functions 在创建资源时自动生成一个新密钥。 若要详细了解访问密钥,包括使用访问密钥的安全最佳做法,请参阅在 Azure Functions 中使用访问密钥

创建模板

使用 Bicep 或 ARM 模板的专家可以使用简单的文本编辑器对部署手动编码。 对于其他人来说,有几种方法可以简化开发过程:

  • Visual Studio Code:有一些扩展可帮助你处理 Bicep 文件ARM 模板。 可以使用这些工具来帮助确保代码正确,这些工具可提供一些基本验证

  • Azure 门户:在门户中创建函数应用和相关资源时,最后的“查看 + 创建”屏幕有“下载自动化模板”链接

    从 Azure 门户中的 Azure Functions 创建过程下载模板链接。

    此链接显示基于在门户中选择的选项生成的 ARM 模板。 创建包含许多新资源的函数应用时,此模板似乎有点复杂。 但是,它可以为 ARM 模板的外观提供有用的参考。

验证模板

手动创建部署模板文件时,请务必在部署之前验证模板。 所有部署方法都验证模板语法并引发 validation failed 错误消息,如以下 JSON 格式的示例所示:

{"error":{"code":"InvalidTemplate","message":"Deployment template validation failed: 'The resource 'Microsoft.Web/sites/func-xyz' is not defined in the template. Please see https://aka.ms/arm-template for usage details.'.","additionalInfo":[{"type":"TemplateViolation","info":{"lineNumber":0,"linePosition":0,"path":""}}]}}

以下方法可用于在部署之前验证模板:

以下 Azure 资源组部署 v2 任务(具有 deploymentMode: 'Validation')指示 Azure Pipelines 验证模板。

- task: AzureResourceManagerTemplateDeployment@3
  inputs:
    deploymentScope: 'Resource Group'
    subscriptionId: # Required subscription ID
    action: 'Create Or Update Resource Group'
    resourceGroupName: # Required resource group name
    location: # Required when action == Create Or Update Resource Group
    templateLocation: 'Linked artifact'
    csmFile: # Required when  TemplateLocation == Linked Artifact
    csmParametersFile: # Optional
    deploymentMode: 'Validation'

还可以创建测试资源组来查找预检部署错误。

部署模板

可以使用以下任意方法部署 Bicep 文件和模板:

“部署到 Azure”按钮

备注

这种方法目前不支持部署 Bicep 文件。

<url-encoded-path-to-azuredeploy-json> 替换为 GitHub 中 azuredeploy.json 文件的原始路径的 URL 编码版本。

下面为使用 Markdown 的示例:

[![Deploy to Azure](https://azuredeploy.net/deploybutton.png)](https://portal.azure.com/#create/Microsoft.Template/uri/<url-encoded-path-to-azuredeploy-json>)

下面为使用 HTML 的示例:

<a href="https://portal.azure.com/#create/Microsoft.Template/uri/<url-encoded-path-to-azuredeploy-json>" target="_blank"><img src="https://azuredeploy.net/deploybutton.png"></a>

使用 PowerShell 进行部署

以下 PowerShell 命令将创建一个资源组并部署一个 Bicep 文件或 ARM 模板,该文件或模板将创建具有所需资源的函数应用。 若要在本地运行,必须安装 Azure PowerShell。 若要登录到 Azure,必须先运行 Connect-AzAccount

# Register Resource Providers if they're not already registered
Register-AzResourceProvider -ProviderNamespace "microsoft.web"
Register-AzResourceProvider -ProviderNamespace "microsoft.storage"

# Create a resource group for the function app
New-AzResourceGroup -Name "MyResourceGroup" -Location 'West Europe'

# Deploy the template
New-AzResourceGroupDeployment -ResourceGroupName "MyResourceGroup" -TemplateFile main.bicep  -Verbose

若要测试此部署,可以使用这样的模板,该模板在消耗计划中在 Windows 上创建函数应用。

后续步骤

深入了解如何开发和配置 Azure Functions。