AzureSpringCloud@0 - Azure Spring Apps v0 작업

이 작업은 Azure Spring Apps에 애플리케이션을 배포하고 해당 배포를 관리합니다.

중요

이 작업은 Azure Spring Apps 기본/표준 및 엔터프라이즈 계획에서 지원됩니다. 자세한 내용은 Azure Spring Apps에 애플리케이션 배포 자동화를 참조하세요.

Syntax

# Azure Spring Apps v0
# Deploy applications to Azure Spring Apps and manage deployments.
- task: AzureSpringCloud@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    Action: 'Deploy' # 'Deploy' | 'Set Production' | 'Delete Staging Deployment'. Required. Action. Default: Deploy.
    AzureSpringCloud: # string. Required. Azure Spring Apps Name. 
    AppName: # string. Required. App. 
    #DeploymentType: 'Artifacts' # 'Artifacts' | 'CustomContainer'. Optional. Use when Action = Deploy. Deployment Type. Default: Artifacts.
    #UseStagingDeployment: true # boolean. Optional. Use when Action = Deploy || Action = Set Production. Use Staging Deployment. Default: true.
    #CreateNewDeployment: false # boolean. Optional. Use when Action = Deploy && UseStagingDeployment = false. Create a new staging deployment if one does not exist. Default: false.
    #DeploymentName: # string. Optional. Use when UseStagingDeployment = false && Action != Delete Staging Deployment. Deployment. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.jar' # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.jar.
    #RegistryServer: 'docker.io' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Server. Default: docker.io.
    #RegistryUsername: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Username. 
    #RegistryPassword: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Password. 
    #ImageName: 'hello-world:v1' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Name and Tag. Default: hello-world:v1.
    #ImageCommand: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Command. 
    #ImageArgs: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Arguments. 
    #ImageLanguageFramework: # 'springboot'. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Language Framework. 
  # Application and Configuration Settings
    #Builder: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Builder. 
    #EnvironmentVariables: # string. Optional. Use when Action = Deploy. Environment Variables. 
    #JvmOptions: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. JVM Options. 
    #RuntimeVersion: 'Java_11' # 'Java_8' | 'Java_11' | 'Java_17' | 'Java_21' | 'NetCore_31'. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Runtime Version. Default: Java_11.
    #DotNetCoreMainEntryPath: # string. Optional. Use when RuntimeVersion = NetCore_31. Main Entry Path. 
    #Version: # string. Optional. Use when Action = Deploy. Version.

입력

azureSubscription - Azure 구독
입력 별칭: ConnectedServiceName. string. 필수 요소.

배포에 대한 Azure Resource Manager 구독을 지정합니다.

Action - 작업
string. 필수 요소. 허용되는 값: Deploy, Set Production (프로덕션 배포 설정), Delete Staging Deployment. 기본값은 Deploy입니다.

Azure Spring Apps에서 수행할 작업입니다.

AzureSpringCloud - Azure Spring Apps 이름
string. 필수 요소.

배포할 Azure Spring Apps instance 이름 또는 리소스 ID입니다.

AppName - 앱
string. 필수 요소.

배포할 Azure Spring Apps 앱의 이름입니다. 작업 실행 전에 앱이 있어야 합니다.

DeploymentType - 배포 유형
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy를 사용합니다. 허용되는 값: Artifacts, CustomContainer (사용자 지정 컨테이너). 기본값은 Artifacts입니다.

소스 코드 또는 Java 패키지를 사용하여 배포하려면 "아티팩트"를 선택합니다. 컨테이너 이미지를 사용하여 배포하려면 "사용자 지정 컨테이너"를 선택합니다.

UseStagingDeployment - 스테이징 배포 사용
boolean. 선택 사항입니다. 를 사용하는 경우 Action = Deploy || Action = Set Production를 사용합니다. 기본값은 true입니다.

작업이 실행되면 이 입력은 로 staging설정된 배포를 자동으로 선택합니다.

로 true설정된 경우 실행 시 준비 배포로 설정된 배포 에 작업을 적용합니다. 생략하면 매개 변수를 DeploymentName 설정해야 합니다.

CreateNewDeployment - 새 스테이징 배포가 없는 경우 만듭니다.
boolean. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && UseStagingDeployment = false를 사용합니다. 기본값은 false입니다.

로 true설정하고 에서 지정한 DeploymentName 배포가 실행 시 존재하지 않는 경우 생성됩니다. 생략하면 매개 변수를 DeploymentName 설정해야 합니다.

DeploymentName - 배포
string. 선택 사항입니다. 를 사용하는 경우 UseStagingDeployment = false && Action != Delete Staging Deployment를 사용합니다.

이 작업이 적용될 배포 입니다. 파란색-녹색 배포를 사용하지 않는 경우 이 필드를 로 default설정합니다. 값은 문자로 시작해야 하며 소문자와 숫자로만 구성되어야 합니다.

Package - 패키지 또는 폴더
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = Artifacts를 사용합니다. 기본값은 $(System.DefaultWorkingDirectory)/**/*.jar입니다.

Azure Spring Apps 앱 콘텐츠(Java용 파일, .zip .NET Core의 경우)가.jar 포함된 패키지 또는 폴더의 파일 경로입니다.
변수( 빌드 | 릴리스) 및 와일드카드가 지원됩니다.
예를 들어 $(System.DefaultWorkingDirectory)/**/*.jar

Builder - 작성기
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = Artifacts를 사용합니다.

엔터프라이즈 계층에서 사용할 수 있는 VMware Tanzu® Build Service™의 작성자를 선택합니다.
자세한 설명은 Tanzu Build Service 사용을 검사.

RegistryServer - 레지스트리 서버
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = CustomContainer를 사용합니다. 기본값은 docker.io입니다.

컨테이너 이미지의 레지스트리입니다. 기본값: docker.io.

RegistryUsername - 레지스트리 사용자 이름
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = CustomContainer를 사용합니다.

컨테이너 레지스트리의 사용자 이름입니다.

RegistryPassword - 레지스트리 암호
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = CustomContainer를 사용합니다.

컨테이너 레지스트리의 암호입니다.

ImageName - 이미지 이름 및 태그
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = CustomContainer를 사용합니다. 기본값은 hello-world:v1입니다.

컨테이너 이미지 태그입니다.

ImageCommand - 이미지 명령
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = CustomContainer를 사용합니다.

컨테이너 이미지의 명령입니다.

ImageArgs - 이미지 인수
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = CustomContainer를 사용합니다.

컨테이너 이미지의 인수입니다.

ImageLanguageFramework - Language Framework
string. 선택 사항입니다. 를 사용하는 경우 Action = Deploy && DeploymentType = CustomContainer를 사용합니다. 허용되는 값: springboot.

EnvironmentVariables - 환경 변수
string. 선택 사항입니다. 을 사용할 때 Action = Deploy사용합니다.

구문을 -key value 사용하여 입력할 환경 변수입니다(예: -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). 공백이 포함된 값은 큰따옴표로 묶어야 합니다(예: "Eastern Standard Time").

JvmOptions - JVM 옵션
string. 선택 사항입니다. 을 사용할 때 Action = Deploy && DeploymentType = Artifacts사용합니다.

앱의 JVM 옵션을 편집합니다. JVM 옵션을 포함하는 문자열(예: -Xms1024m -Xmx2048m)입니다.

RuntimeVersion - 런타임 버전
string. 선택 사항입니다. 을 사용할 때 Action = Deploy && DeploymentType = Artifacts사용합니다. 허용되는 값: Java_8 (Java 8), Java_11 (Java 11), Java_17 (Java 17), Java_21 (Java 21), NetCore_31 (.NET Core 3.1). 기본값은 Java_11입니다.

앱이 실행될 런타임 버전입니다.

DotNetCoreMainEntryPath - 기본 진입 경로
string. 선택 사항입니다. 을 사용할 때 RuntimeVersion = NetCore_31사용합니다.

zip 루트를 기준으로 하는 .NET 실행 파일의 경로입니다.

Version - 버전
string. 선택 사항입니다. 을 사용할 때 Action = Deploy사용합니다.

배포 버전입니다. 설정하지 않으면 버전이 변경되지 않은 상태로 유지됩니다.

작업 제어 옵션

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

출력 변수

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

testEndpoint
'배포' 작업 후에만 수행합니다. 업데이트된 배포에 액세스하기 위한 프라이빗 URL을 포함합니다.

설명

이 작업을 사용하여 Azure Spring Apps 에 애플리케이션을 배포하고 Azure Spring Cloud 배포를 관리합니다.

중요

이 작업은 Azure Spring Apps 기본/표준 및 엔터프라이즈 계획에서 지원됩니다. 자세한 내용은 Azure Spring Apps에 애플리케이션 배포 자동화를 참조하세요.

예제

다음 예제는 일반적인 사용 시나리오를 보여줍니다. 자세한 내용은 Azure Spring Apps에 애플리케이션 배포 자동화를 참조하세요.

스테이징 배포 삭제

"스테이징 배포 삭제" 작업을 사용하면 프로덕션 트래픽을 수신하지 않는 배포를 삭제할 수 있습니다. 이렇게 하면 배포에 사용된 리소스를 비우고 새 스테이징 배포를 위해 공간을 확보할 수 있습니다.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
  continueOnError: true # Don't fail the pipeline if a staging deployment doesn't already exist.
  inputs:
    continueOnError: true
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Delete Staging Deployment'
    AppName: customer-api
    AzureSpringCloud: contoso-dev-az-spr-cld

배포 중

프로덕션으로

다음 예제에서는 Azure Spring Apps의 기본 프로덕션 배포에 배포합니다. 기본 SKU를 사용할 때 가능한 유일한 배포 시나리오입니다.

참고

패키지 검색 패턴은 정확히 하나의 패키지만 반환해야 합니다. 빌드 작업에서 sources.jar 및 javadoc.jar 같은 여러 JAR 패키지가 생성되는 경우에는 애플리케이션 이진 아티팩트와만 일치하도록 검색 패턴을 구체화해야 합니다.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: false
    DeploymentName: default
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

파란색-녹색

다음 예제에서는 기존 스테이징 배포에 배포합니다. 이 배포는 프로덕션 배포로 설정될 때까지 프로덕션 트래픽을 수신하지 않습니다.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

대체 방법을 포함하여 파란색-녹색 배포에 대한 자세한 내용은 파란색-녹색 배포 전략을 참조하세요.

프로덕션 배포 설정

다음 예제에서는 현재 스테이징 배포를 프로덕션으로 설정하여 프로덕션 트래픽을 수신하는 배포를 효과적으로 교환합니다.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Set Production'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	에이전트, DeploymentGroup
요청	없음
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	모두
설정 가능한 변수	모두
에이전트 버전	2.104.1 이상
작업 범주	배포