Automatizace nasazení prostředků pro vaši aplikaci funkcí ve službě Azure Functions
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) |
Při používání tohoto článku mějte na paměti tyto aspekty:
Neexistuje žádný kanonický způsob strukturování šablony ARM.
Nasazení Bicep je možné modularizovat do několika souborů Bicep.
Tento článek předpokládá, že máte základní znalosti o vytváření souborů Bicep nebo vytváření šablon Azure Resource Manageru.
- 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
, EP2
nebo 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.
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 SKU
pole kind
a linux,kubernetes
reserved
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 functionapp
minimá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:
Plán Flex Consumption udržuje kód projektu v souboru balíčku komprimovaného zip v kontejneru úložiště objektů blob, který se označuje jako kontejner nasazení. Můžete nakonfigurovat účet úložiště i kontejner použitý pro nasazení. Další informace získáte v tématu Nasazení.
K publikování balíčku kódu do kontejneru nasazení musíte použít jedno nasazení. Během nasazení ARM nebo Bicep to můžete provést definováním zdroje balíčku, který používá /onedeploy
rozšíření. Pokud se rozhodnete balíček místo toho přímo nahrát do kontejneru, balíček se automaticky nenasadí.
Kontejner 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.
Tento příklad vyžaduje, abyste znali hodnotu GUID přiřazené role. Tuto hodnotu ID můžete získat pro libovolný popisný název role pomocí příkazu az role definition list , jak je znázorněno v tomto příkladu:
az role definition list --output tsv --query "[?roleName=='Storage Blob Data Owner'].{name:name}"
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.
Balíček pro nasazení
Plán Flex Consumption používá k nasazení projektu kódu jeden nasazení . Samotný balíček kódu je stejný jako v případě nasazení zip v jiných plánech hostování Functions. Název samotného souboru balíčku však musí být released-package.zip
.
Pokud chcete do šablony zahrnout jeden balíček pro nasazení, použijte /onedeploy
definici prostředku pro vzdálenou adresu URL, která obsahuje balíček nasazení. Hostitel služby Functions musí mít přístup ke zdroji tohoto vzdáleného balíčku i ke kontejneru nasazení.
Tento příklad přidá do existující aplikace jeden zdroj nasazení:
@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
}
}
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 vWEBSITE_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í aktualizovatWEBSITE_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:
linuxFxVersion
Nastavte nastavení webu pomocí identifikátoru image kontejneru.- Při získávání kontejneru z privátního registru nastavte všechna požadovaná
DOCKER_REGISTRY_SERVER_*
nastavení. - Nastavte
WEBSITES_ENABLE_APP_SERVICE_STORAGE
nastavení aplikace nafalse
hodnotu .
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 hodnotufunctionapp,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:
- Nastavení založené na připojovacím řetězci:
- Spravovaná nastavení založená na identitách:
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ýchhttp
pro skupinu i jednu funkci s názvemhelloworld
, což je neskupený typ triggeru: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íchWEBSITE_CONTENTSHARE
.
- Pro nasazení kontejnerů je také nastavená hodnota
WEBSITES_ENABLE_APP_SERVICE_STORAGE
false
, protože obsah aplikace je k dispozici v samotném kontejneru.
Nastavení aplikace byste měli vždy definovat jako
siteConfig/appSettings
kolekci vytvářenéhoMicrosoft.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:
- Vysoce škálovaná funkce aktivovaná protokolem HTTP se připojuje k centru událostí zabezpečenému virtuální sítí: Funkce aktivovaná protokolem HTTP (režim izolovaného pracovního procesu .NET) přijímá volání z libovolného zdroje a pak odesílá tělo těchto volání HTTP do zabezpečeného centra událostí spuštěného ve virtuální síti pomocí integrace virtuální sítě.
- Funkce se aktivuje frontou Service Bus zabezpečenou ve virtuální síti: Funkce Pythonu se aktivuje frontou Service Bus zabezpečenou ve virtuální síti. Fronta je přístupná ve virtuální síti pomocí privátního koncového bodu. Virtuální počítač ve virtuální síti slouží k odesílání zpráv.
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_ALL aplikace . |
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 .
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 . Pokud se chcete přihlásit k Azure, musíte nejprve spustit 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
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.