다음을 통해 공유


Azure CLI 구성

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

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

  1. 명령줄 매개 변수
  2. 환경 변수
  3. 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 파일 형식에 대한 자세한 내용은 INIPython 설명서를 참조하세요.

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 inhttps://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: ). 이전에 표에 나열된 값은 직접 변경해야 하는 유일한 값입니다.