Azure 개발자 CLI(azd) 템플릿 개발 개요

Azure 개발자 CLI(azd) 템플릿은 Azure 솔루션을 프로비전하고 배포하는 데 필요한 구성, 인프라 및 선택적 애플리케이션 코드를 패키지합니다. 애플리케이션에 대한 템플릿, 인프라 전용 프로젝트 또는 향후 프로젝트에 재사용 가능한 시작점을 사용할 수 있습니다.

Note

시작하기 전에 템플릿 구조, 필수 및 선택적 자산, 서비스-리소스 연결 및 명령이 각 파일을 사용하는 방법에 azd 대한 전체 설명을 보려면 Azure 개발자 CLI 템플릿을 읽어보십시오.

템플릿 개발 워크플로

다음 워크플로는 템플릿을 만들거나 이미 존재하는 템플릿을 초기화하는지 여부에 관계없이 적용됩니다.

시작점 선택부터 azd up 실행 및 템플릿 유지 관리까지 azd 템플릿 개발 워크플로의 다이어그램

  • 시작점 선택: GitHub Copilot 통합, 다른 AI 코딩 도우미 또는 직접 작성을 사용하여 새 템플릿으로 시작합니다. 또는 Microsoft, 조직 또는 개발자 커뮤니티의 기존 템플릿에서 시작합니다.
  • 파일을 탐색하고 편집합니다. , Bicep 또는 Terraform 파일, 앱 코드 및 지원 구성이 함께 작동하는 방식을 azure.yaml검토합니다. 템플릿 파일 탐색 및 편집을 참조하세요.
  • 필요에 따라 확장하고 발전합니다. 앱 및 인프라 구성 요소를 추가, 바꾸기, 제거 또는 다시 디자인합니다. Azure 리소스를 추가하고 앱에 연결하는 엔드 투 엔드 예제에 대한 템플릿 확장에 따릅니다.
  • 프로비전 및 배포: 실행 azd up 하여 인프라를 프로비전하고 모든 앱 서비스를 배포합니다. 자세한 내용은 워크플로 탐색을 azd up 참조하세요.
  • 유지 관리 또는 공유: 프로젝트가 발전함에 따라 템플릿을 계속 편집합니다. 공유하려는 경우 먼저 클린 디렉터리와 새 azd 환경에서 테스트합니다.

Note

이 워크플로 전체에서 직접 또는 AI 코딩 도우미의 도움을 받아 템플릿 파일을 만들거나 편집하거나 바꿀 수 있습니다. 결과는 편집 가능한 azd 표준 자산 집합과 동일합니다.

템플릿 구성 요소

모든 azd 템플릿은 다른 솔루션을 지원하지만 대부분의 템플릿은 동일한 유형의 자산을 결합합니다.

  • Project 구성: 파일은 azure.yaml project, 배포 가능한 서비스, 원본 디렉터리, 호스팅 대상 및 선택적 후크 또는 워크플로를 식별합니다.
  • 코드로서의 인프라: Bicep 또는 Terraform 파일은 솔루션에 필요한 Azure 리소스, 역할 할당, 네트워킹 및 앱 설정을 정의합니다.
  • 애플리케이션 원본: 템플릿은 하나 이상의 배포 가능한 앱을 포함하거나 인프라만 포함할 수 있습니다.
  • 환경 구성: 매개 변수는 환경별 값을 배포에 전달하고 인프라 출력은 활성 azd 환경에서 값이 됩니다.

앱의 템플릿은 다음 폴더 구조를 사용할 수 있습니다.

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

정확한 구조는 프로젝트에 따라 다릅니다. 앱 원본, 인프라 모듈 및 파이프라인 파일은 선택 사항이며 azure.yaml 사용하는 경로를 식별합니다 azd . 이러한 자산은 템플릿 개발 수명 주기 내내 함께 작동합니다.

다음 단계

새 템플릿 시작

도움말 요청

버그를 제출하거나, 도움말을 요청하거나, Azure 개발자 CLI에 대한 새 기능을 제안하는 방법에 대한 자세한 내용은 troubleshooting and support 페이지를 방문하세요.

  • Last updated on