템플릿 구조체 만들기

완료됨

Azure Developer CLI(azd)는 azd init 명령 및 시작 템플릿을 사용하여 앱의 새 템플릿을 빌드하는 데 도움이 됩니다. 이 단원에서는 모듈의 나머지 부분에 대해 빌드할 새 템플릿의 기본 스캐폴딩 또는 구조체를 만듭니다.

  1. 로컬 머신의 빈 디렉터리에서 azd init 명령을 실행합니다.

    azd init
    
  2. 명령 출력에는 azd 템플릿을 초기화하기 위한 세 가지 선택 항목이 표시됩니다.

  • 현재 디렉터리코드 사용: 앱 코드를 분석하여 특정 템플릿 자산을 만들고 구성합니다.

  • 템플릿선택: 필수 폴더 구조, 시작 인프라를 코드 파일로, 기타 상용구 구성 파일을 포함하는 기존 시작 템플릿을 선택하여 템플릿 빌드를 간소화합니다.

  • 최소 프로젝트만들기: 시작할 최소 구성 파일을 생성합니다.

    Azure 개발자 CLI 템플릿 만들기 개요 설명서에서 이러한 다양한 선택에 대해 자세히 알아보세요.

  1. 템플릿 옵션을 선택하면 azd는 미리 구성된 사용 가능한 템플릿 목록을 표시합니다.

  2. 결과 목록에서 Starter를 검색한 다음, Starter - Bicep 옵션을 선택합니다. Azure Developer CLI는 해당 옵션을 원하는 경우 Terraform 사용도 지원합니다. Terraform 지원은 현재 알파 버전이며 수동으로 사용하도록 설정해야 합니다.

  3. 환경 이름을 묻는 메시지가 표시되면 azdlearn 또는 선택한 이름을 입력합니다. 환경 이름은 Azure에서의 프로비전한 리소스 이름 지정에 영향을 줍니다.

  4. 폴더 집합은 현재 디렉터리 내에 만들어집니다.

    시작 템플릿 구조체

참고 항목

azd init 명령은 가능한 가장 간단한 템플릿 구조를 포함하는 Minimal이라는 프로젝트 템플릿도 제공하는 것을 확인할 수 있습니다. 그러나 선택한 Starter - Bicep 템플릿에는 매우 유용하지만 여전히 기술에 구애받지 않는 추가 스캐폴딩 코드가 포함되어 있으므로 시작하기에 좋은 선택인 경우가 많습니다.

생성된 폴더는 azd 템플릿의 모든 필수 구성 요소를 제공합니다.

  • .azure - 환경 이름과 같이 템플릿의 Azure 환경에 대한 필수 설정을 포함하는 폴더입니다.
  • .devcontainer - 개발 컨테이너 환경에서 템플릿을 실행하는 데 사용되는 구성 파일이 포함된 폴더입니다.
  • infra - 템플릿의 IaC(Infrastructure as code)에 대한 시작 Bicep 파일을 포함하는 폴더입니다. Terraform 시작 템플릿을 선택한 경우 이 폴더에는 Terraform 파일이 대신 포함됩니다.
  • azure.yaml - 애플리케이션의 일부가 Azure의 서비스에 매핑되는 방식을 설명하는 파일입니다.
  • .gitignore - git 버전 제어에서 원치 않는 파일을 제외하기 위한 시작 .gitignore 파일입니다.
  • README.md - 템플릿의 최종 사용자에 대한 일반 지침을 제공하는 시작 추가 정보 파일입니다.

이 시작 템플릿에는 사용자 고유의 azd 템플릿을 만드는 데 필요한 대부분의 항목이 포함되어 있습니다. 다음 몇 단원에서는 이러한 기존 파일을 업데이트하고 새 자산을 추가하여 전체 템플릿을 빌드하는 방법을 알아봅니다.