다음을 통해 공유

AzureFunctionApp@1 - Azure Functions v1 작업

  • 아티클

.NET, Python, JavaScript, PowerShell, Java 기반 웹 애플리케이션을 사용하여 함수 앱을 업데이트합니다.

Linux 또는 Windows용 Azure Function을 배포합니다.

통사론

# Azure Functions Deploy v1
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #runtimeStack: # 'DOTNET|6.0' | 'DOTNET-ISOLATED|6.0' | 'DOTNET-ISOLATED|7.0' | 'DOTNET-ISOLATED|8.0' | 'JAVA|8' | 'JAVA|11' | 'JAVA|17' | 'JAVA|21' | 'NODE|14' | 'NODE|16' | 'NODE|18' | 'NODE|20' | 'PYTHON|3.8' | 'PYTHON|3.9' | 'PYTHON|3.10' | 'PYTHON|3.11'. Optional. Use when appType = functionAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Functions Deploy v1
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #runtimeStack: # 'DOTNET|2.2' | 'DOTNET|3.1' | 'DOTNET|6.0' | 'JAVA|8' | 'JAVA|11' | 'NODE|8' | 'NODE|10' | 'NODE|12' | 'NODE|14' | 'NODE|16' | 'PYTHON|3.6' | 'PYTHON|3.7' | 'PYTHON|3.8' | 'PYTHON|3.9'. Optional. Use when appType = functionAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Functions Deploy v1
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #runtimeStack: # 'DOTNET|2.2' | 'DOTNET|3.1' | 'JAVA|8' | 'JAVA|11' | 'NODE|8' | 'NODE|10' | 'NODE|12' | 'NODE|14' | 'PYTHON|3.6' | 'PYTHON|3.7' | 'PYTHON|3.8'. Optional. Use when appType = functionAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Functions Deploy v1
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #runtimeStack: # 'DOTNET|2.2' | 'DOTNET|3.1' | 'JAVA|8' | 'JAVA|11' | 'NODE|8' | 'NODE|10' | 'NODE|12' | 'NODE|14' | 'PYTHON|3.6' | 'PYTHON|3.7' | 'PYTHON|3.8'. Optional. Use when appType = functionAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Functions Deploy v1
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #runtimeStack: # 'DOCKER|microsoft/azure-functions-dotnet-core2.0:2.0' | 'DOCKER|microsoft/azure-functions-node8:2.0'. Optional. Use when appType = functionAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Functions Deploy v1
# Deploy an Azure Function for Linux or Windows.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #runtimeStack: # 'DOCKER|microsoft/azure-functions-dotnet-core2.0:2.0' | 'DOCKER|microsoft/azure-functions-node8:2.0'. Optional. Use when appType = functionAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

입력

Azure Resource Manager 연결
string. 필수.

배포에 대한 Azure Resource Manager 구독을 선택합니다.


appType - 앱 유형
string. 필수. 허용되는 값: functionApp(Windows의 함수 앱), functionAppLinux(Linux의 함수 앱).


Azure Functions 앱 이름
string. 필수.

기존 Azure Functions 앱의 이름을 입력하거나 선택합니다. 나열된 함수 앱은 선택한 앱 유형을 기반으로 합니다.


앱 이름
string. 필수.

기존 Azure Functions 앱의 이름을 입력하거나 선택합니다. 나열된 함수 앱은 선택한 앱 유형을 기반으로 합니다.


슬롯 또는 App Service Environment 배포
boolean. 기본값: false.

기존 배포 슬롯 또는 Azure App Service Environment에 배포합니다. 두 대상 모두 작업에 리소스 그룹 이름이 필요합니다.

배포 대상이 슬롯인 경우 기본적으로 프로덕션 슬롯으로 설정됩니다. 다른 기존 슬롯 이름도 제공할 수 있습니다.

배포 대상이 Azure App Service Environment인 경우 슬롯 이름을 프로덕션 그대로 두고 리소스 그룹 이름을 지정합니다.


resourceGroupName - 리소스 그룹
string. deployToSlotOrASE = true때 필요합니다.

배포 대상이 배포 슬롯 또는 App Service Environment인 경우 리소스 그룹 이름이 필요합니다.

위에서 지정한 Azure App Service를 포함하는 Azure 리소스 그룹을 입력하거나 선택합니다.


slotName - 슬롯
string. deployToSlotOrASE = true때 필요합니다. 기본값: production.

프로덕션 슬롯을 제외한 기존 슬롯을 입력하거나 선택합니다.


패키지 또는 폴더
string. 필수. 기본값: $(System.DefaultWorkingDirectory)/**/*.zip.

MSBuild, 압축된 zip 파일 또는 전쟁 파일에서 생성된 App Service 콘텐츠가 포함된 패키지 또는 폴더의 파일 경로입니다. 변수(빌드 | 릴리스) 및 와일드카드가 지원됩니다. 예를 들어 $(System.DefaultWorkingDirectory)/**/*.zip or $(System.DefaultWorkingDirectory)/**/*.war.


런타임 스택
string. 선택적. appType = functionAppLinux때 사용합니다. 허용되는 값: DOTNET|6.0, DOTNET-ISOLATED|6.0, DOTNET-ISOLATED|7.0, DOTNET-ISOLATED|8.0, JAVA|8, JAVA|11, JAVA|17, JAVA|21, NODE|14, NODE|16, NODE|18, NODE|20, PYTHON|3.8, PYTHON|3.9, PYTHON|3.10, PYTHON|3.11.

함수 앱이 실행될 프레임워크 및 버전을 지정합니다. 지원되는 런타임 버전사용할 수 있습니다. DOCKER|microsoft/azure-functions-* 같은 이전 값은 더 이상 사용되지 않습니다. 새 값은 작업 도우미드롭다운 목록에 나열됩니다. 지원되는 런타임 버전에서 사용할 수 있는 최신 버전의 프레임워크가 목록에 없더라도 지정할 수 있습니다.


런타임 스택
string. 선택적. appType = functionAppLinux때 사용합니다. 허용되는 값: DOTNET|2.2(DOTNET|2.2(functionapp v2)), DOTNET|3.1(DOTNET|3.1(functionapp v3)), DOTNET|6.0(DOTNET|6.0(functionapp v4)), JAVA|8(JAVA|8(functionapp v2/v3/v4)), JAVA|11(JAVA|11(functionapp)입니다. v3/v4)), NODE|8(NODE|8(functionapp v2)), NODE|10(NODE|10(functionapp v2/v3)), NODE|12(NODE|12(functionapp v3)), NODE|14(NODE|14(functionapp v3/v4)), NODE|16(NODE|16(functionapp v4)) PYTHON|3.6(PYTHON|3.6(functionapp v2/v3)), PYTHON|3.7(PYTHON|3.7(functionapp v2/v3/v4)), PYTHON|3.8(PYTHON|3.8(functionapp v3/v4)), PYTHON|3.9(PYTHON|3.9(functionapp v3/v4))

함수 앱이 실행될 프레임워크 및 버전을 지정합니다. 지원되는 런타임 버전사용할 수 있습니다. DOCKER|microsoft/azure-functions-* 같은 이전 값은 더 이상 사용되지 않습니다. 새 값은 작업 도우미드롭다운 목록에 나열됩니다. 지원되는 런타임 버전에서 사용할 수 있는 최신 버전의 프레임워크가 목록에 없더라도 지정할 수 있습니다.


런타임 스택
string. 선택적. appType = functionAppLinux때 사용합니다. 허용되는 값: DOTNET|2.2(DOTNET|2.2(functionapp v2)), DOTNET|3.1(DOTNET|3.1(functionapp v3)), JAVA|8(JAVA|8(functionapp v2/v3)), JAVA|11(JAVA|11(functionapp v3)), NODE|8(NODE|8(functionapp v2)), NODE|10NODE|12(NODE|10(functionapp v2/v3)), NODE|12(NODE|12(functionapp v3)), NODE|14(NODE|14(functionapp v3)), PYTHON|3.6(PYTHON|3.6(functionapp v2/v3)), PYTHON|3.7(PYTHON|3.7(functionapp v2/v3)) PYTHON|3.8(PYTHON|3.8(functionapp v3)).

함수 앱이 실행될 프레임워크 및 버전을 지정합니다. 지원되는 런타임 버전사용할 수 있습니다. DOCKER|microsoft/azure-functions-* 같은 이전 값은 더 이상 사용되지 않습니다. 새 값은 작업 도우미드롭다운 목록에 나열됩니다. 지원되는 런타임 버전에서 사용할 수 있는 최신 버전의 프레임워크가 목록에 없더라도 지정할 수 있습니다.


런타임 스택
string. 선택적. appType = functionAppLinux때 사용합니다. 허용되는 값: DOCKER|microsoft/azure-functions-dotnet-core2.0:2.0(.NET), DOCKER|microsoft/azure-functions-node8:2.0(JavaScript).

함수 앱이 실행될 프레임워크 및 버전을 지정합니다. 지원되는 런타임 버전사용할 수 있습니다. DOCKER|microsoft/azure-functions-* 같은 이전 값은 더 이상 사용되지 않습니다. 새 값은 작업 도우미드롭다운 목록에 나열됩니다. 지원되는 런타임 버전에서 사용할 수 있는 최신 버전의 프레임워크가 목록에 없더라도 지정할 수 있습니다.


startUpCommand - 시작 명령
string. 선택적. appType = functionAppLinux때 사용합니다.

시작 명령을 입력합니다. 예를 들어:

dotnet run
dotnet filename.dll


customWebConfig - Python, Node.js, Go 및 Java 앱 대한 web.config 매개 변수 생성
string. 선택적. appType != functionAppLinux && package NotEndsWith .war때 사용합니다.

애플리케이션에 표준 Web.config 생성되고 애플리케이션에 없는 경우 Azure App Service에 배포됩니다. web.config 값은 애플리케이션 프레임워크에 따라 다르며 편집할 수 있습니다. 예를 들어 node.js 애플리케이션의 경우 web.config 시작 파일과 iis_node 모듈 값이 있습니다. 이 편집 기능은 생성된 web.config전용입니다.


앱 설정
string.

구문 -key value 사용하여 애플리케이션 설정을 입력합니다(예: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). 큰따옴표로 공백을 포함하는 값을 묶습니다(예: "Eastern Standard Time").

앱 설정에 대한 자세한 내용은 Azure App Service환경 변수 및 앱 설정을 참조하세요.


configurationStrings - 구성 설정
string.

구문 -key value 사용하여 구성 문자열을 입력합니다(예: -phpVersion 5.6-linuxFxVersion: node|6.11). 공백이 포함된 값을 큰따옴표로 묶습니다.


deploymentMethod - 배포 방법
string. appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar때 필요합니다. 허용되는 값: auto(자동 검색), zipDeploy(Zip 배포), runFromPackage(패키지에서 실행으로 Zip 배포). 기본값: auto.

앱에 대한 배포 방법 선택합니다.


deploymentMethod - 배포 방법
string. appType != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar때 필요합니다. 허용되는 값: auto(자동 검색), zipDeploy(Zip 배포), runFromPackage(패키지에서 실행). 기본값: auto.

앱에 대한 배포 방법 선택합니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에도 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.

출력 변수

이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수정의합니다.

AppServiceApplicationUrl
선택한 App Service의 애플리케이션 URL입니다.

발언

Azure Function App 작업을 사용하여 함수를 Azure에 배포합니다.

배포 방법

이 작업에서는 몇 가지 배포 방법을 사용할 수 있습니다. 기본값은 auto.

디자이너 작업에서 패키지 기반 배포 옵션을 변경하려면 추가 배포 옵션 확장하고 배포 방법 선택사용하도록 설정합니다.

Azure App Service 및 Azure Pipelines 에이전트 유형에 따라 태스크는 적절한 배포 기술을 사용합니다. 태스크에서 사용하는 배포 기술은 다음과 같습니다.

기본적으로 태스크는 입력 패키지, App Service 유형 및 에이전트 OS에 따라 적절한 배포 기술을 선택하려고 시도합니다.

  • 배포 후 스크립트가 제공되면 Zip 배포를 사용합니다.
  • App Service 유형이 Linux의 웹앱인 경우 Zip 배포를 사용합니다.
  • .war 파일이 제공되면 War Deploy를 사용합니다.
  • .jar 파일이 제공된 경우 Zip에서 실행(Run-From-Zip)을 사용합니다.
  • 다른 모든 작업의 경우 패키지에서 실행(Zip 배포를 통해)을 사용합니다.

Windows가 아닌 에이전트(모든 App Service 유형)에서 태스크는 Kudu REST API 사용하여 웹앱을 배포합니다.

Kudu REST API

대상이 Windows의 웹앱, Linux의 웹앱(기본 제공 원본) 또는 함수 앱인 경우 Kudu REST API Windows 및 Linux 자동화 에이전트 모두에서 작동합니다. 태스크는 Kudu를 사용하여 Azure App Service에 파일을 복사합니다.

Zip 배포

Zip 배포는 선택한 패키지 또는 폴더에서 .zip 배포 패키지를 만듭니다. 그런 다음 Azure에서 App Service 이름 함수 앱의 wwwroot 폴더에 파일 콘텐츠를 배포합니다. 이 옵션은 wwwroot 폴더의 모든 기존 콘텐츠를 덮어씁니다. 자세한 내용은 Azure Functions대한 Zip 배포를 참조하세요.

패키지에서 실행

패키지에서 실행은 Zip 배포와 동일한 배포 패키지를 만듭니다. Wwwroot 폴더에 파일을 배포하는 대신 Functions 런타임은 전체 패키지를 탑재합니다. 이 옵션을 사용하면 wwwroot 폴더의 파일이 읽기 전용이 됩니다. 자세한 내용은 패키지 파일Azure Functions 실행 참조하세요.

문제 해결

오류: Azure에 대한 액세스 토큰을 가져올 수 없습니다. 사용된 서비스 주체가 유효하고 만료되지 않았는지 확인합니다.

태스크는 서비스 연결에서 서비스 주체를 사용하여 Azure로 인증합니다. 서비스 주체가 만료되었거나 App Service에 대한 권한이 없는 경우 이 오류로 인해 작업이 실패합니다. 사용된 서비스 주체의 유효성과 앱 등록에 있는지 확인합니다. 자세한 내용은 역할 기반 액세스 제어를 사용하여 Azure 구독 리소스대한 액세스를 관리합니다. 이 블로그 게시물 서비스 주체 인증 사용에 대한 자세한 정보도 포함되어 있습니다.

SSL 오류

App Service에서 인증서를 사용하려면 신뢰할 수 있는 인증 기관에서 인증서에 서명해야 합니다. 웹앱에서 인증서 유효성 검사 오류를 제공하는 경우 자체 서명된 인증서를 사용할 수 있습니다. VSTS_ARM_REST_IGNORE_SSL_ERRORS 변수를 빌드 또는 릴리스 파이프라인의 true 값으로 설정하여 오류를 해결합니다.

릴리스가 오랫동안 중단된 후 실패합니다.

이 문제는 App Service 계획의 용량 부족의 결과일 수 있습니다. 이 문제를 해결하려면 App Service 인스턴스를 확장하여 사용 가능한 CPU, RAM 및 디스크 공간을 늘리거나 다른 App Service 계획을 사용해 볼 수 있습니다.

5xx 오류 코드

5xx 오류가 표시되는 경우 Azure 서비스상태를 확인합니다.

Azure Function이 갑자기 작동 중지됨

마지막 배포 이후 1년이 지난 경우 Azure Functions의 작동이 갑자기 중지될 수 있습니다. "deploymentMethod"에서 "RunFromPackage"를 사용하여 배포하는 경우 만료 날짜가 1년인 SAS가 생성되고 애플리케이션 구성에서 "WEBSITE_RUN_FROM_PACKAGE" 값으로 설정됩니다. Azure Functions는 이 SAS를 사용하여 함수 실행을 위해 패키지 파일을 참조하므로 SAS가 만료된 경우 함수가 실행되지 않습니다. 이 문제를 해결하려면 다시 배포하여 만료 날짜가 1년인 SAS를 생성합니다.

오류: 지정된 패턴이 있는 패키지를 찾을 수 없음

작업에 언급된 패키지가 빌드 또는 이전 단계에서 아티팩트로 게시되고 현재 작업에서 다운로드되었는지 확인합니다.

오류: zip 배포 옵션을 사용하여 게시는 msBuild 패키지 유형에 대해 지원되지 않습니다.

MSBuild 작업(기본 인수 포함)을 통해 만든 웹 패키지에는 웹 배포에서만 올바르게 배포할 수 있는 중첩된 폴더 구조가 있습니다. 게시-zip 배포 옵션은 해당 패키지를 배포하는 데 사용할 수 없습니다. 패키징 구조를 변환하려면 다음 단계를 수행합니다.

  1. 솔루션 빌드 태스크에서 MSBuild 인수/p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent"변경합니다.

    솔루션 빌드 값을 보여 주는 스크린샷

  2. 보관 작업을 추가하고 다음과 같이 값을 변경합니다.

    1. 루트 폴더 또는 파일을 $(System.DefaultWorkingDirectory)\\WebAppContent보관 변경합니다.

    2. 경로 보관 앞에 추가 루트 폴더 이름을 선택 취소합니다.

      보관 값을 보여 주는 스크린샷

Windows에서 함수 앱 배포가 성공하지만 앱이 작동하지 않음

web.config 파일이 앱에 없는 경우 이 문제가 발생할 수 있습니다. web.config 파일을 원본에 추가하거나 작업의 애플리케이션 및 구성 설정 사용하여 파일을 자동으로 생성할 수 있습니다.

  1. 작업을 선택하고 python, Node.js, Go 및 Java 앱에 대한 web.config 매개 변수 생성이동합니다.

    web.config 매개 변수 생성 섹션을 보여 주는 스크린샷

  2. Python, Node.js, Go 및 Java 앱에 대한 web.config 매개 변수 생성 아래에서 추가 단추(...)를 선택하여 매개 변수를 편집할.

    web.config 매개 변수 생성을 보여 주는 스크린샷

  3. 애플리케이션 프레임워크 목록에서 애플리케이션 유형을 선택합니다.

  4. 확인선택합니다. 이렇게 하면 web.config 파일을 생성하는 데 필요한 web.config 매개 변수가 채워집니다.

FAQ

서비스 연결을 구성하려면 어떻게 해야 하나요?

이 작업에는 Azure Resource Manager 서비스 연결필요합니다.

Application Insights를 사용하여 웹 작업 배포를 구성해야 합니까?

App Service에 배포하는 경우 Application Insights 구성하고 사용하도록 설정한 경우 사용하도록 설정해야 합니다. 이 옵션을 사용하도록 설정하면 Application Insights 확장이 안전한 상태로 유지됩니다. Application Insights 연속 WebJob이 App_Data 폴더에 설치되기 때문에 이 단계가 필요합니다.

App Service에 배포하는 동안 프록시 뒤에 있는 경우 에이전트를 구성하려면 어떻게 해야 하나요?

자체 호스팅 에이전트에 웹 프록시가 필요한 경우 구성 중에 에이전트에 프록시에 대해 알릴 수 있습니다. 이렇게 하면 에이전트가 프록시를 통해 Azure Pipelines 또는 Azure DevOps Server에 연결할 수 있습니다. 웹 프록시뒤에서 자체 호스팅 에이전트를 실행하는 방법에 대해 자세히 알아봅니다.

Azure Resource Manager 서비스 연결 및 Microsoft 호스팅 에이전트를 사용하여 내부 App Service Environment에 배포할 수 없습니다.

기본적으로 Microsoft 호스팅 에이전트는 App Service Environment에서 작동하지 않습니다. 대신 App Service Environment와 동일한 가상 네트워크에 있는 가상 머신에서 프라이빗 에이전트를 구성해야 합니다. 또한 리소스 간의 통신을 사용하도록 프라이빗 DNS 영역을 설정합니다.

예제

Windows에서 Azure 함수를 배포하는 샘플 YAML 코드 조각은 다음과 같습니다.


variables:
  azureSubscription: Contoso
  # To ignore SSL error, uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:
- task: AzureFunctionApp@1
  displayName: Azure Function App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplefunctionapp
    appType: functionApp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

Linux에 함수를 배포하려면 appType 매개 변수를 추가하고 appType: functionAppLinux. 값을 지정하지 않으면 functionApp 기본값입니다.

배포 방법을 Zip Deploy로 명시적으로 지정하려면 매개 변수 deploymentMethod: zipDeploy추가합니다. 이 매개 변수에 대해 지원되는 또 다른 값은 runFromPackage. 값을 지정하지 않으면 auto 기본값입니다.

CI/CD 파이프라인을 만드는 방법을 보여 주는 연습은 빌드 및 Azure FunctionsJava 배포를 참조하세요.

요구 사항

요구 묘사
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 없음
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어떤
settable 변수 어떤
에이전트 버전 2.104.1 이상
작업 범주 전개시키다