AzureCLI@1 - Azure CLI v1 작업
Windows 에이전트에서 실행할 때 Linux 에이전트 또는 일괄 처리 스크립트에서 실행할 때 셸 스크립트에서 Azure 구독에 대해 Azure CLI 명령을 실행합니다.
구문론
# 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 구독
입력 별칭: 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) 구독만 지원합니다.