Azure 개발자 CLI는 Azure 리소스 배포 및 프로비저닝을 간소화하는 강력한 템플릿 시스템을 중심으로 설계되었습니다. 개발하는 azd동안 고유한 템플릿을 빌드하거나 구성 가능한 기존 템플릿 목록에서 선택할 수 있습니다. 이 문서에서는 템플릿 목록을 사용하고 다른 템플릿 목록 원본을 지원하도록 로컬 azd 설치를 구성하는 방법을 알아봅니다.
템플릿 원본 이해
azd 템플릿 원본은 사용 가능한 템플릿 목록과 템플릿 소스 코드의 이름, 설명 및 위치(일반적으로 GitHub 리포지토리)와 같은 필수 메타데이터 목록을 설명하는 JSON 구성 파일을 가리킵니다. 템플릿 원본을 사용하도록 설정하면 템플릿이 정의하는 템플릿을 다른 명령을 통해 사용할 수 있게 azd 됩니다. 예를 들어 아래 템플릿 원본 JSON 코드 조각은 두 개의 템플릿을 정의합니다.
[
{
"name": "Starter - Bicep",
"description": "A starter template with Bicep as infrastructure provider",
"repositoryPath": "azd-starter-bicep",
"tags": ["bicep"]
},
{
"name": "Starter - Terraform",
"description": "A starter template with Terraform as infrastructure provider",
"repositoryPath": "azd-starter-terraform",
"tags": ["terraform"]
}
]
JSON 구성 파일의 각 템플릿 항목에는 다음 속성이 포함됩니다.
- 이름: 템플릿의 표시 이름입니다.
- 설명: 템플릿이 수행하는 작업을 간략하게 요약합니다.
-
repositoryPath: 템플릿의 소스 코드에 대한 경로입니다. 이 경로는 다음과 같습니다.
- Git 리포지토리에 대한 정규화된 URI(예: "https://dev.azure.com/org/project/_git/repo")입니다.
- GitHub 리포지토리에서 사용되는 "{owner}/{repo}" 형식.
- Azure-Samples 조직의 GitHub 리포지토리에 대한 "{repo}"입니다.
-
태그: 사용자가
azd init --filter <tag>와azd template list --filter <tag>을 사용하여 템플릿을 필터링하는 데 도움이 되는 키워드입니다.
전체 예제를 보려면 이 JSON 파일을 참조하세요. 이는 azd에 포함된 기본 템플릿 소스입니다.
azd 사용하면 한 번에 여러 템플릿 원본을 사용하도록 설정할 수 있습니다. 현재 선택할 수 있는 템플릿 원본 옵션은 다음과 같습니다.
- awesome-azd - 기본적으로 사용하도록 설정되는 Awesome AZD 갤러리의 템플릿 목록입니다.
- default - 다양한 기술 스택을 보여 주는 큐레이팅된 템플릿의 작은 집합입니다.
- file - 템플릿 원본 JSON 구성 파일을 가리키는 로컬/네트워크 경로입니다.
- url - 템플릿 원본 JSON 구성 파일을 가리키는 HTTP(S) 주소 지정 가능 경로입니다.
- gh - GitHub 리포지토리를 가리킵니다.
- ade - Azure 배포 환경 템플릿 목록을 가리킵니다 . Azure 배포 환경에 대한 Azure 개발자 CLI 지원에 대해 자세히 알아봅니다.
템플릿 원본 작업
azd 에서는 템플릿 원본을 구성하는 몇 가지 명령을 제공합니다.
명령을 azd template source list 사용하여 현재 구성된 모든 템플릿 원본을 나열합니다.
azd template source list
구성된 두 템플릿 원본이 있는 예제 출력:
Key Name Type Location
awesome-azd Awesome AZD awesome-azd https://aka.ms/awesome-azd/templates.json
default Default resource
명령을 azd template source add 사용하여 새 템플릿 원본을 추가합니다. 이 명령은 다음 매개 변수를 허용합니다.
- key: 템플릿 원본의 기술 이름입니다.
- --type, -t: 템플릿 원본 유형 - 유효한 값은 GitHub의 파일, URL 및 gh입니다.
- --location, -l: 로컬 네트워크 또는 HTTP(S) 웹 URI여야 하는 템플릿 원본 위치입니다.
- --name, -n: 템플릿 원본 출력 이름입니다(선택 사항, 생략된 경우 키 사용).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>
azd template source remove 명령을 사용하여 템플릿 원본을 제거합니다.
azd template source remove <key>
azd config reset 명령을 사용하여 템플릿 구성을 기본 설정으로 다시 설정합니다.
azd config reset
템플릿 목록 작업
템플릿 원본을 구성한 후 명령을 사용하여 azd template list 해당 원본에서 사용 가능한 템플릿을 나열합니다.
azd template list
예를 들어 기본 설치 azd 는 awesome-azd 템플릿 원본의 다음 템플릿을 나열합니다.
Name Source Repository Path
Event Driven Java Application with Azure Service Bus Awesome AZD Azure-Samples/ASA-Samples-Event-Driven-Application
Static React Web App with Java API and PostgreSQL Awesome AZD Azure-Samples/ASA-Samples-Web-Application
SAP CAP on Azure App Service Quickstart Awesome AZD Azure-Samples/app-service-javascript-sap-cap-quickstart
SAP Cloud SDK on Azure App Service Quickstart (TypeScript) Awesome AZD Azure-Samples/app-service-javascript-sap-cloud-sdk-quickstart
Java Spring Apps with Azure OpenAI Awesome AZD Azure-Samples/app-templates-java-openai-springapps
WordPress with Azure Container Apps Awesome AZD Azure-Samples/apptemplate-wordpress-on-ACA
Bicep template to bootstrap Azure Deployment Environments Awesome AZD Azure-Samples/azd-deployment-environments
Starter - Bicep Awesome AZD Azure-Samples/azd-starter-bicep
Starter - Terraform Awesome AZD Azure-Samples/azd-starter-terraform
...
# Additional templates omitted
특정 원본의 --source 템플릿만 나열하는 플래그를 포함합니다.
azd template list --source <source-name>
표시된 목록에서 템플릿을 초기화하려면 azd init 명령을 실행하고 템플릿의 리포지토리 경로를 제공합니다.
azd init --template <path-value>
Azure 배포 환경 작업
Azure 개발자 CLI(azd)는 Azure 배포 환경에 대한 지원도 제공합니다. ADE(Azure 배포 환경)는 미리 정의된 구독에 배포된 Azure 리소스의 미리 구성된 컬렉션입니다. Azure 거버넌스는 샌드박스, 테스트, 스테이징 또는 프로덕션과 같은 환경 유형에 따라 해당 구독에 적용됩니다. Azure 배포 환경을 사용하면 엔터프라이즈 보안 정책을 적용하고 IaC(미리 정의된 인프라) 템플릿으로 큐레이팅된 집합을 제공할 수 있습니다.
ADE 통합은 이 문서의 범위를 벗어납니다. Azure 배포 환경에 대한 Azure 개발자 CLI 지원 설명서에서 지원을 구성하는 방법에 ade 대해 자세히 알아봅니다.