AzureCLI@1 - Azure CLI v1 작업
Windows 에이전트에서 실행할 때 Linux 에이전트 또는 일괄 처리 스크립트에서 실행할 때 셸 스크립트에서 Azure 구독에 대해 Azure CLI 명령을 실행합니다.
Azure 구독에 대해 Azure CLI 명령을 사용하여 셸 또는 일괄 처리 스크립트를 실행합니다.
Syntax
# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
inputs:
azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription.
scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
scriptPath: # string. Required when scriptLocation = scriptPath. Script Path.
#inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script.
#arguments: # string. Alias: args. Arguments.
# Advanced
#addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
#useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
#workingDirectory: # string. Alias: cwd. Working Directory.
#failOnStandardError: false # boolean. Fail on Standard Error. Default: false.
# Azure CLI v1
# Run a Shell or Batch script with Azure CLI commands against an azure subscription.
- task: AzureCLI@1
inputs:
azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription.
scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
scriptPath: # string. Required when scriptLocation = scriptPath. Script Path.
#inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script.
#arguments: # string. Alias: args. Arguments.
# Advanced
#workingDirectory: # string. Alias: cwd. Working Directory.
#failOnStandardError: false # boolean. Fail on Standard Error. Default: false.
입력
azureSubscription
- Azure 구독
입력 별칭: connectedServiceNameARM
. string
. 필수 요소.
배포에 대한 Azure Resource Manager 구독을 선택합니다.
scriptLocation
- 스크립트 위치
string
. 필수 요소. 허용되는 값: inlineScript
(인라인 스크립트), scriptPath
(스크립트 경로). 기본값은 scriptPath
입니다.
스크립트 위치를 선택합니다.
scriptPath
- 스크립트 경로
string
. 필요한 경우 scriptLocation = scriptPath
입니다.
스크립트의 정규화된 경로 또는 기본 작업 디렉터리를 기준으로 하는 경로입니다.
inlineScript
- 인라인 스크립트
string
. 필요한 경우 scriptLocation = inlineScript
입니다.
여기에서 스크립트를 인라인으로 작성할 수 있습니다. Windows 에이전트를 사용하는 경우 일괄 처리 스크립팅을 사용합니다. Linux 기반 에이전트를 사용할 때 셸 스크립팅을 사용합니다. 일괄 처리 파일의 경우 모든 Azure 명령 앞에 접두사를 call
사용합니다. 인수를 사용하여 미리 정의된 및 사용자 지정 변수를 이 스크립트에 전달할 수도 있습니다.
다음 예를 참조하십시오. 첫 번째는 셸 예제이고 두 번째는 일괄 처리 예제입니다.
azure --version || azure account show
call azure --version || call azure account show
arguments
- 인수
입력 별칭: args
. string
.
스크립트에 전달된 인수입니다.
addSpnToEnvironment
- 스크립트에서 서비스 주체 세부 정보에 액세스
boolean
. 기본값은 false
입니다.
스크립트의 실행 환경에 선택한 Azure 엔드포인트의 서비스 주체 ID 및 키를 추가합니다. 스크립트에서 $servicePrincipalId
및 $servicePrincipalKey
변수를 사용할 수 있습니다.
이것은 Azure 엔드포인트에 서비스 주체 인증 체계가 있는 경우에만 적용됩니다.
useGlobalConfig
- 전역 Azure CLI 구성 사용
boolean
. 기본값은 false
입니다.
false이면 이 작업은 별도의 Azure CLI 구성 디렉터리를 사용합니다. 병렬 릴리스에서 Azure CLI 작업을 실행하는 데 사용할 수 있습니다.
workingDirectory
- 작업 디렉터리
입력 별칭: cwd
. string
.
스크립트가 실행되는 현재 작업 디렉터리입니다. 비워 두면 이 입력은 리포지토리(빌드) 또는 아티팩트(릴리스)의 루트()입니다 $(System.DefaultWorkingDirectory)
.
failOnStandardError
- 표준 오류 발생 시 실패
boolean
. 기본값은 false
입니다.
이 입력이 true이면 오류가 StandardError 스트림에 기록될 때 이 작업이 실패합니다. 표준 오류를 무시하고 대신 종료 코드를 사용하여 상태 확인란의 선택을 취소합니다.
작업 제어 옵션
모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.
출력 변수
없음
설명
버전 1.0의 새로운 기능:
- Python 기반의 새 Azure CLI 2.0을 지원합니다.
- 플랫폼 간 에이전트(Linux, macOS 또는 Windows)에서 작동
- Azure CLI 1.0(node.js 기반)으로 작업하려면 작업 버전 0.0으로 전환합니다.
- 제한 사항: - Azure 클래식 구독에 대한 지원이 없습니다. Azure CLI 2.0은 ARM(Azure Resource Manager) 구독만 지원합니다.
요구 사항
요구 사항 | Description |
---|---|
파이프라인 유형 | YAML, 클래식 빌드, 클래식 릴리스 |
실행 중 | 에이전트, DeploymentGroup |
요청 | 없음 |
Capabilities | 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다. |
명령 제한 사항 | 모두 |
설정 가능한 변수 | 모두 |
에이전트 버전 | 2.0.0 이상 |
작업 범주 | 배포 |