/ notes / azfunctions

Azure functions - Deployment notes

[** DRAFT **]

There are different ways for deploying Azure Functions:



From Visual Studio

  1. download the Azure Function publish profile file (.pubxml)
  2. import it: right click on project –> Publish –> New –> Import Profile
  3. deploy the app: right click on project –> Publish –> select the profile –> press [Publish]

When testing Consuption Azure Functions, Linux Isolated, on NET 8, I encountered errors like these:

Publish has encountered an error. 
We were unable to determine the cause of the error. 
Check the output log for more details.

The attempt to publish the ZIP file through 
https://xxxxxxxxxxxx.scm.azurewebsites.net/api/zipdeploy 
failed with HTTP status code Forbidden.

Possible causes:



From Azure pipelines

Build

Compile for ZipDeploy (mode I) : MSBuild + ArchiveFiles

Output: $(build.artifactStagingDirectory)/BasicFunctionsZD.zip
→ Details here

- task: VSBuild@1
  inputs:
    solution: '**/BasicFunctions.csproj'
    msbuildArgs: '/p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(build.artifactStagingDirectory)\BasicFunctionsZD"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(build.artifactStagingDirectory)/BasicFunctionsZD'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(build.artifactStagingDirectory)/BasicFunctionsZD.zip'
    replaceExistingArchive: true

Compile for ZipDeploy (mode II): dotnet publish with autozip

Output: $(Build.ArtifactStagingDirectory)/CmdBasedFunctionZD/CmdBasedFunction.zip

- task: DotNetCoreCLI@2
  displayName: 'Publish the project - CmdBasedFunction'
  inputs:
    command: 'publish'
    projects: '**/CmdBasedFunction.csproj'
    publishWebProjects: false
    arguments: '--no-build --configuration $(buildConfiguration) --output $(Build.ArtifactStagingDirectory)/CmdBasedFunctionZD'
    zipAfterPublish: true



Deployment

- task: AzureFunctionApp@1
  inputs:
    azureSubscription: 'subscription_name'
    appType: 'functionApp'
    appName: 'appname'
    package: '$(System.ArtifactsDirectory)/**/BasicFunctionsZD.zip'
    deploymentMethod: 'auto'

Example: https://docs.microsoft.com/en-us/learn/modules/deploy-azure-functions/4-deploy-azure-function




Misc

ZipDeploy breaks traditional Visual Studio publish from profile

After deploying from DevOps Pipeline, the traditional WebDeploy from Visual Studio hangs with errors like:

2>An error occurred when the request was processed on the remote computer.
2>Could not find file 'D:\home\site\wwwroot\App_Offline.htm'.

This is because DevOps task AzureFunctionApp@1 sets the Funtcion App to configuration to run-from-package:

{"WEBSITE_RUN_FROM_PACKAGE":"1"}

Delete the entry if you need to deploy from Visual Studio via WebDeploy.

Create a local .zip file for ZIP deployment

The output zip must start from the files insiede abc folder and must not have an inside folder ‘abc’. The option abc\* solve the issue.

dotnet publish BasicFunctions -c Release -o _temp\abc
powershell Compress-Archive _temp\abc\* _temp\abc.zip -Force

Publish & Download artifacts

Note: if you use the old PublishBuildArtifacts and get the artifact with DownloadPipelineArtifact, you’lle get this misleading warning.

##[warning]Please use Download Build Artifact task for downloading Build Artifact type artifact.

It should be “use the new PublishPipelineArtifact instead of PublishBuildArtifacts in the source pipeline”.

→ documentation