Sdílet prostřednictvím


AzureRmWebAppDeployment@3 – Azure App Service nasazení úlohy v3

Tuto úlohu použijte k nasazení do Azure App Service webové, mobilní nebo api aplikace pomocí Dockeru, Javy, .NET, .NET Core, Node.js, PHP, Pythonu nebo Ruby.

Aktualizujte služby Aplikace Azure Services ve Windows, Webové aplikaci v Linuxu pomocí integrovaných imagí nebo kontejnerů Dockeru, ASP.NET, .NET Core, PHP, Pythonu nebo Node.js webových aplikací, aplikací Function Apps, Mobile Apps, aplikací API a webových úloh pomocí rozhraní REST API pro nasazení webu nebo rozhraní KUDu REST API.

Syntax

# Azure App Service deploy v3
# Deploy to Azure App Service a web, mobile, or API app using Docker, Java, .NET, .NET Core, Node.js, PHP, Python, or Ruby.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.
# Azure App Service Deploy v3
# Update Azure App Services on Windows, Web App on Linux with built-in images or Docker containers, ASP.NET, .NET Core, PHP, Python or Node.js based Web applications, Function Apps, Mobile Apps, API applications, Web Jobs using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

Vstupy

azureSubscription - Předplatné Azure
Vstupní alias: ConnectedServiceName. string. Povinná hodnota.

Zadejte předplatné Azure Resource Manager pro nasazení.


appType - Typ aplikace
Vstupní alias: WebAppKind. string. Povinná hodnota. Povolené hodnoty: app (webová aplikace), applinux (webová aplikace pro Linux), functionapp (aplikace funkcí (nedoporučuje se, použití úlohy Azure Functions)), api (aplikace API), mobileapp (mobilní aplikace). Výchozí hodnota: app.

Zadejte typ webové aplikace, která se má nasadit.

Poznámka: Zadejte webovou aplikaci pro Linux pro předdefinované image platformy nebo nasazení vlastních imagí kontejneru.


appType - Typ aplikace
Vstupní alias: WebAppKind. string. Povinná hodnota. Povolené hodnoty: app (webová aplikace), applinux (webová aplikace pro Linux), functionapp (aplikace funkcí), api (aplikace API), mobileapp (mobilní aplikace). Výchozí hodnota: app.

Zadejte typ webové aplikace, která se má nasadit.

Poznámka: Zadejte webovou aplikaci pro Linux pro předdefinované image platformy nebo nasazení vlastních imagí kontejneru.


WebAppName - název App Service
string. Povinná hodnota.

Zadejte název existujícího Azure App Service. Služby App Services založené na vybraném typu aplikace budou uvedeny pouze při použití asistent úkolu.


DeployToSlotFlag - Nasazení do slotu
boolean. Nepovinný parametr. Použijte, když WebAppKind != "". Výchozí hodnota: false.

Tuto možnost použijte k nasazení do existujícího slotu jiného než produkčního slotu. Pokud tato možnost není vybraná, pak se Azure App Service nasadí do slotu Production.


ResourceGroupName - Skupina prostředků
string. Vyžaduje se, když DeployToSlotFlag = true.

Zadejte skupinu prostředků Azure, která obsahuje výše uvedené Azure App Service.


SlotName - Slot
string. Vyžaduje se, když DeployToSlotFlag = true.

Zadejte existující slot jiný než produkční slot.


ImageSource - Zdroj obrázku
string. Nepovinný parametr. Použijte, když WebAppKind = applinux || WebAppKind = linux. Povolené hodnoty: Registry (Container Registry) Builtin (integrovaná image). Výchozí hodnota: Registry.

App Service v Linuxu nabízí dvě různé možnosti publikování aplikace:

Nasazení vlastní image nebo aplikace s integrovanou imagí platformy


AzureContainerRegistry - Registru
string. Vyžaduje se, když ImageSource = AzureContainerRegistry.

Globálně jedinečný název domény nejvyšší úrovně pro váš konkrétní registr.

Poznámka: Plně kvalifikovaný název image bude mít formát: <registry>/<repository>:.<tag> Příklad: myregistry.azurecr.io/nginx:latest.


AzureContainerRegistryLoginServer - Název přihlašovacího serveru registru
string. Nepovinný parametr. Použijte, když ImageSource = invalidimagesource.

Zadejte název přihlašovacího serveru registru kontejneru Azure.


AzureContainerRegistryImage - Obrázek
string. Vyžaduje se, když ImageSource = AzureContainerRegistry.

Název úložiště, ve kterém jsou uloženy image kontejneru.

Poznámka: Plně kvalifikovaný název image bude mít formát: <registry>/<repository>:.<tag> Příkladmyregistry.azurecr.io/nginx: :.latest


AzureContainerRegistryTag - Značku
string. Nepovinný parametr. Použijte, když ImageSource = AzureContainerRegistry.

Toto je mechanismus, který registry používají k poskytnutí verze imagím Dockeru.

Poznámka: Plně kvalifikovaný název image bude mít formát: <registry>/<repository>:.<tag> Příkladmyregistry.azurecr.io/nginx: :.latest


DockerRepositoryAccess - Přístup k úložišti
string. Vyžaduje se, když ImageSource = invalidImage. Povolené hodnoty: private, public. Výchozí hodnota: public.

Zadejte přístup k úložišti Dockeru.


dockerRegistryConnection - Připojení registru
Vstupní alias: RegistryConnectedServiceName. string. Vyžaduje se, když DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Zadejte připojení registru.


PrivateRegistryImage - Obrázek
string. Vyžaduje se, když ImageSource = PrivateRegistry.

Název úložiště, ve kterém jsou uloženy image kontejneru.

Poznámka: Plně kvalifikovaný název image bude mít formát: <registry><repository>:<tag>. Příkladmyregistry.azurecr.io/nginx: :.latest


PrivateRegistryTag - Značku
string. Nepovinný parametr. Použijte, když ImageSource = PrivateRegistry.

Značky jsou mechanismus, který registry používají k tomu, aby image Dockeru daly verzi.

Poznámka: Plně kvalifikovaný název image bude mít formát : .<registry>/<repository><tag> Příkladmyregistry.azurecr.io/nginx: :.latest


DockerNamespace - Registr nebo obor názvů
string. Vyžaduje se, když WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Globálně jedinečný název domény nejvyšší úrovně pro váš konkrétní registr nebo obor názvů.

Poznámka: Plně kvalifikovaný název image bude mít formát: <registry or namespace>/<repository>:.<tag> Příkladmyregistry.azurecr.io/nginx: :.latest


DockerRepository - Obrázek
string. Vyžaduje se, když WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Název úložiště, ve kterém jsou uloženy image kontejneru.

Poznámka: Plně kvalifikovaný název image bude ve formátu :<registry or namespace><repository>/<tag>. Příkladmyregistry.azurecr.io/nginx: :.latest


DockerImageTag - Značku
string. Nepovinný parametr. Použijte, když WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Toto je mechanismus, který registry používají k poskytnutí verze imagím Dockeru.

Poznámka: Plně kvalifikovaný název image bude mít formát : .<registry or namespace>/<repository><tag> Příkladmyregistry.azurecr.io/nginx: :.latest


VirtualApplication - Virtuální aplikace
string. Nepovinný parametr. Použijte, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Zadejte název virtuální aplikace, která byla nakonfigurována v Azure Portal. Možnost se nevyžaduje pro nasazení do kořenového adresáře App Service.


Package - Balíček nebo složka
string. Vyžaduje se, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Výchozí hodnota: $(System.DefaultWorkingDirectory)/**/*.zip.

Cesta k souboru balíčku nebo složky obsahující obsah služby App Service vygenerovaný nástrojem MSBuild nebo komprimovaný soubor zip nebo war.

Proměnné jsou Build a Release. Jsou podporovány zástupné é ho .

Příkladem je $(System.DefaultWorkingDirectory)/\*\*/\*.zip nebo $(System.DefaultWorkingDirectory)/\*\*/\*.war.


packageForLinux - Balíček nebo složka
Vstupní alias: BuiltinLinuxPackage. string. Vyžaduje se, když WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Výchozí hodnota: $(System.DefaultWorkingDirectory)/**/*.zip.

Cesta k souboru balíčku nebo složky obsahující obsah služby App Service vygenerovaný nástrojem MSBuild nebo komprimovaný soubor zip nebo war.

Proměnné jsou Build a Release. Jsou podporovány zástupné é ho .

Příkladem je $(System.DefaultWorkingDirectory)/\*\*/\*.zip nebo $(System.DefaultWorkingDirectory)/\*\*/\*.war.


RuntimeStack - Zásobník modulu runtime
string. Vyžaduje se, když WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Zadejte architekturu a verzi.


StartupCommand - Spouštěcí příkaz
string. Nepovinný parametr. Použijte, když WebAppKind = applinux || WebAppKind = linux.

Zadejte spouštěcí příkaz.


WebAppUri - adresa URL App Service
string. Nepovinný parametr. Použijte, když WebAppKind != "".

Zadejte název výstupní proměnné, která se vygeneruje pro adresu URL Azure App Service. Proměnnou lze použít v dalších úlohách.


ScriptType - Typ skriptu nasazení
string. Nepovinný parametr. Použijte, když WebAppKind != "". Povolené hodnoty: Inline Script, File Path (Cesta k souboru skriptu).

Přizpůsobí nasazení poskytnutím skriptu, který se spustí ve službě Aplikace Azure po úspěšném dokončení nasazení úlohy . To může například obnovit balíčky pro aplikace Node, PHP a Python. Přečtěte si další informace o nasazení Azure App Service.


InlineScript - Vložený skript
string. Vyžaduje se, když ScriptType == Inline Script && WebAppKind != "". Výchozí hodnota: :: You can provide your deployment commands here. One command per line..


ScriptPath - Cesta ke skriptu nasazení
string. Vyžaduje se, když ScriptType == File Path && WebAppKind != "".


GenerateWebConfig - Generování Web.config
boolean. Nepovinný parametr. Použijte, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Výchozí hodnota: false.

Pokud aplikace nemá, vygeneruje se standard Web.config a nasadí se do Azure App Service. Hodnoty v souboru web.config lze upravit a lišit se v závislosti na architektuře aplikace. Například pro aplikaci web.config bude obsahovat hodnoty spouštěcího node.js souboru a iis_node modulu. Přečtěte si další informace o nasazení Azure App Service.


WebConfigParameters - parametryWeb.config
string. Vyžaduje se, když GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Upraví hodnoty, jako jsou spouštěcí soubory ve vygenerovaném web.config souboru. Tato funkce úprav je určena pouze pro vygenerovanou web.configfunkci . Přečtěte si další informace o nasazení Azure App Service.


AppSettings - Nastavení aplikace
string.

Upraví nastavení aplikace webové aplikace pomocí hodnoty syntaxe -key . Hodnoty obsahující mezery by měly být uzavřeny do dvojitých uvozovek. Příklady: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".


ConfigurationSettings - Nastavení konfigurace
string.

Upraví nastavení konfigurace webové aplikace za hodnotou syntaxe -key . Hodnoty obsahující mezery by měly být uzavřeny do dvojitých uvozovek.

Příklady: -phpVersion 5.6-linuxFxVersion: node|6.11.


TakeAppOfflineFlag - Převést aplikaci do offline režimu
boolean. Nepovinný parametr. Použijte, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Výchozí hodnota: false.

Pomocí této možnosti převést Azure App Service do offline režimu umístěním app_offline.htm souboru do kořenového adresáře App Service před zahájením operace synchronizace. Po úspěšném dokončení operace synchronizace se soubor odebere.


UseWebDeploy - Publikování pomocí nasazení webu
boolean. Nepovinný parametr. Použijte, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Výchozí hodnota: false.

Publish using Web Deploy možnosti jsou podporovány pouze při použití agenta systému Windows. Na jiných platformách se úloha při nasazení Azure App Service spoléhá na rozhraní Kudu REST API a následující možnosti se nepodporují.


SetParametersFile - Soubor SetParameters
string. Nepovinný parametr. Použijte, když UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Umístění souboru, který SetParameters.xml se má použít.


RemoveAdditionalFilesFlag - Odebrání dalších souborů v cíli
boolean. Nepovinný parametr. Použijte, když UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Výchozí hodnota: false.

Tato možnost slouží k odstranění souborů na Azure App Service, které nemají odpovídající soubory v balíčku nebo složce App Service.

Poznámka: Tím se také odeberou všechny soubory související s libovolným rozšířením nainstalovaným na tomto Azure App Service. Chcete-li tomu zabránit, zaškrtněte Exclude files from App_Data folder políčko.


ExcludeFilesFromAppDataFlag - Vyloučení souborů ze složky App_Data
boolean. Nepovinný parametr. Použijte, když UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Výchozí hodnota: false.

Tuto možnost použijte, pokud chcete zabránit nasazení nebo odstranění souborů ve App_Data složce z Azure App Service.


AdditionalArguments - Další argumenty
string. Nepovinný parametr. Použijte, když UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Další argumenty nasazení webu následují za syntaxí -key:value.

Ty se použijí při nasazování Azure App Service. Příklady: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Podívejte se na další příklady nastavení operace nasazení webu.


RenameFilesFlag - Přejmenování uzamčených souborů
boolean. Nepovinný parametr. Použijte, když UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Výchozí hodnota: false.

Tuto možnost použijte k povolení příznaku MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy v Azure App Service nastavení aplikace. Možnost umožňuje službě msdeploy přejmenovat uzamčené soubory, které jsou uzamčené během nasazování aplikace.


enableXmlTransform - Transformace XML
Alias vstupu: XmlTransformation. boolean. Nepovinný parametr. Použijte, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Výchozí hodnota: false.

Transformace konfigurace se spustí pro *.Release.config a *.<EnvironmentName>.config na *.config file.

Transformace konfigurace budou spuštěny před nahrazením proměnné.

Transformace XML jsou podporovány pouze pro platformu Windows.


enableXmlVariableSubstitution - Nahrazení proměnné XML
Alias vstupu: XmlVariableSubstitution. boolean. Nepovinný parametr. Použijte, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Výchozí hodnota: false.

Proměnné definované v kanálu sestavení nebo verze se budou shodovat s key položkami nebo name v appSettingsoddílech , applicationSettingsa connectionStrings jakéhokoli konfiguračního souboru a parameters.xml. Nahrazení proměnné se spouští po transformacích konfigurace.

Poznámka: Pokud jsou stejné proměnné definované v kanálu verze a v prostředí, proměnné prostředí nahradí proměnné kanálu verze.


JSONFiles - Nahrazení proměnné JSON
string. Nepovinný parametr. Použijte, když WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Poskytuje nový seznam souborů JSON oddělených řádky, který nahradí hodnoty proměnných. Názvy souborů se zadají vzhledem ke kořenové složce.

Pokud chcete nahradit vnořené nebo hierarchické proměnné JSON, zadejte je pomocí JSONPath výrazů.

Pokud například chcete nahradit hodnotu ConnectionString v následující ukázce, musíte definovat proměnnou jako Data.DefaultConnection.ConnectionString v kanálu sestavení nebo verze (nebo v prostředí kanálu verze).

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
    }
  }
}

Nahrazení proměnné se spouští po transformacích konfigurace.

Poznámka: Proměnné kanálu jsou vyloučené při nahrazení.


Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

K dispozici je novější verze této úlohy. Další informace najdete v tématu AzureRmWebAppDeployment@4.

Poradce při potížích

Nemůžu nasadit web do Azure App Service pomocí ověřování Microsoft Entra ID z agenta pro Windows

Úloha nasazení Azure App Service podporuje připojení k Microsoft Azure pomocí připojení služby ARM pomocí Microsoft Entra ID, pokud nejsou splněné následující tři podmínky:

  • Používáte formát balíčku Nasazení webu v agentu pro Windows.
  • Váš agent běží se starší verzí msdeploy.exe (například při použití image agenta hostovaného ve Windows-2019 ).
  • Základní ověřování je pro vaši Azure App Service zakázané

Pokud jsou splněné tyto tři podmínky, zobrazí se chyba typu App Service is configured to not use basic authentication. This requires Web Deploy msdeploy.exe version 7.1.7225.2108 or higher. You need a version of Visual Studio that includes an updated version of msdeploy.exe. For more information, visit https://aka.ms/azdo-webapp-msdeploy.

Pokud chcete tento problém vyřešit, můžete si vybrat z následujících možností v pořadí podle priority.

  1. Aktualizujte image agenta. Pokud používáte hostované agenty, přejděte z windows-2019 na windows-2022 (nebo windows-latest). Pokud používáte agenty v místním prostředí, nainstalujte na agenta sadu Visual Studio 2022, abyste získali novější verzi msdeploy.exe.
  2. Pokud jste závislí na starší imagi agenta a nemůžete aktualizovat agenta pro váš kanál, zvažte rozdělení úlohy tak, aby úloha nasazení Azure App Service běžela ve windows-2022 (nebo windows-latest).
  3. Pokud není žádná z těchto možností možná, můžete pro svůj Azure App Service povolit základní ověřování.

Požadavky

Požadavek Popis
Typy kanálů YAML, klasický build, klasická verze
Běží na Agent, DeploymentGroup
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.104.1 nebo vyšší
Kategorie úloh Nasazení