Azure CLI 구성

아티클
06/05/2024

Azure CLI는 로깅, 데이터 수집 및 기본 인수 값과 같은 설정에 대한 사용자 구성을 허용합니다. CLI는 일부 기본값 az config을 관리하기 위한 편리한 명령과 az init를 통한 대화형 옵션을 제공합니다. 다른 값은 구성 파일 또는 환경 변수를 사용하여 설정할 수 있습니다. 이 문서에서는 이러한 사용자 구성 설정 및 Azure CLI를 구성하는 방법에 대한 추가 정보를 제공합니다.

CLI에서 사용하는 구성 값은 다음 우선 순위에서 평가되며, 목록에서 더 높은 항목이 우선 순위를 차지합니다.

명령줄 매개 변수
환경 변수
az config 또는 az init로 설정된 구성 파일의 값

az init를 사용하여 설정 구성

Azure CLI 구성을 설정하는 가장 쉬운 방법은 대화형 az init 명령을 사용하는 것입니다. "상호 작용" 또는 "자동화"와 같은 일반적인 구성을 선택하거나 개별 구성을 연습하도록 선택합니다. 이 접근 방식에서 특히 유용한 것은 az init가 다른 구성 옵션보다 하나의 구성 옵션을 선택할 수 있는 이유를 제공한다는 것입니다.

az init

az config를 사용하여 설정 구성

az config set 명령으로 CLI에 대한 기본값을 설정할 수 있습니다. 이 명령은 공백으로 구분된 쌍 목록을 key=value 인수로 사용합니다. 제공된 값은 Azure CLI에서 필수 인수 대신 사용됩니다.

다음 표에는 사용 가능한 구성 키 목록이 포함되어 있습니다.

속성	설명
defaults.group	모든 명령에 사용할 기본 리소스 그룹입니다.
defaults.location	모든 명령에 사용할 기본 위치입니다.
defaults.web	명령에 사용할 `az webapp` 기본 앱 이름입니다.
defaults.vm	명령에 사용할 `az vm` 기본 VM 이름입니다.
defaults.vmss	명령에 사용할 `az vmss` 기본 VMSS(가상 머신 확장 집합) 이름입니다.
defaults.acr	`az acr` 명령에 사용할 기본 컨테이너 레지스트리 이름입니다.

예를 들어 모든 명령에 대한 기본 리소스 그룹 및 위치를 설정하는 방법은 다음과 같습니다.

az config set defaults.location=westus2 defaults.group=MyResourceGroup

다음 명령은 Azure CLI 명령을 실행하는 동안 설문 조사 링크를 해제합니다.

az config set output.show_survey_link=no

CLI 구성 파일

CLI 구성 파일에는 CLI 동작을 관리하는 데 사용되는 다른 설정이 포함되어 있습니다. 구성 파일 자체는 .에 있습니다 $AZURE_CONFIG_DIR/config. AZURE_CONFIG_DIR의 기본값은 Linux와 macOS의 경우 $HOME/.azure이고 Windows의 경우 %USERPROFILE%\.azure입니다.

구성 파일은 INI 파일 형식으로 작성됩니다. 섹션 헤더는 파일 형식을 정의한 다음 키-값 항목 목록을 정의합니다.

섹션 머리글은 .로 [section-name]작성됩니다. 섹션 이름은 대/소문자를 구분합니다.
항목은 .로 key=value작성됩니다. 키 이름은 대/소문자를 구분하지 않습니다.
주석은 a 또는 ;.로 # 시작하는 모든 줄입니다. in줄 주석s는 허용되지 않습니다.

부울은 대/소문자를 구분하지 않습니다. 다음 값은 부울을 나타냅니다.

True: 1, yes, true, on
False: 0, no, falseoff

다음은 확인 프롬프트를 비활성화하고 /var/log/azure 디렉토리에 로깅을 설정하는 CLI 구성 파일의 예입니다.

[core]
disable_confirm_prompt=Yes

[logging]
enable_log_file=yes
log_dir=/var/log/azure

사용 가능한 모든 구성 값과 해당 값의 의미에 대한 자세한 내용은 다음 섹션을 참조하세요. INI 파일 형식에 대한 자세한 내용은 INI의 Python 설명서를 참조하세요.

CLI 구성 값 및 환경 변수

다음 표에는 구성 파일에 배치할 수 있는 모든 섹션 및 옵션 이름이 포함되어 있습니다. 해당 환경 변수는 모든 대문자로 AZURE_{section}_{name}설정됩니다. 예를 들어 output 기본값 core 은 변수에 AZURE_CORE_OUTPUT 설정되고, storage_account 기본값 batchai 은 변수에 AZURE_BATCHAI_STORAGE_ACCOUNT 설정되고, 기본값 location 은 변수에 AZURE_DEFAULTS_LOCATION 설정됩니다.

기본값을 제공하는 경우 해당 인수는 더 이상 명령에서 필요하지 않습니다. 대신 기본값이 사용됩니다.

섹션	속성	형식	설명
코어	output	string	기본 출력 형식입니다. 허용되는 값: `json` (기본값), `jsonc`, `yaml`, `yamlctable`, `tsv`. `none` 자세한 내용은 Azure CLI 명령의 출력 형식을 참조하세요.
	disable_confirm_prompt	부울 값	확인 프롬프트를 켜거나 끕니다.
	display_region_identified	부울 값	Azure 고객은 다양한 지역에 리소스를 배포하도록 선택할 수 있습니다. 경우에 따라 고객은 동일한 서비스를 제공하는 인근 지역을 선택하여 비용을 절감할 수 있습니다. 주변 지역이 식별되면 향후 배포를 위해 선택할 지역이 표시됩니다. 이 설정은 메시지가 표시되는지 제어합니다.
	collect_telemetry	부울 값	Microsoft가 CLI 사용에 대한 익명 데이터를 수집할 수 있도록 허용합니다. 개인 정보에 대한 자세한 내용은 Azure CLI MIT 라이선스를 참조하세요.
	only_show_errors	부울 값	명령 호출 중 오류만 표시합니다. 즉, 오류만 에 기록 `stderr`됩니다. 미리 보기, 사용되지 않는 명령 및 실험적 명령의 경고를 표시하지 않습니다. 매개 변수를 사용하는 개별 명령에 `--only-show-errors` 도 사용할 수 있습니다.
	enable_broker_on_windows	부울 값	WAM(웹 계정 관리자)을 사용하여 명령을 통해 Azure에 인증합니다 `az login` .
	login_experience_v2	부울 값	`az login` 구독 선택기를 켜거나 끕니다.
	no_color	부울 값	색을 사용하지 않도록 설정합니다. 원래 색이 지정된 메시지에는 접두사 , `DEBUGINFOWARNING` 및 .`ERROR` 이 부울은 리디렉션 후에 `stdout` 터미널의 색이 다시 되돌리기 수 없는 타사 라이브러리의 문제를 무시합니다.
클라이언트	show_secrets_warning	부울 값	중요한 정보 출력에 대한 경고를 켜거나 끕니다.
로깅	enable_log_file	부울 값	로깅을 켜거나 끕니다.
	log_dir	string	로그를 쓸 디렉터리입니다. 이 값은 기본적으로 `${AZURE_CONFIG_DIR}/logs*`입니다.
기본값	group	string	모든 명령에 사용할 기본 리소스 그룹입니다.
	location	string	모든 명령에 사용할 기본 위치입니다.
	web	string	명령에 사용할 `az webapp` 기본 앱 이름입니다.
	VM	string	명령에 사용할 `az vm` 기본 VM 이름입니다.
	vmss	string	명령에 사용할 `az vmss` 기본 VMSS(가상 머신 확장 집합) 이름입니다.
	Acr	string	`az acr` 명령에 사용할 기본 컨테이너 레지스트리 이름입니다.
storage	거래처	string	데이터 평면 명령에 사용할 `az storage` 기본 스토리지 계정 이름(`az storage container list`예: mystorageaccount in`https://mystorageaccount.blob.core.windows.net`)입니다.
	key	string	`az storage` 데이터 평면 명령에 사용할 기본 액세스 키입니다.
	sas_token	string	데이터 평면 명령에 사용할 `az storage` 기본 SAS 토큰입니다.
	connection_string	string	데이터 평면 명령에 사용할 `az storage` 기본 연결 문자열.
batchai	storage_account	string	명령에 사용할 `az batchai` 기본 스토리지 계정입니다.
	storage_key	string	명령에 사용할 `az batchai` 기본 스토리지 키입니다.
배치	거래처	string	명령에 사용할 `az batch` 기본 Azure Batch 계정 이름입니다.
	access_key	string	`az batch` 명령에 사용할 기본 액세스 키입니다. `aad` 권한 부여와 함께 사용됩니다.
	endpoint	string	명령에 연결할 `az batch` 기본 엔드포인트입니다.
	auth_mode	string	명령에 사용할 `az batch` 권한 부여 모드입니다. 허용되는 값: `shared_key`, `aad`.
클라우드	name	string	모든 `az` 명령에 대한 기본 클라우드입니다. 허용되는 값: `AzureCloud` (기본값), `AzureChinaCloud`. `AzureUSGovernment` 클라우드를 변경하려면 이 명령을 사용할 `az cloud set –name` 수 있습니다. 예를 들어 Azure CLI를 사용하여 클라우드 관리를 참조하세요.
확장	use_dynamic_install	string	확장을 실행할 때 아직 추가되지 않은 경우 확장을 설치합니다. 허용되는 값: `no` (기본값), `yes_prompt`. `yes_without_prompt`
	run_after_dynamic_install	부울 값	확장이 동적으로 설치될 때 명령을 계속 실행합니다. 기본값은 `False`입니다.
	index_url	string	index.json 형식을 따르는 프라이빗 확장 인덱스 파일의 URL입니다. 지정되면 실행은 `az extension add --name <extension-name>` 해당 파일을 사용하여 추가할 확장자를 찾습니다.

참고 항목

구성 파일에 다른 값이 표시되기는 하지만 이러한 값은 CLI 명령을 통해 직접 관리됩니다(예 az config: ). 이전에 표에 나열된 값은 직접 변경해야 하는 유일한 값입니다.

다음을 통해 공유

Azure CLI 구성

az init를 사용하여 설정 구성

az config를 사용하여 설정 구성

CLI 구성 파일

CLI 구성 값 및 환경 변수

추가 리소스