Sdílet prostřednictvím

Automatizace nasazení prostředků pro vaši aplikaci funkcí ve službě Azure Functions

  • Článek

K automatizaci procesu nasazení aplikace funkcí můžete použít soubor Bicep nebo šablonu Azure Resource Manageru (ARM). Během nasazení můžete použít existující prostředky Azure nebo vytvořit nové. Automatizace vám pomůže s těmito scénáři:

  • Integrace nasazení prostředků se zdrojovým kódem v nasazeních založených na Azure Pipelines a GitHub Actions
  • Obnovení aplikace funkcí a souvisejících prostředků ze zálohy
  • Nasazení topologie aplikace několikrát

V tomto článku se dozvíte, jak automatizovat vytváření prostředků a nasazení pro Azure Functions. V závislosti na aktivačních událostech a vazbách používaných vašimi funkcemi možná budete muset nasadit další prostředky, které jsou mimo rozsah tohoto článku.

Požadovaný kód šablony závisí na požadovaných možnostech hostování vaší aplikace funkcí. Tento článek podporuje následující možnosti hostování:

Možnost hostování Typ nasazení Další informace najdete v tématu...
Plán Consumption služby Azure Functions Pouze kód Plán Consumption
Plán Flex Consumption služby Azure Functions Pouze kód Plán Flex Consumption
Plán Elastic Premium pro Azure Functions Kód | Kontejner Plán Premium
Plán Azure Functions Dedicated (App Service) Kód | Kontejner Vyhrazený plán
Azure Container Apps Pouze kontejner Hostování Služby Container Apps ve službě Azure Functions
Azure Arc Kód | Kontejner App Service, Functions a Logic Apps ve službě Azure Arc (Preview)

Důležité

Plán Flex Consumption je aktuálně ve verzi Preview.

Při používání tohoto článku mějte na paměti tyto aspekty:

  • Příklady se zobrazují jako jednotlivé části pro konkrétní prostředky. Širokou sadu kompletních příkladů souborů Bicep a šablon ARM najdete v těchto příkladech nasazení aplikace funkcí.
  • Příklady se zobrazují jako jednotlivé části pro konkrétní prostředky. Širokou škálu kompletních příkladů souborů Bicep a šablon ARM najdete v těchto příkladech nasazení aplikace Flex Consumption.
  • Příklady se zobrazují jako jednotlivé části pro konkrétní prostředky.

Požadované prostředky

Musíte vytvořit nebo nakonfigurovat tyto prostředky pro nasazení hostované službou Azure Functions:

Prostředek Požadavek Odkaz na syntaxi a vlastnosti
Účet úložiště Požaduje se Microsoft.Storage/storageAccounts
Komponenta Application Insights Doporučené Microsoft.Insights/components*
Plán hostování Požaduje se Microsoft.Web/serverfarms
Aplikace funkcí Požaduje se Microsoft.Web/sites

Musíte vytvořit nebo nakonfigurovat tyto prostředky pro nasazení hostované službou Azure Functions:

Prostředek Požadavek Odkaz na syntaxi a vlastnosti
Účet úložiště Požaduje se Microsoft.Storage/storageAccounts
Komponenta Application Insights Doporučené Microsoft.Insights/components*
Aplikace funkcí Požaduje se Microsoft.Web/sites

Nasazení hostované službou Azure Container Apps se obvykle skládá z těchto prostředků:

Prostředek Požadavek Odkaz na syntaxi a vlastnosti
Účet úložiště Požaduje se Microsoft.Storage/storageAccounts
Komponenta Application Insights Doporučené Microsoft.Insights/components*
Spravované prostředí Požaduje se Microsoft.App/managedEnvironments
Aplikace funkcí Požaduje se Microsoft.Web/sites

Nasazení hostované službou Azure Arc se obvykle skládá z těchto prostředků:

Prostředek Požadavek Odkaz na syntaxi a vlastnosti
Účet úložiště Požaduje se Microsoft.Storage/storageAccounts
Komponenta Application Insights Doporučené Microsoft.Insights/components1
Prostředí Kubernetes služby App Service Požaduje se Microsoft.ExtendedLocation/customLocations
Aplikace funkcí Požaduje se Microsoft.Web/sites

*Pokud ještě nemáte pracovní prostor služby Log Analytics, který může vaše instance Application Insights používat, musíte tento prostředek také vytvořit.

Když nasadíte více prostředků do jednoho souboru Bicep nebo šablony ARM, je důležité pořadí, ve kterém se prostředky vytvoří. Tento požadavek je výsledkem závislostí mezi prostředky. U takových závislostí nezapomeňte použít dependsOn element k definování závislosti v závislém prostředku. Další informace najdete v tématu Definování pořadí nasazení prostředků v šablonách ARM nebo závislostech prostředků v Bicep.

Požadavky

  • Příklady jsou navržené tak, aby se spouštěly v kontextu existující skupiny prostředků.
  • Protokoly Application Insights i úložiště vyžadují, abyste měli existující pracovní prostor Služby Azure Log Analytics. Pracovní prostory se dají sdílet mezi službami a v každém geografickém regionu byste měli vytvořit pracovní prostor, aby se zlepšil výkon. Příklad vytvoření pracovního prostoru služby Log Analytics najdete v tématu Vytvoření pracovního prostoru služby Log Analytics. Plně kvalifikované ID prostředku pracovního prostoru najdete na stránce pracovního prostoru na webu Azure Portal v části ID prostředku Vlastnosti>nastavení>.
  • Tento článek předpokládá, že jste už vytvořili spravované prostředí v Azure Container Apps. K vytvoření aplikace funkcí hostované v Container Apps potřebujete název i ID spravovaného prostředí.
  • Tento článek předpokládá, že jste už vytvořili vlastní umístění s podporou služby App Service v clusteru Kubernetes s podporou Služby Azure Arc. K vytvoření aplikace funkcí hostované ve vlastním umístění Azure Arc potřebujete ID vlastního umístění i ID prostředí Kubernetes.

Vytvoření účtu úložiště

Všechny aplikace funkcí vyžadují účet úložiště Azure. Potřebujete účet pro obecné účely, který podporuje objekty blob, tabulky, fronty a soubory. Další informace najdete v požadavcích na účet úložiště Azure Functions.

Důležité

Účet úložiště slouží k ukládání důležitých dat aplikace, někdy včetně samotného kódu aplikace. Přístup z jiných aplikací a uživatelů byste měli omezit na účet úložiště.

V této ukázkové části se vytvoří účet úložiště úrovně Standard pro obecné účely 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
  }
}

Další kontext najdete v kompletním souboru main.bicep v úložišti šablon.

Další kontext najdete v kompletním souboru storage-account.bicep v ukázkovém úložišti.

Musíte nastavit připojovací řetězec tohoto účtu úložiště jako AzureWebJobsStorage nastavení aplikace, které funkce vyžadují. Šablony v tomto článku vytvářejí tuto hodnotu připojovací řetězec na základě vytvořeného účtu úložiště, což je osvědčený postup. Další informace naleznete v tématu Konfigurace aplikace.

Kontejner nasazení

Nasazení do aplikace spuštěné v plánu Flex Consumption vyžadují jako zdroj nasazení kontejner ve službě Azure Blob Storage. Můžete použít buď výchozí účet úložiště, nebo můžete zadat samostatný účet úložiště. Další informace najdete v tématu Konfigurace nastavení nasazení.

Tento účet nasazení už musí být nakonfigurovaný při vytváření aplikace, včetně konkrétního kontejneru používaného pro nasazení. Další informace o konfiguraci nasazení najdete v tématu Zdroje nasazení.

Tento příklad ukazuje, jak vytvořit kontejner v účtu úložiště:

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'
    }
  }]
}

Pro fragment kódu v kontextu se podívejte na tento příklad nasazení.

Další nastavení nasazení se konfigurují se samotnou aplikací.

Povolení protokolů úložiště

Vzhledem k tomu, že se účet úložiště používá pro důležitá data aplikace funkcí, měli byste monitorovat, jestli účet upravuje daný obsah. Pokud chcete monitorovat účet úložiště, musíte nakonfigurovat protokoly prostředků služby Azure Monitor pro Službu Azure Storage. V této ukázkové části se pracovní prostor myLogAnalytics služby Log Analytics používá jako cíl pro tyto protokoly.

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
      }
    ]
  }
}

Stejný pracovní prostor lze použít pro prostředek Application Insights definovaný později. Další informace, včetně toho, jak s těmito protokoly pracovat, najdete v tématu Monitorování služby Azure Storage.

Vytvoření Application Insights

K monitorování spouštění aplikací funkcí byste měli používat Application Insights. Application Insights teď vyžaduje pracovní prostor Služby Azure Log Analytics, který je možné sdílet. Tyto příklady předpokládají, že používáte existující pracovní prostor a máte plně kvalifikované ID prostředku pro daný pracovní prostor. Další informace najdete v pracovním prostoru Služby Azure Log Analytics.

V této ukázkové části je prostředek Application Insights definován s typem Microsoft.Insights/components a druhem 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>'
  }
}

Další kontext najdete v kompletním souboru main.bicep v úložišti šablon.

Připojení musí být k aplikaci funkcí poskytováno pomocí APPLICATIONINSIGHTS_CONNECTION_STRING nastavení aplikace. Další informace naleznete v tématu Konfigurace aplikace.

Příklady v tomto článku získávají hodnotu připojovací řetězec vytvořené instance. Starší verze se místo toho můžou použít APPINSIGHTS_INSTRUMENTATIONKEY k nastavení klíče instrumentace, který se už nedoporučuje.

Vytvoření plánu hostování

Aplikace hostované v plánu Flex Consumption služby Azure Functions, plánu Premium nebo vyhrazeném plánu (App Service) musí mít explicitně definovaný plán hostování.

Flex Consumption je plán hostování založený na Linuxu, který staví na spotřebě za to, co používáte bezserverový fakturační model. Plán podporuje privátní sítě, výběr velikosti paměti instance a vylepšenou podporu spravované identity.

Plán Flex Consumption je speciální typ serverfarm prostředku. Můžete ji zadat pomocí FC1 hodnoty Name vlastnosti ve sku vlastnosti s tier hodnotou FlexConsumption.

V této ukázkové části se vytvoří plán 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
  }
}

Další kontext najdete v kompletním souboru function.bicep v ukázkovém úložišti plánu Flex Consumption.

Vzhledem k tomu, že plán Flex Consumption aktuálně podporuje pouze Linux, musíte také nastavit reserved vlastnost na true.

Plán Premium nabízí stejné škálování jako plán Consumption, ale zahrnuje vyhrazené prostředky a další funkce. Další informace najdete v plánu Azure Functions Premium.

Plán Premium je speciální typ serverfarm prostředku. Můžete ho zadat buď pomocí EP1, EP2nebo EP3 pro Name hodnotu vlastnosti ve sku vlastnosti. Způsob, jakým definujete plán hostování funkcí, závisí na tom, jestli vaše aplikace funkcí běží ve Windows nebo Linuxu. Tento ukázkový oddíl vytvoří EP1 plán:

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

Další kontext najdete v kompletním souboru main.bicep v úložišti šablon.

Další informace o objektu sku naleznete SkuDefinition nebo zkontrolujte ukázkové šablony.

V plánu Dedicated (App Service) běží vaše aplikace funkcí na vyhrazených virtuálních počítačích v cenách Basic, Standard a Premium v plánech služby App Service, podobně jako u webových aplikací. Další informace najdete v tématu Vyhrazený plán.

Ukázkový soubor Bicep nebo šablona Azure Resource Manageru najdete v tématu Aplikace funkcí v plánu služby Aplikace Azure Service.

Ve službě Functions je vyhrazený plán pouze běžným plánem služby App Service, který je definovaný prostředkem serverfarm . Musíte zadat alespoň name hodnotu. Seznam podporovaných názvů plánů najdete --sku v az appservice plan create nastavení aktuálního seznamu podporovaných hodnot pro vyhrazený plán.

Způsob, jakým definujete plán hostování, závisí na tom, jestli vaše aplikace funkcí běží ve Windows nebo v Linuxu:

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

Další kontext najdete v kompletním souboru main.bicep v úložišti šablon.

Vytvoření plánu hostování

Nemusíte explicitně definovat prostředek plánu hostování Consumption. Když tuto definici prostředku přeskočíte, při vytváření samotného prostředku aplikace funkcí se automaticky vytvoří nebo vybere plán na základě jednotlivých oblastí.

Plán Consumption můžete explicitně definovat jako speciální typ serverfarm prostředku, který zadáte pomocí hodnoty Dynamic pro dané computeMode prostředky a sku vlastnosti. V této ukázkové části se dozvíte, jak explicitně definovat plán Consumption. Způsob, jakým definujete plán hostování, závisí na tom, jestli vaše aplikace funkcí běží ve Windows nebo v Linuxu.

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'
  }
}

Další kontext najdete v kompletním souboru main.bicep v úložišti šablon.

Prostředí Kubernetes

Azure Functions je možné nasadit do Kubernetes s podporou Služby Azure Arc buď jako projekt kódu, nebo do kontejnerizované aplikace funkcí.

Pokud chcete vytvořit prostředky aplikace a plánu, musíte už pro cluster Kubernetes s podporou Azure Arc vytvořit prostředí Kubernetes služby App Service. V příkladech v tomto článku se předpokládá, že máte ID prostředku vlastního umístění (customLocationId) a prostředí Kubernetes služby App Service (kubeEnvironmentId), do kterého nasazujete, které jsou nastavené v tomto příkladu:

param kubeEnvironmentId string
param customLocationId string

Weby i plány musí odkazovat na vlastní umístění prostřednictvím extendedLocation pole. Jak je znázorněno v tomto zkráceném příkladu, extendedLocation sedí mimo properties, jako partnerský vztah kind a location:

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

Prostředek plánu by měl používat hodnotu Kubernetes (K1) pro SKUpole kind a linux,kubernetesreserved vlastnost by měla být true, protože se jedná o nasazení Linuxu. Musíte také nastavit extendedLocation ID vlastního kubeEnvironmentProfile.id umístění a ID prostředí Kubernetes, což může vypadat jako v této ukázkové části:

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
  }
}

Vytvoření aplikace funkcí

Prostředek aplikace funkcí je definován prostředkem typu Microsoft.Web/sites , kind který zahrnuje functionappminimálně .

Způsob, jakým definujete prostředek aplikace funkcí, závisí na tom, jestli hostujete v Linuxu nebo ve Windows:

Seznam nastavení aplikací požadovaných při spuštění ve Windows najdete v tématu Konfigurace aplikace. Ukázkový soubor Bicep nebo šablona Azure Resource Manageru najdete v šabloně plánu Consumption v aplikaci funkcí hostované ve Windows.

Seznam nastavení aplikací požadovaných při spuštění ve Windows najdete v tématu Konfigurace aplikace.

Flex Consumption nahrazuje mnoho standardních nastavení aplikací a vlastností konfigurace lokality používaných v nasazeních šablon Bicep a ARM. Další informace naleznete v tématu Konfigurace aplikace.

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
      }
    }
  }
}

Další kontext najdete v kompletním souboru function.bicep v ukázkovém úložišti plánu Flex Consumption.

Poznámka:

Pokud se rozhodnete volitelně definovat plán Consumption, musíte vlastnost v aplikaci nastavit serverFarmId tak, aby odkazovat na ID prostředku plánu. Ujistěte se, že aplikace funkcí má dependsOn nastavení, které odkazuje také na plán. Pokud jste plán explicitně nedefinovali, vytvoří se pro vás.

serverFarmId Nastavte vlastnost v aplikaci tak, aby odkazovat na ID prostředku plánu. Ujistěte se, že aplikace funkcí má dependsOn nastavení, které odkazuje také na plán.

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'
        }
      ]
    }
  }
}

Úplný kompletní příklad najdete v tomto souboru 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'
        }
      ]
    }
  }
}

Úplný kompletní příklad najdete v tomto souboru main.bicep.

Zdroje nasazení

Nastavení webu můžete použít linuxFxVersion k vyžádání nasazení konkrétního kontejneru Linuxu do vaší aplikace při jeho vytvoření. Pro přístup k imagím v privátním úložišti se vyžaduje další nastavení. Další informace naleznete v tématu Konfigurace aplikace.

Důležité

Při vytváření vlastních kontejnerů musíte zachovat základní image kontejneru aktualizovanou na nejnovější podporovanou základní image. Podporované základní image pro Azure Functions jsou specifické pro jazyk a nacházejí se v základních imagích Azure Functions.

Tým Functions se zavazuje publikovat měsíční aktualizace těchto základních imagí. Mezi běžné aktualizace patří nejnovější aktualizace podverze a opravy zabezpečení pro modul runtime i jazyky Functions. Kontejner byste měli pravidelně aktualizovat z nejnovější základní image a znovu nasadit aktualizovanou verzi kontejneru.

Soubor Bicep nebo šablona ARM můžou volitelně také definovat nasazení kódu funkce, které můžou zahrnovat tyto metody:

V plánu Flex Consumption se váš kód projektu nasadí z komprimovaného balíčku zip publikovaného do kontejneru úložiště objektů blob. Další informace získáte v tématu Nasazení. Konkrétní účet úložiště a kontejner používaný pro nasazení, metodu ověřování a přihlašovací údaje jsou nastavené v functionAppConfig.deployment.storage elementu properties lokality. Kontejner a všechna nastavení aplikace musí existovat při vytváření aplikace. Příklad vytvoření kontejneru úložiště najdete v tématu Kontejner nasazení.

Tento příklad používá spravovanou identitu přiřazenou systémem pro přístup ke zadanému kontejneru úložiště objektů blob, který se vytvoří jinde v nasazení:

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

Pokud používáte spravované identity, musíte také aplikaci funkcí povolit přístup k účtu úložiště pomocí identity, jak je znázorněno v tomto příkladu:

// 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'
  }
}

Úplný příklad odkazu najdete v tomto souboru Bicep.

Při použití připojovací řetězec místo spravovaných identit musíte místo spravovaných identit nastavit authentication.type hodnotu a nastavit authentication.storageAccountConnectionStringName na StorageAccountConnectionString název nastavení aplikace, které obsahuje účet úložiště nasazení připojovací řetězec.

Soubor Bicep nebo šablona ARM můžou volitelně také definovat nasazení kódu funkce pomocí balíčku pro nasazení zip.

Pokud chcete úspěšně nasadit aplikaci pomocí Azure Resource Manageru, je důležité pochopit, jak se prostředky nasazují v Azure. Ve většině příkladů se konfigurace nejvyšší úrovně používají pomocí .siteConfig Tyto konfigurace je důležité nastavit na nejvyšší úrovni, protože sdělují informace modulu runtime a modulu nasazení Functions. Před uplatněním podřízeného sourcecontrols/web prostředku se vyžadují informace nejvyšší úrovně. I když je možné tato nastavení nakonfigurovat v prostředku podřízené úrovně config/appSettings , v některých případech musí být vaše aplikace funkcí nasazená dříve, než config/appSettings se použije.

Balíček pro nasazení zip

Nasazení zip je doporučený způsob nasazení kódu aplikace funkcí. Ve výchozím nastavení se funkce, které používají nasazení zip, spouští v samotném balíčku nasazení. Další informace, včetně požadavků na balíček pro nasazení, najdete v tématu Nasazení zip pro Azure Functions. Při použití automatizace nasazení prostředků můžete odkazovat na balíček nasazení .zip v šabloně Bicep nebo ARM.

Pokud chcete v šabloně použít nasazení zip, nastavte WEBSITE_RUN_FROM_PACKAGE nastavení v aplikaci tak, aby 1 zahrnovalo definici /zipDeploy prostředku.

Pro plán Consumption v Linuxu místo toho nastavte identifikátor URI balíčku nasazení přímo v WEBSITE_RUN_FROM_PACKAGE nastavení, jak je znázorněno v této ukázkové šabloně.

Tento příklad přidá zdroj nasazení zip do existující aplikace:

@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
  }
}

Při zahrnutí prostředků nasazení zip do šablony mějte na paměti následující skutečnosti:

  • Plány Consumption v Linuxu nepodporují WEBSITE_RUN_FROM_PACKAGE = 1. Místo toho musíte nastavit identifikátor URI balíčku nasazení přímo v WEBSITE_RUN_FROM_PACKAGE nastavení. Další informace najdete v tématu WEBSITE_RUN_FROM_PACKAGE. Příklad šablony najdete v tématu Aplikace funkcí hostovaná v Linuxu v plánu Consumption.

  • Musí packageUri to být umístění, ke kterému má funkce přístup. Zvažte použití úložiště objektů blob v Azure se sdíleným přístupovým podpisem (SAS). Po vypršení platnosti sdíleného přístupového podpisu už nebudou mít funkce přístup ke sdílené složce pro nasazení. Když sas znovu vygenerujete, nezapomeňte nastavení aktualizovat WEBSITE_RUN_FROM_PACKAGE novou hodnotou identifikátoru URI.

  • Při nastavování WEBSITE_RUN_FROM_PACKAGE identifikátoru URI je nutné ručně synchronizovat triggery.

  • Při přidávání nebo aktualizaci nastavení nezapomeňte vždy nastavit všechna požadovaná nastavení aplikace v appSettings kolekci. Aktualizace odebere stávající nastavení, která nejsou explicitně nastavená. Další informace naleznete v tématu Konfigurace aplikace.

  • Služba Functions nepodporuje nasazení webu (msdeploy) pro nasazení balíčků. Místo toho musíte použít nasazení zip v kanálech nasazení a automatizaci. Další informace najdete v tématu Nasazení zip pro Azure Functions.

Vzdálená sestavení

Proces nasazení předpokládá, že soubor .zip, který používáte, nebo nasazení zip obsahuje aplikaci připravenou ke spuštění. To znamená, že ve výchozím nastavení nejsou spuštěna žádná vlastní nastavení.

Existují scénáře, které vyžadují vzdálené opětovné sestavení aplikace. Jedním z takových příkladů je, že potřebujete zahrnout balíčky specifické pro Linux do Pythonu nebo Node.js aplikací, které jste vyvinuli na počítači s Windows. V takovém případě můžete službu Functions nakonfigurovat tak, aby po nasazení zip prováděla vzdálené sestavení kódu.

Způsob vyžádání vzdáleného sestavení závisí na operačním systému, do kterého nasazujete:

Když se aplikace nasadí do Windows, spustí se příkazy specifické pro jazyk (například dotnet restore pro aplikace v jazyce C# nebo npm install pro Node.js aplikace).

Pokud chcete povolit stejné procesy sestavení, které získáte s kontinuální integrací, přidejte SCM_DO_BUILD_DURING_DEPLOYMENT=true do nastavení aplikace v kódu nasazení a úplně odeberte WEBSITE_RUN_FROM_PACKAGE .

Linuxové kontejnery

Pokud nasazujete kontejnerizovanou aplikaci funkcí do plánu Azure Functions Premium nebo Dedicated, musíte:

Pokud některá nastavení chybí, může zřizování aplikace selhat s touto chybou HTTP/500:

Function app provisioning failed.

Další informace naleznete v tématu Konfigurace aplikace.

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
  ]
}

Při nasazování kontejnerizovaných funkcí do Azure Container Apps musí vaše šablona:

  • kind Nastavte pole na hodnotu functionapp,linux,container,azurecontainerapps.
  • managedEnvironmentId Nastavte vlastnost webu na plně kvalifikovaný identifikátor URI prostředí Container Apps.
  • Přidejte odkaz na prostředek v kolekci webu dependsOn při vytváření Microsoft.App/managedEnvironments prostředku ve stejnou dobu jako web.

Definice kontejnerizované aplikace funkcí nasazené z privátního registru kontejneru do existujícího prostředí Container Apps může vypadat jako v tomto příkladu:

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
  ]
}

Při nasazování funkcí do Azure Arc závisí hodnota nastavená pro kind pole prostředku aplikace funkcí na typ nasazení:

Typ nasazení kind hodnota pole
Nasazení jen s kódem functionapp,linux,kubernetes
Nasazení kontejnerů functionapp,linux,kubernetes,container

Musíte také nastavit customLocationId , jak jste to udělali pro prostředek plánu hostování.

Definice kontejnerizované aplikace funkcí využívající image rychlého startu .NET 6 může vypadat jako v tomto příkladu:

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
  ]
}

Konfigurace aplikací

V plánu Flex Consumption nakonfigurujete aplikaci funkcí v Azure se dvěma typy vlastností:

Konfigurace Microsoft.Web/sites vlastnost
Konfigurace aplikací functionAppConfig
Nastavení aplikace siteConfig.appSettings sbírka

Tyto konfigurace aplikací jsou zachovány v functionAppConfig:

Chování Nastavení v functionAppConfig
Vždy připravené instance scaleAndConcurrency.alwaysReady
Zdroj nasazení deployment
Velikost paměti instance scaleAndConcurrency.instanceMemoryMB
Souběžnost triggeru HTTP scaleAndConcurrency.triggers.http.perInstanceConcurrency
Modul runtime jazyka runtime.name
Jazyková verze runtime.version
Maximální počet instancí scaleAndConcurrency.maximumInstanceCount

Plán Flex Consumption také podporuje tato nastavení aplikace:

Služba Functions nabízí následující možnosti konfigurace aplikace funkcí v Azure:

Konfigurace Microsoft.Web/sites vlastnost
Nastavení webu siteConfig
Nastavení aplikace siteConfig.appSettings sbírka

U vlastnosti jsou vyžadována siteConfig tato nastavení webu:

Tato nastavení webu se vyžadují jenom při použití spravovaných identit k získání image z instance služby Azure Container Registry:

Tato nastavení aplikace jsou povinná (nebo doporučená) pro konkrétní operační systém a možnost hostování:

Pro nasazení kontejnerů se vyžadují tato nastavení aplikace:

Tato nastavení se vyžadují jenom při nasazování z privátního registru kontejneru:

Při práci s nastavením webu a aplikace pomocí souborů Bicep nebo šablon ARM mějte na paměti tyto aspekty:

  • Volitelné alwaysReady nastavení obsahuje pole jednoho nebo více {name,instanceCount} objektů s jedním pro každou skupinu škálování jednotlivých funkcí. Jedná se o skupiny škálování, které se používají k rozhodování o vždy připraveném škálování. Tento příklad nastaví počty vždy připravených http pro skupinu i jednu funkci s názvem helloworld, která je typu neskupené aktivační události:
      alwaysReady: [
    {
      name: 'http'
      instanceCount: 2
    }
    {
      name: 'function:helloworld'
      instanceCount: 1
    }
  ]
  • Je potřeba vzít v úvahu důležité aspekty, kdy byste měli nastavit WEBSITE_CONTENTSHARE automatizované nasazení. Podrobné pokyny najdete v referenčních informacích WEBSITE_CONTENTSHARE .

  • Nastavení aplikace byste měli vždy definovat jako siteConfig/appSettings kolekci vytvářeného Microsoft.Web/sites prostředku, jak je to v příkladech v tomto článku. Tato definice zaručuje, že nastavení, která aplikace funkcí potřebuje ke spuštění, jsou k dispozici při počátečním spuštění.

  • Při přidávání nebo aktualizaci nastavení aplikace pomocí šablon nezapomeňte do aktualizace zahrnout všechna existující nastavení. Musíte to udělat, protože základní volání rozhraní REST API aktualizace nahrazují celý /config/appsettings prostředek. Pokud odeberete existující nastavení, vaše aplikace funkcí se nespustí. Pokud chcete aktualizovat nastavení jednotlivých aplikací prostřednictvím kódu programu, můžete k provedení těchto změn použít Azure CLI, Azure PowerShell nebo Azure Portal. Další informace naleznete v tématu Práce s nastavením aplikace.

Nasazení slotů

Funkce umožňují nasadit různé verze kódu do jedinečných koncových bodů ve vaší aplikaci funkcí. Tato možnost usnadňuje vývoj, ověřování a nasazování aktualizací funkcí bez dopadu na funkce spuštěné v produkčním prostředí. Sloty nasazení jsou funkcí služby Aplikace Azure Service. Počet dostupných slotů závisí na vašem plánu hostování. Další informace najdete v tématu Funkce slotů nasazení služby Azure Functions.

Prostředek slotu se definuje stejným způsobem jako prostředek aplikace funkcí (Microsoft.Web/sites), ale místo toho použijete Microsoft.Web/sites/slots identifikátor prostředku. Příklad nasazení (v šablonách Bicep i ARM), které vytvoří produkční i přípravný slot v plánu Premium, najdete v tématu Aplikace funkcí Azure s slotem nasazení.

Další informace o prohození slotů pomocí šablon najdete v tématu Automatizace pomocí šablon Resource Manageru.

Při práci s nasazeními slotů mějte na paměti následující skutečnosti:

  • Nenastavujte WEBSITE_CONTENTSHARE explicitně nastavení v definici slotu nasazení. Toto nastavení se pro vás vygeneruje při vytváření aplikace v slotu nasazení.

  • Když prohodíte sloty, některá nastavení aplikace se považují za "lepivé", protože zůstanou s slotem a ne s prohozením kódu. Toto nastavení slotu můžete definovat zahrnutím "slotSetting":true do definice konkrétního nastavení aplikace v šabloně. Další informace najdete v tématu Správa nastavení.

Zabezpečená nasazení

Aplikaci funkcí můžete vytvořit v nasazení, ve kterém byla jedna nebo více prostředků zabezpečená integrací s virtuálními sítěmi. Integrace virtuální sítě pro vaši aplikaci funkcí je definována prostředkem Microsoft.Web/sites/networkConfig . Tato integrace závisí na odkazované aplikaci funkcí i prostředcích virtuální sítě. Vaše aplikace funkcí může také záviset na jiných privátních síťových prostředcích, jako jsou privátní koncové body a trasy. Další informace najdete v tématu Možnosti sítě Azure Functions.

Tyto projekty poskytují příklady nasazení aplikací funkcí ve virtuální síti založené na Bicep, včetně omezení přístupu k síti:

Při vytváření nasazení, které používá zabezpečený účet úložiště, musíte nastavení explicitně nastavit WEBSITE_CONTENTSHARE a vytvořit prostředek sdílené složky pojmenovaný v tomto nastavení. Ujistěte se, že vytvoříte Microsoft.Storage/storageAccounts/fileServices/shares prostředek pomocí hodnoty WEBSITE_CONTENTSHARE, jak je znázorněno v tomto příkladu (soubor BIcep šablony|ARM). Budete také muset nastavit vlastnost vnetContentShareEnabled webu na true.

Poznámka:

Pokud tato nastavení nejsou součástí nasazení, které používá zabezpečený účet úložiště, zobrazí se tato chyba při ověřování nasazení: Could not access storage account using provided connection string.

Tyto projekty poskytují příklady nasazení aplikací funkcí ve virtuální síti jak bicep, tak šablony ARM, včetně omezení přístupu k síti:

Scénář s omezeným přístupem Popis
Vytvoření aplikace funkcí s integrací virtuální sítě Vaše aplikace funkcí se vytvoří ve virtuální síti s úplným přístupem k prostředkům v této síti. Příchozí a odchozí přístup k vaší aplikaci funkcí není omezený. Další informace najdete v tématu Integrace virtuální sítě.
Vytvoření aplikace funkcí, která přistupuje k zabezpečenému účtu úložiště Vytvořená aplikace funkcí používá zabezpečený účet úložiště, ke kterému funkce přistupuje pomocí privátních koncových bodů. Další informace najdete v části Omezení účtu úložiště na virtuální síť.
Vytvoření aplikace funkcí a účtu úložiště, které používají privátní koncové body K vytvořené aplikaci funkcí se dá přistupovat jenom pomocí privátních koncových bodů a používá privátní koncové body pro přístup k prostředkům úložiště. Další informace najdete v tématu Privátní koncové body.

Omezené nastavení sítě

Tato nastavení možná budete muset použít i v případě, že má vaše aplikace funkcí omezení sítě:

Nastavení Hodnota Popis
WEBSITE_CONTENTOVERVNET 1 Nastavení aplikace, které vaší aplikaci funkcí umožňuje škálovat, když je účet úložiště omezený na virtuální síť. Další informace najdete v části Omezení účtu úložiště na virtuální síť.
vnetrouteallenabled 1 Nastavení webu, které vynutí veškerý provoz z aplikace funkcí k používání virtuální sítě. Další informace najdete v tématu Integrace místní virtuální sítě. Toto nastavení webu nahrazuje nastavení WEBSITE_VNET_ROUTE_ALLaplikace .

Důležité informace o omezeních sítě

Pokud omezujete přístup k účtu úložiště prostřednictvím privátních koncových bodů, nebudete mít přístup k účtu úložiště prostřednictvím portálu ani k žádnému zařízení mimo virtuální síť. Přístup k zabezpečené IP adrese nebo virtuální síti v účtu úložiště můžete udělit správou výchozího pravidla přístupu k síti.

Přístupové klávesy funkce

Přístupové klíče funkcí na úrovni hostitele jsou definované jako prostředky Azure. To znamená, že můžete vytvářet a spravovat klíče hostitele v šablonách ARM a souborech Bicep. Klíč hostitele je definován jako prostředek typu Microsoft.Web/sites/host/functionKeys. Tento příklad vytvoří přístupový klíč na úrovni hostitele pojmenovaný my_custom_key při vytvoření aplikace funkcí:

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'))
  ]
}

V tomto příkladu name je parametr názvem nové aplikace funkcí. Musíte zahrnout dependsOn nastavení, které zaručuje, že se klíč vytvoří pomocí nové aplikace funkcí. Objekt klíče hostitele může obsahovat value také vlastnost, properties kterou lze použít k nastavení konkrétního klíče.

Pokud vlastnost nenastavíte value , funkce automaticky vygeneruje nový klíč za vás při vytvoření prostředku, což se doporučuje. Další informace o přístupových klíčích, včetně osvědčených postupů zabezpečení pro práci s přístupovými klíči, najdete v tématu Práce s přístupovými klíči ve službě Azure Functions.

Vytvoření šablony

Odborníci s bicepem nebo šablonami ARM můžou ručně zakódovat nasazení pomocí jednoduchého textového editoru. Pro ostatní z nás existuje několik způsobů, jak usnadnit proces vývoje:

  • Visual Studio Code: K dispozici jsou rozšíření, která vám pomůžou pracovat se soubory Bicep a šablonami ARM. Pomocí těchto nástrojů můžete zajistit správnost kódu a poskytnout základní ověření.

  • Azure Portal: Když vytvoříte aplikaci funkcí a související prostředky na portálu, poslední obrazovka Kontrola a vytvoření obsahuje odkaz Ke stažení šablony pro automatizaci .

    Odkaz na šablonu si můžete stáhnout z procesu vytváření azure Functions na webu Azure Portal.

    Tento odkaz ukazuje šablonu ARM vygenerovanou na základě možností, které jste zvolili na portálu. Tato šablona se může zdát trochu složitá při vytváření aplikace funkcí s mnoha novými prostředky. Může ale poskytnout dobrý přehled o tom, jak může šablona ARM vypadat.

Ověření šablony

Při ručním vytvoření souboru šablony nasazení je důležité před nasazením šablonu ověřit. Všechny metody nasazení ověřují syntaxi šablony a vyvolají chybovou validation failed zprávu, jak je znázorněno v následujícím příkladu ve formátu 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":""}}]}}

K ověření šablony před nasazením můžete použít následující metody:

Následující úloha nasazení skupiny prostředků Azure v2 s pokynem deploymentMode: 'Validation' azure Pipelines k ověření šablony.

- 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'

Můžete také vytvořit testovací skupinu prostředků, která vyhledá chyby předběžného nasazení a chyby nasazení .

Nasazení šablony

K nasazení souboru a šablony Bicep můžete použít libovolný z následujících způsobů:

Tlačítko pro nasazení do Azure

Poznámka:

Tato metoda v současné době nepodporuje nasazování souborů Bicep.

Nahraďte <url-encoded-path-to-azuredeploy-json> adresou URL zakódovanou verzí nezpracované cesty azuredeploy.json k souboru na GitHubu.

Tady je příklad, který používá Markdown:

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

Tady je příklad, který používá 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>

Nasazení pomocí PowerShellu

Následující příkazy PowerShellu vytvoří skupinu prostředků a nasadí soubor Bicep nebo šablonu ARM, která vytvoří aplikaci funkcí s požadovanými prostředky. Pokud chcete spustit místně, musíte mít nainstalovaný Azure PowerShell . Spusťte Connect-AzAccount přihlášení.

# 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

K otestování tohoto nasazení můžete použít šablonu, jako je tato , která vytvoří aplikaci funkcí ve Windows v plánu Consumption.

Další kroky

Přečtěte si další informace o tom, jak vyvíjet a konfigurovat Azure Functions.