Azure 개발자 CLI(azd)를 사용하면 azd 명령 집합을 사용하여 azd config 구성을 관리할 수 있습니다. 이러한 구성 설정에는 Azure 구독 및 위치와 같은 유용한 기본값과 다른 azd 명령 또는 기능에서 사용하는 설정이 포함됩니다. 사용자 고유의 사용자 지정 값을 가져와서 설정하고 스크립트 또는 사용자 지정 기능에서 사용할 수도 있습니다.
이 문서에서는 다음에 대해 알아봅니다.
- Azure 개발자 CLI 구성에 대한 주요 개념
-
azd config명령으로 작업하는 방법 -
azd가 다른azd config기능과 통합되는 방식
Azure 개발자 CLI 구성 파일 살펴보기
Azure Developer CLI를 처음 설치하면 이름이 지정된 config.json 파일이 다음 위치에 추가됩니다.
-
$HOME/.azdLinux 및 macOS에서 - Windows
%USERPROFILE%\.azd
Tip
AZD_CONFIG_DIR 환경 변수에 경로를 지정하여 구성 디렉터리를 재정의할 수 있습니다.
이 파일의 설정은 다음과 같은 기능을 관리합니다.
- 리소스를 프로비전하거나 배포할 때 사용할 기본 Azure 구독 또는 위치
- 어떤 알파 기능이 활성화되어 있나요?
- 구성된 템플릿 원본 위치는 어떤 것입니까
- 스크립트 또는 기타 용도로 사용자가 설정한 사용자 지정 값
기본적으로 config.json 파일에는 기본 azd 템플릿 원본 위치에 대한 몇 가지 구성만 포함됩니다. Azure Developer CLI의 다양한 기능을 사용하면 일부 값이 자동으로 채워집니다config.json. 예를 들어, azd up 명령을 처음 실행할 때 프로비전 및 배포를 위해 선택한 구독 및 위치가 파일의 defaults 섹션에 저장됩니다.
간단한 config.json 파일은 다음과 유사할 수 있습니다.
{
"defaults": {
"location": "eastus2",
"subscription": "your-subscription-id"
},
"template": {
"sources": {
"awesome-azd": {
"key": "awesome-azd",
"location": "https://aka.ms/awesome-azd/templates.json",
"name": "Awesome AZD",
"type": "awesome-azd"
},
"default": {
"key": "default",
"name": "default"
}
}
}
}
구성 명령 작업
Azure 개발자 CLI는 config.json 파일의 설정을 수동으로 관리할 수 있는 일련의 명령을 제공합니다:
-
azd config get: 구성 값을 가져옵니다. -
azd config list-alpha: 알파 단계에서 사용 가능한 기능 목록을 표시합니다. -
azd config reset: 구성을 기본값으로 다시 설정합니다. -
azd config set: 구성을 설정합니다. -
azd config show: 모든 구성 값을 표시합니다. -
azd config unset: 구성을 설정 해제합니다.
이러한 명령은 다음 섹션에서 자세히 설명합니다.
Azure 개발자 CLI 명령 참조 페이지를 방문하여 명령에 대해 azd 자세히 알아볼 수도 있습니다.
디스플레이 구성
명령을 실행하여 언제든지 전체 config.json 파일의 현재 내용을 봅니다 azd config show .
azd config show
샘플 출력:
{
"defaults": {
"location": "eastus2",
"subscription": "your-subscription-id"
},
"template": {
"sources": {
"awesome-azd": {
"key": "awesome-azd",
"location": "https://aka.ms/awesome-azd/templates.json",
"name": "Awesome AZD",
"type": "awesome-azd"
},
"default": {
"key": "default",
"name": "default"
}
}
}
}
다음 명령을 사용하여 특정 구성 값을 표시합니다 azd config get <key> .
azd config get defaults
샘플 출력:
"defaults": {
"location": "eastus2",
"subscription": "your-subscription-id"
}
알파 기능을 사용하거나 사용하지 않도록 설정하는 것은 일반적인 구성 작업이므로 azd 알파 기능의 현재 상태를 보는 편리한 명령도 포함됩니다.
azd config list-alpha
샘플 출력:
Name: aca.persistDomains
Description: Do not change custom domains when deploying Azure Container Apps.
Status: Off
Name: aca.persistIngressSessionAffinity
Description: Do not change Ingress Session Affinity when deploying Azure Container Apps.
Status: Off
Name: aks.helm
Description: Enable Helm support for AKS deployments.
Status: On
Name: aks.kustomize
Description: Enable Kustomize support for AKS deployments.
Status: Off
Name: azd.operations
Description: Extends provisioning providers with azd operations.
Status: Off
Name: deployment.stacks
Description: Enables Azure deployment stacks for ARM/Bicep based deployments.
Status: Off
Name: llm
Description: Enables the use of LLMs in the CLI.
Status: Off
구성 가져오기 및 설정
config.json 명령을 사용하여 azd config 파일에서 값을 가져오거나, 설정하거나, 설정을 해제할 수 있습니다. 알파 기능을 사용하도록 설정하거나 템플릿 원본을 설정하는 경우와 같은 일부 특정 구성은 다른 azd 기능 및 명령에서 사용되지만 사용자 고유의 사용자 지정 값을 설정할 수도 있습니다.
azd에서 사용하는 구성 관리
azd config set <key> <value> 명령을 사용하여 config.json 파일에 구성 설정을 추가합니다.
예를 들어 GitHub Copilot 통합에서 사용하는 LLM 기능을 사용하도록 설정하려면 다음을 수행합니다.
azd config set alpha.llm on
비고
azd init 중에 GitHub Copilot(미리 보기)로 설정을 선택하면 이 설정이 자동으로 활성화됩니다. 구성 값을 가져오고 설정할 때 . 구문을 사용하여 JSON 개체 구조를 탐색합니다.
다음과 같은 명령을 사용하여 azd config get <key> 설정을 사용하도록 설정했는지 확인합니다.
azd config get alpha.llm
샘플 출력:
"on"
이 시나리오에서는 config.json를 실행하여 azd config get alpha 파일의 전체 JSON 개체를 볼 수도 있습니다:
azd config get alpha
샘플 출력:
{
"llm": "on"
}
사용자 지정 구성 관리
azd 후크 및 고객 스크립트에서 사용할 사용자 지정 구성 값을 설정할 수도 있습니다. 이러한 구성 값은 환경 변수를 사용하는 대신 사용할 수 있습니다.
사용자 지정 구성 값을 설정하려면 다음을 수행합니다.
azd config get customVal hello-world
사용자 지정 구성 값을 가져옵니다.
azd config get customVal
샘플 출력:
hello-world
구성 다시 설정
Azure 개발자 CLI config.json 파일을 파일의 내용을 삭제하는 명령을 사용하여 azd config reset 기본값으로 다시 설정할 수 있습니다.
azd config reset
다시 설정 후 실행 azd config show 하면 빈 개체만 표시됩니다.
{}